Documentation

Everything you need to find people and reach them.

Install OpenLeads, describe who you want, and send your first campaign from your own machine. Then go deep on how the engine finds and verifies every address.

Start here

Ten minutes to your first leads

One install, one sentence. OpenLeads searches the sources that fit and labels every email as found, pattern, or guessed.

Open the quickstart

terminal

pip install "openleads[all]"
openleads find "dentists in Austin"
openleads web

Get started

QuickstartInstall, find leads, and send a first campaign in ten minutes.Web dashboardThe local app: search, CRM, workflows, and analytics in your browser.

Guides

Finding leadsHow one sentence is routed across ten free sources.WorkflowsBuild recipes as a node canvas, then run them on a schedule.DeliverabilityThe seven-signal engine that decides what is safe to send.SendingConnect a mailbox, warm up, and send without burning your domain.Timed runsCron and weekday schedules for searches and campaigns.Automation and assistantDescribe a campaign in one line and let your machine run it.Claude, Cursor, and MCPUse OpenLeads as a tool from any MCP client.Add a sourceAdd a new vertical with a single Python file.

Reference

ArchitectureHow the package fits together.Email engineInside email finding and verification.Responsible useAnti-spam law, ethics, and the guardrails.LicensingAGPL-3.0 and the commercial license.

Ask a questionDiscussions on GitHub Report a bugOpen an issue Star the repoIt helps other people find it