​
Overview

Gizzi is Allternit’s agent runtime. It ships as gizzi-code (source: cmd/gizzi-code), a TypeScript program that runs either as an interactive terminal app or as a local HTTP server with gizzi-code serve. The server holds sessions, runs tools, calls models through its provider layer, and manages MCP servers, skills, memory, sandboxes and PTYs. Status: Implementation IMPLEMENTED × Exposure PUBLIC (shipped in the gizzi CLI and bundled with Allternit Desktop as a sidecar).

​
How the platform uses it

The platform API (allternit-api) does not call model providers directly. It calls the Gizzi runtime over HTTP. The runtime URL comes from the API’s terminal-server setting and defaults to http://127.0.0.1:4096. For example:
  • POST /api/agents/:id/runs sends the agent’s input through a Gizzi session using the agent’s system prompt, model and provider. See Agents API.
  • The Page Agents API proxies page-agent runs to the same local runtime (ALLTERNIT_PAGE_AGENT_URL, default http://127.0.0.1:4096).
  • The Providers API relays provider sign-in, connect flows and quota windows from the runtime, which stores provider credentials.

​
Runtime HTTP surface

gizzi-code serve mounts route groups including: The route list lives in cmd/gizzi-code/src/runtime/server/server.ts. The runtime publishes an OpenAPI description of these routes; treat that, not this table, as the full reference.

​
Models and providers

Gizzi resolves the model and provider it is given (for example ollama / qwen2.5:0.5b for the local Companion fallback). Local models run through Ollama; see Local Brains. Subscription and API-key providers are connected through the runtime; see Providers.

​
How this relates to the Agency Kernel

Gizzi is the runtime that executes sessions today. The Agency Kernel is the separate, capability-based execution layer behind the Agency API; where a kernel step needs a model or a harness, it may call into this runtime. See Architecture.