# Scrylo — Local AI Lead Intelligence

**Find leads. Write pitches. Close deals. All from your laptop.**

Scrylo is a local-first sales automation platform that combines web discovery, ICP (Ideal Customer Profile) scoring, and AI-powered pitch generation into a single, cohesive workflow. Unlike cloud-based platforms that charge per lead or require monthly subscriptions, Scrylo runs entirely on your machine. Your data never leaves your computer.

---

## 🚀 Why Scrylo?

*   **100% Local & Private**: Your leads, campaigns, and pitches stay in your local SQLite database. No cloud, no tracking.
*   **No Subscriptions**: Pay once, own it forever. No $99/mo fees.
*   **Local AI Power**: Uses Groq (Cloud LLM) for speed, Ollama for local LLM power, or built-in smart templates (Jinja2) for fully offline operation.
*   **B2B Hardened**: Built-in MX verification, anti-spam delay randomization, and List-Unsubscribe headers to protect your sender reputation.

---

## ✨ Core Features

### 🔍 Smart Lead Discovery
Scrylo scouts the web to find decision-makers. It queries **Serper.dev** (Google Search API) and **GitHub** profiles to surface real people with verified email patterns.
*   **MX Verification**: Automatically checks if a domain's mail server exists before saving.
*   **Pattern Resolution**: Guesses and validates professional email formats (e.g., `first.last@company.com`).

### 🎯 ICP Scoring Engine
Define your Ideal Customer Profile in plain English. Scrylo scores every lead (0–100) based on keyword match, role relevance, and company fit. Hot leads float to the top so you can focus on the right prospects.

### ✍️ AI Pitch Writer
Generate unique, personalized cold emails for every lead using a four-tier LLM chain:
1.  **Groq Cloud**: Lightning-fast inference using Llama 3.3 70B (Optional).
2.  **Ollama**: Full support for any local model (Mistral, Llama 3, etc.) running on your machine (Optional).
3.  **Smart Templates**: Built-in Jinja2 logic that personalizes emails using lead signals (Offline Fallback).
4.  **Static Templates**: Minimal, zero-dependency safety net.

### 🚀 Bulk SMTP Sender
Deliver your pitches via any standard SMTP server (Gmail, Outlook, Zoho, Brevo, etc.).
*   **Anti-Spam Hardening**: Randomized delays between sends, personalized greetings, and physical address footers (CAN-SPAM compliant).
*   **Dry Run Mode**: Preview exactly what will be sent before connecting to the mail server.

### 📇 Business Card OCR
Just back from a conference? Drop a folder of business card photos, and Scrylo's built-in **EasyOCR** engine will extract names, roles, and emails automatically.

---

## 🛠️ CLI Reference

Scrylo provides a powerful CLI for automation and a Web UI for interactive management.

*   `scrylo serve`: Launch the Web UI at `localhost:8080`.
*   `scrylo find "QUERY"`: Discover leads from web/GitHub.
*   `scrylo icp --all`: Score leads against your profile.
*   `scrylo pitch --all`: Generate personalized emails.
*   `scrylo send --campaign "NAME"`: Bulk deliver pitches via SMTP.
*   `scrylo ocr --folder PATH`: Import leads from business card images.
*   `scrylo status`: Check system health and API connectivity.
*   `scrylo demo`: Run a high-fidelity simulation (no keys needed).

---

## 📦 Installation

### Requirements
*   Python 3.10+
*   4GB RAM (8GB+ recommended for local LLMs)
*   Windows, macOS, or Linux

### Quick Start
1.  **Install via pip**:
    ```bash
    pip install scrylo
    ```
2.  **Launch the Web UI**:
    ```bash
    scrylo serve
    ```
3.  **Configure**: Add your Serper API key (for web search) and SMTP credentials in the **Settings** tab.

---

## ⚖️ License & Legal

Commercial License — One-time payment. See [scrylo.site](https://scrylo.site) for details.
Scrylo is a tool for professional B2B outreach. Users are responsible for complying with local regulations (CAN-SPAM, GDPR, etc.).

© 2026 Scrylo — Local AI Lead Intelligence
