Documentation

Installation

Clone the repo and run one command. It sets up dependencies, models and the interface for you.

1. Clone

git clone https://github.com/emreyvz/overseer.git
cd overseer

2. One command

The launcher installs the Python toolchain (uv), syncs dependencies, fetches the AI models, builds the interface, and starts the app:

# macOS / Linux
./overseer.sh

# Windows
overseer.cmd

If Node.js is installed you get the desktop app; otherwise Overseer opens in your browser at http://127.0.0.1:8787. The first run downloads model weights into models/; after that it can run fully offline.

Manual setup (optional)

Prefer to do it yourself:

uv sync                    # Python dependencies
cd web && npm install      # frontend dependencies

Then run the backend with python main.py (or uv run python -m server) and the desktop shell with cd web && npm run desktop.

GPU

For CUDA acceleration, install a PyTorch build matching your CUDA version. Overseer falls back to CPU automatically if no GPU is found.

Continue to Quick Start.