Self-host OpenOutreach
v0.1.0AI agent that finds qualified B2B leads and emails them
docker run --pull always -it -v ~/.openoutreach/data:/app/data ghcr.io/eracle/openoutreach:latest 10 emails > leads.csv- Stars
- 3 434
ghcr.io/eracle/openoutreachWhat is OpenOutreach?
OpenOutreach is an open-source AI prospecting agent installed as a Python CLI. Given a plain-language account of your offering and your ideal buyer, it queries a commercial B2B data provider through BetterContact, has an LLM weigh every returned profile against that brief, and reports each verdict as a readable justification rather than an opaque score. It can then draft and deliver the opening message through your own SMTP mailbox, inside sender-side pacing and daily-cap guards. Profile searches cost nothing, while verified business addresses are bought at one credit each and only for high-confidence fits; stored leads print out as CSV laid out for popular sequencer importers. Setup is one wizard (uv tool install openoutreach, then start it bare), after which find, send, run and status do the work and state persists under ~/.openoutreach so later runs continue rather than restart. Architecturally the package wraps OpenOutFind (search, scoring, address lookups, a small CRM) and OpenOutSend (the writing agent and its mail transport) around a single SQLite database, and a ghcr.io image supports timer- or cron-driven runs that exit once their goal is met. A Claude Code plugin and an agent skill ship in the repo. Constraints: there is no web interface, no user login and no published port, working use needs paid third-party API keys you bring yourself, and the project is still pre-1.0 (0.1.x, GPLv3).
Should you self-host OpenOutreach?
OpenOutreach scores 53/100 on selfhost.directory (how scoring works) and ranks #8 of 12 in Marketing Automation. It has 3 434 GitHub stars.
There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.
Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is GPL-3.0-licensed and written mostly in Python.
Its closest alternative on selfhost.directory is voyager (58/100, 1 822 stars). It scores higher overall, so compare the two before you pick. See OpenOutreach vs voyager side by side.
Features
- AI lead discovery
- Browserless, no scraping
- Claude Code plugin and agent skill
- Cold email sending from own mailbox
- Credit-gated email enrichment
- CSV export of leads
- Headless configuration via environment
- LLM qualification with reason per lead
- One-command CLI setup
- Persistent local lead store
- Send guards (daily cap, window, pacing)
OpenOutreach README
FAQ
Do you contact the people on my list?
No — the delivered list stops at the file, and the only message sent is the reply to you.
What happens to my product description?
It is used only to run the search and write the reasons, and is not resold, published or used for training.
How do I order more leads?
The email carrying your free sample contains a Stripe link to choose a quantity, or you can order straight away at $2 per lead.
Why are the first ten leads free?
Reading the fit reasons for your own niche is how you judge whether they are worth paying for; one free batch per person, and a second niche is treated as a new order.
More in Marketing Automation
OpenPostSelf-hosted, open-source toolkit replacing Buffer, Canva, CapCut — write posts, design graphics, edit video, schedule to 15+ networks from one workspace.
openseoOpen source alternative to Semrush and Ahrefs
phpListSelf-hosted, open-source newsletter and email marketing manager for building campaigns, with segmentation, personalisation and bounce processing.
plunkSelf-hosted, open-source email platform for transactional sends, campaigns and workflows, with an SMTP relay, inbound email and dynamic segments on one contact list.
Postiz📨 The ultimate agentic social media scheduling tool 🤖
PrismSelf-hosted open-source platform for automating short-video publishing across 7 platforms with multi-account management, scheduling, and AI agent.
Refferq🌟 Open Source Referral and Affiliate Marketing Platform for SaaS Business Owners - Launch your referral program in minutes!
refrefSelf-hosted open-source software for managing referral, affiliate, and loyalty programs with billing provider connections.
Revive AdserverRevive Adserver is a self-hosted, open-source ad serving system for publishers to manage campaigns and target ads. The most popular free ad server under GPL-2.0.
SendPortalOpen-source, self-hosted email marketing app for newsletters: subscriber lists, tags, campaigns, tracking and a REST API, sending via SES, Mailgun, Postmark and more.
senloSelf-hosted open-source email infrastructure with visual MJML editor, REST API, automation, and multi-provider delivery (Resend, Postmark, SMTP).
SerpBearSelf-hosted, open-source Google rank tracker: unlimited keywords, email alerts, CSV export, a built-in API, plus SERP scraper and Search Console integrations.

0 comments