# 🎯 HeyLead

**Your AI sales rep. One command to fill your pipeline.**

HeyLead is an MCP-native autonomous LinkedIn SDR that runs in your terminal. No dashboard. No web app. Just chat.

> ⚠️ **Alpha** — Under active development. `setup_profile` is live. Other tools coming soon.

## Quick Start

```bash
# Add to Claude Code (recommended — runs in isolated environment)
claude mcp add heylead -- uvx heylead

# Or add to Cursor (isolated environment)
# Settings → MCP → Add: command "uvx heylead"

# Then ask your AI assistant:
# "Set up my LinkedIn profile"
# "Find me CTOs at fintech startups"
# "How's my outreach?"
```

> **Note:** Use `uvx heylead` (recommended) or `pipx install heylead` for an isolated install.
> Direct `pip install heylead` may conflict with existing FastAPI installations due to starlette version requirements.

## What It Does

HeyLead gives you 5 tools in your AI assistant:

| Tool | What it does |
|------|-------------|
| `setup_profile` | Analyzes YOUR LinkedIn profile and creates a voice signature — so messages sound like you |
| `create_campaign` | Takes "find me fintech CTOs" and creates a targeted outreach campaign |
| `generate_and_send` | Generates personalized invitations and sends them (or queues for your review) |
| `check_replies` | Checks for new replies, classifies sentiment, surfaces hot leads 🔥 |
| `show_status` | Your dashboard — stats, acceptance rates, hot leads, account health |

## How It Works

1. **You describe your target** → "Find me freelance consultants who need scheduling tools"
2. **HeyLead finds them** → Searches LinkedIn, scores prospects, builds a campaign
3. **AI writes personalized messages** → Sounds like YOU (voice matching), not a bot
4. **Copilot mode** → Review first 10 messages, then switch to Autopilot
5. **You get replies** → HeyLead surfaces hot leads: "🔥 Sarah Chen said: Let's chat!"

## Requirements

- Python 3.10+
- Claude Code or Cursor (any MCP-compatible AI assistant)
- LinkedIn account (free tier works)
- Gemini API key (free at [aistudio.google.com](https://aistudio.google.com/apikey))

## Pricing

| Plan | Price | What you get |
|------|-------|-------------|
| **Free** | $0 | 50 invitations/mo, 1 campaign, cookie auth |
| **Pro** | $29/mo | Unlimited, Unipile auth, follow-ups, RAG knowledge base |

## Privacy

All your data stays on YOUR machine:
- Contacts → local SQLite
- Messages → local SQLite
- LinkedIn cookie → encrypted locally (AES-256)
- AI processing → goes directly to your LLM provider
- We receive → nothing

## Links

- 🌐 [heylead.dev](https://heylead.dev)
- 📦 [PyPI](https://pypi.org/project/heylead/)
- 🐛 [Issues](https://github.com/D4umak/heylead/issues)
- 💬 Discord (coming soon)

## License

MIT (code) — see [LICENSE](LICENSE)

Knowledge base and prompt configurations are proprietary.
