# KissMySaaS — Full Sovereign Edition

You now own two versions of all 17 systems:

- **`kits/`** — 17 offline HTML apps. Double-click any file. They run in your browser,
  work with no internet, no account, no key, forever. Start here.
- **`crews/`** — the same 17 systems as multi-agent AI crews that run on YOUR machine
  against a model YOU host. No API keys. No cloud. Nothing leaves your computer.

The kits need zero setup. The rest of this file is the one-time setup for the crews.

## One-time setup (about 20 minutes, most of it downloads)

Works on Linux, macOS, or Windows via WSL2 (Ubuntu). You need ~12 GB of disk for the
model and 16 GB+ of RAM (a GPU makes it much faster but is not required).

**1. Install Ollama** (the local model server — this is the "AI that lives in your box"):

    curl -fsSL https://ollama.com/install.sh | sh

**2. Pull the model and alias it** (the crews ask for a model named `gpt-4o-mini`;
you're pointing that name at a local model — no OpenAI involved):

    ollama pull qwen2.5:14b
    ollama cp qwen2.5:14b gpt-4o-mini

**3. Install uv** (Python package manager):

    curl -LsSf https://astral.sh/uv/install.sh | sh

**4. Set up the shared crew environment** (from this folder):

    cd crews
    uv venv .venv --python 3.12
    echo 'litellm<=1.82.6' > overrides.txt
    uv pip install --python .venv/bin/python --override overrides.txt 'crewai[file-processing,litellm,tools]==1.14.4'

## Running a crew

    cd crews
    ./run_crew.sh lead_generation_engine

Before a real run, open `crews/<crew_name>/src/<package>/main.py` and replace the
sample inputs with your actual business/campaign/matter details — that's the whole
interface. Output prints to your terminal.

Notes:
- First run is slow (model loads into memory). On CPU expect minutes per task; on a
  decent GPU expect seconds-to-a-minute. This is the price of owning the machine.
- Some crews reference web-search tools (EXA/Brave). Without keys those tools simply
  fail closed and the agents work from reasoning alone — fully offline. If you WANT
  live web search and accept a cloud call for it, export your own key first
  (e.g. `export EXA_API_KEY=...`). The model itself never leaves your box either way.
- Everything is yours. Edit the agents, the tasks, the prompts. No subscription,
  no phone-home, no updates you didn't choose.

Questions: madbradsmith@gmail.com
