Documentation
Everything you need to set up and run Scrylo on your local machine.
Installation & Usage
Scrylo is a standalone application (~100MB) that runs on Windows, macOS, and Linux without needing Python or any other dependencies installed.
1. Download
Download the correct package for your operating system.
After downloading, unzip the file to get the main application: scrylo.exe (Windows) or scrylo (macOS/Linux).
2. How to Run
You have two ways to use Scrylo:
Simply double-click the application file (scrylo.exe or scrylo) to start the web server. Your browser will open to the dashboard automatically.
For more control, run commands from your terminal. Open your terminal (Command Prompt, PowerShell, or Terminal), navigate to the directory where you unzipped Scrylo, and run commands:
Windows
.\\scrylo.exe find "SaaS founders in NYC"
macOS & Linux
./scrylo find "SaaS founders in NYC"
Note: On macOS and Linux, you may need to make the file executable first by running: chmod +x ./scrylo
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. |
| --web-source | all | Companies, Linkedin, X, Instagram |
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. |
| --export FILE | Export generated pitches to a .txt file. |
| --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). |
Extracts contact details from business card images using a cloud OCR service. Card images are sent for text extraction only — not stored. 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).