Documentation
Everything you need to set up and run Scrylo on your local machine.
Installation
Scrylo requires Python 3.10+ and works on Windows, macOS, and Linux.
pip install scrylo
Binary Installers
Don't have Python? Download the pre-built standalone binary for your OS.
Quick Start
- Launch the UI:
scrylo serve - Go to Settings and add your Serper API key.
- Describe your ICP (who you want) and Service (what you offer).
- Run a search:
scrylo find "SaaS founders" - Generate pitches:
scrylo pitch --all
CLI Reference
Runs a high-fidelity simulation of the lead-to-pitch pipeline using fake data. No license key or API keys required. Perfect for testing the CLI before activation.
Launches the Scrylo web interface at localhost:8080. Use the web UI to manage leads, settings, and campaigns interactively.
| Option | Default | Description |
|---|---|---|
| --host | 127.0.0.1 | Host to bind to. |
| --port | 8080 | Port number. |
| --no-browser | false | Don't auto-open browser tab. |
Searches for leads matching QUERY and saves them to SQLite. Supports web search (via Serper) and GitHub profile scouting.
| Option | Default | Description |
|---|---|---|
| --limit | 20 | Max leads to find. |
| --source | web | web or github. |
| --no-fetch | false | Skip page fetching for faster results. |
scrylo find "AI founders NYC" --source github --limit 50
Scores leads 0-100 based on the Ideal Customer Profile description defined in Settings. Hot leads float to the top.
| Option | Description |
|---|---|
| --all | Score every lead in the database. |
| --lead-id ID | Score a single lead by ID. |
Uses Groq → Ollama → Jinja2 to write targeted pitches based on lead signals and your service description.
| Option | Description |
|---|---|
| --all | Generate for all leads. |
| --preview | Preview first pitch before running batch. |
| --provider | Force groq, ollama, or jinja2. |
| --lead-id ID | Generate pitch for a specific lead by ID. |
| --no-llm | Use Jinja2 templates only (offline fallback). |
Delivers your pitches via your own SMTP server. Randomised delays and anti-spam hardening are built-in to protect your reputation.
| Option | Default | Description |
|---|---|---|
| --campaign | required | Name for tracking. |
| --dry-run | false | Preview sends without actual SMTP connection. |
| --limit | 50 | Max emails to send. |
| --delay-min | 90 | Min delay between sends (sec). |
| --delay-max | 180 | Max delay between sends (sec). |
Uses EasyOCR to pull contact details from business card images. Deduplicates automatically against existing records.
| Option | Description |
|---|---|
| --folder | Folder path containing card images (PNG/JPG). |
| --recursive | Search sub-folders too. |
| --dry-run | Parse but don't save to DB. |
Displays a diagnostic report of your local environment: configuration paths, database health, API key status, and available local AI models (Ollama).