Advanced multi-agent AI system for discovering and scoring qualified leads
Leadly uses AI agents with web search, content analysis, and intelligent scoring to identify high-quality business opportunities. Features true async agent reasoning delivering 40-50% faster results while maintaining cost efficiency.
- 🚀 True Async Reasoning: Agent plans while tools execute—40-50% faster
- 🤖 Multi-Agent Architecture: Supervisor, researcher, and strategist agents
- 🔍 Web Intelligence: Real-time search and scraping with deduplication
- 📊 Intelligent Scoring: Multi-dimensional lead evaluation
- 💰 Cost Tracking: Real-time token and API usage monitoring
- 🌐 Streaming API: Server-Sent Events for real-time updates
- ⏳ Optimized Performance: Fire-and-continue async execution pattern
| Component | Technology |
|---|---|
| Backend | Node.js 20+ / TypeScript / Express / LangGraph |
| Frontend | React 19 / Vite / TypeScript / TailwindCSS |
| LLM | Claude (AWS Bedrock) |
| Search | Tavily API |
| Scraping | Cheerio HTML parser |
| Deployment | Render (automated) |
- Node.js 20.14.9+
- AWS Bedrock credentials
- Tavily API key
# Backend dependencies
npm install
# Frontend dependencies
cd frontend && npm install && cd ..
# Set up .env (see CLAUDE.md for details)
cp .env.example .env
# Terminal 1: Backend API
npm run server
# Terminal 2: Frontend UI
cd frontend && npm run devAccess: http://localhost:5173 (frontend) / http://localhost:10000 (API)
| Document | Purpose |
|---|---|
| CLAUDE.md | Comprehensive development guide, architecture, patterns |
| docs/DEPLOYMENT.md | Production deployment (Render, GitHub Pages) |
| docs/ARCHITECTURE.md | Detailed system architecture & design patterns |
| docs/SCRAPING_GUIDE.md | Enhanced web scraping tool reference |
npm run build # Compile TypeScript
npm run server # Start API server (dev)
npm run build:all # Production build (backend + frontend)
cd frontend && npm run dev # Frontend dev server
ts-node tests/test_graph.ts # Run integration tests
DEBUG=1 npm run server # Verbose loggingLast Updated: February 2026 | Status: Production Ready | License: MIT