snippbot 0.1.0

Snippbot - Autonomous AI agents for your local machine

Snippbot

Self-hosted autonomous AI agents for your own machine. snippbot is a single, self-contained daemon: a Starlette/Uvicorn API server and a bundled web UI, in one process on port 18781.

The only runtime requirement is Python 3.11+ — the React UI ships bundled inside the package, so there is no Node, pnpm, or repo checkout to manage.

Install

pipx install snippbot     # recommended (isolated)
# or
pip install snippbot

Optional extras (voice, browser automation, vector memory, …):

pipx install "snippbot[voice]"     # or [all] for everything

Optional: Claude CLI agent backend

To run agents on your Claude Pro/Team account via the local Claude CLI, you also need Node.js 18+ and the @anthropic-ai/claude-code package:

npm install -g @anthropic-ai/claude-code   # global install needs sudo on a server
claude login                               # then authenticate

This is optional — you can skip it and run on an Anthropic API key instead. On a server, scripts/install-vps.sh --with-claude-cli installs Node.js + the CLI for you.

First run

snippbot setup        # create your account + awaken your first agent

Then open the web UI at http://localhost:18781/. The first-run setup wizard loads automatically.

Running the daemon

snippbot start        # start the daemon (API + UI on :18781)
snippbot status       # is it running?
snippbot stop         # stop it
snippbot --version

Run on a different address/port (e.g. on a server, reachable over the network):

snippbot start --host 0.0.0.0 --port 18781

A quick health check:

curl http://127.0.0.1:18781/health     # {"status": "ok", "service": "snippbot"}

Configuration & data

State lives under ~/.snippbot/ (config, SQLite database, agent workspaces).

• ~/.snippbot/config.toml — main config
• SNIPPBOT_DATA_DIR — override the data directory
• SNIPPBOT_HOST / SNIPPBOT_PORT — override bind address / port

Resolution order: environment variables → ~/.snippbot/config.toml → built-in defaults.

Upgrading

pipx upgrade snippbot

License

Free for personal, educational, and non-commercial use. Commercial use requires a license — see the Terms of Service.

Links

• Home: https://snippbot.com
• Docs: https://docs.snippbot.com
• Download & install guide: https://snippbot.com/download