agent-smith

You hear that, Mr. Anderson? That is the sound of inevitability!

[!WARNING] 🚧 Under active development. 🚧

Interfaces, schemas, and endpoints change without notice, and there is no migration path between versions. Not ready for production use.

Agent Smith

A lightweight all-in-one backend for stateful, deterministic apps whose main interface is an LLM chat. It handles chat persistence, authentication, and guest sessions — and provides a mutable data store that the user reads and writes through the LLM.

What is in the box today:

• Chat persistence
• Auth and guest sessions, with a guest → email upgrade path
• Streaming chat endpoint for the Vercel AI SDK
• Integrated tool calling to access the mutable data store

Supports:

• Gemini or Ollama LLMs
• App-defined data schema

Built on PocketBase: one Go binary, SQLite, admin dashboard included.

Getting started

Requires Go 1.24.1 or newer, and either a Gemini API key or a local Ollama.

./smith.sh setup   # specify API keys, or a local model
./smith.sh run     # build and serve one of the example projects
./smith.sh clear   # clear an example's local data

License

AGPL-3.0. See LICENSE.