Metadata-Version: 2.4
Name: coldreach
Version: 0.1.0
Summary: Open-source email finder and lead discovery — the free alternative to Hunter.io and Apollo.io
Project-URL: Homepage, https://github.com/dhruvmojila/coldreach
Project-URL: Repository, https://github.com/dhruvmojila/coldreach
Project-URL: Bug Tracker, https://github.com/dhruvmojila/coldreach/issues
Project-URL: Changelog, https://github.com/dhruvmojila/coldreach/blob/main/CHANGELOG.md
Author: ColdReach Contributors
License: MIT
Keywords: apollo-alternative,cold-email,email-finder,hunter-alternative,lead-generation,osint,sales-tools
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Communications :: Email
Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
Classifier: Topic :: Office/Business
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: aiosqlite>=0.20
Requires-Dist: anyio>=4.6
Requires-Dist: click>=8.1
Requires-Dist: dnspython>=2.6
Requires-Dist: email-validator>=2.2
Requires-Dist: fastapi>=0.115
Requires-Dist: httpx[http2]>=0.27
Requires-Dist: pydantic-settings>=2.6
Requires-Dist: pydantic>=2.9
Requires-Dist: python-whois>=0.9
Requires-Dist: rich>=13.9
Requires-Dist: sqlalchemy[asyncio]>=2.0
Requires-Dist: textual>=0.75
Requires-Dist: uvicorn[standard]>=0.32
Provides-Extra: all
Requires-Dist: asyncpg>=0.30; extra == 'all'
Requires-Dist: crawl4ai>=0.4; extra == 'all'
Requires-Dist: groq>=0.12; extra == 'all'
Requires-Dist: holehe>=1.15; extra == 'all'
Requires-Dist: playwright>=1.48; extra == 'all'
Requires-Dist: redis[hiredis]>=5.2; extra == 'all'
Requires-Dist: streamlit>=1.40; extra == 'all'
Provides-Extra: cache
Requires-Dist: redis[hiredis]>=5.2; extra == 'cache'
Provides-Extra: dashboard
Requires-Dist: streamlit>=1.40; extra == 'dashboard'
Provides-Extra: full
Requires-Dist: crawl4ai>=0.4; extra == 'full'
Requires-Dist: groq>=0.12; extra == 'full'
Requires-Dist: holehe>=1.15; extra == 'full'
Requires-Dist: playwright>=1.48; extra == 'full'
Provides-Extra: postgres
Requires-Dist: asyncpg>=0.30; extra == 'postgres'
Description-Content-Type: text/markdown

# ColdReach

**Open-source email finder and lead discovery — free alternative to Hunter.io and Apollo.io.**

[![CI](https://github.com/dhruvmojila/coldreach/actions/workflows/ci.yml/badge.svg)](https://github.com/dhruvmojila/coldreach/actions)
[![PyPI](https://img.shields.io/pypi/v/coldreach)](https://pypi.org/project/coldreach/)
[![Python](https://img.shields.io/pypi/pyversions/coldreach)](https://pypi.org/project/coldreach/)
[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![Docs](https://img.shields.io/badge/docs-GitHub%20Pages-blue)](https://dhruvmojila.github.io/coldreach/)

---

## Install

**Simple** (once on PyPI — no Docker required for basic use):
```bash
pip install coldreach
```

**Full stack** (clone + Docker for SMTP verification and deep OSINT):
```bash
git clone https://github.com/dhruvmojila/coldreach.git && cd coldreach
./scripts/setup.sh && docker compose up -d && pip install coldreach
```

## Quick start

```bash
coldreach verify john@acme.com                          # verify an email
coldreach find --domain acme.com --quick                # discover emails
coldreach find --domain acme.com --name "Jane Smith"    # target a person
coldreach cache list                                    # manage cache
```

## Why ColdReach?

|                   | Hunter.io   | Apollo.io   | **ColdReach**          |
| ----------------- | ----------- | ----------- | ---------------------- |
| Cost              | $34–$399/mo | $49–$149/mo | **Free forever**       |
| Self-hosted       | No          | No          | **Yes**                |
| API keys required | Yes         | Yes         | **No** (Groq optional) |
| Rate limits       | 25k/mo      | 10k/mo      | **None (local)**       |
| Privacy           | Their servers | Their servers | **Your machine only** |

## Documentation

Full docs at **[dhruvmojila.github.io/coldreach](https://dhruvmojila.github.io/coldreach/)**

- [Getting Started](https://dhruvmojila.github.io/coldreach/getting-started/)
- [CLI Reference](https://dhruvmojila.github.io/coldreach/cli-reference/)
- [How It Works](https://dhruvmojila.github.io/coldreach/how-it-works/)
- [Discovery Sources](https://dhruvmojila.github.io/coldreach/sources/)
- [Configuration](https://dhruvmojila.github.io/coldreach/configuration/)
- [API Reference](https://dhruvmojila.github.io/coldreach/api/)

## License

MIT — see [LICENSE](LICENSE).
