Skip to content

For contributors

Architecture in short

ganglion is one Go program. In the long term it is meant to be a network of nodes with three roles: a core that holds conversations and memory, edge runners next to devices, and workers where the models run. Today one process carries all three. It talks to Telegram, calls models through a router that picks a model per purpose, keeps state in a SQLite database and plain files, and runs tools under policies.

The agent can write small modules in Rust. The node builds each to WebAssembly in a sandbox, asks the user to approve it, and runs it in a WASM runtime (wazero) on a schedule or when state cells change, with only the capabilities its manifest asks for. The model is not involved in a routine run.

The engineering record

Take part