​
What is Allternit?

Allternit implements agency as a system. Models do not own the agent. Allternit owns state, work, tools, policy, verification, memory, routing and execution. Models are interchangeable cognitive components used only where cognition is required. You give Allternit a goal. It compiles the goal into typed work, runs it durably, checks every action against policy, verifies the result, and records receipts you can audit and replay.
The only public API is the Cloud API at https://api.allternit.com. Allternit API (:8013) is the private data-plane runtime. See API Overview.

​
Start here

Four pages give the whole mental model, in order:
1

Architecture

The canonical diagram and who owns what.
2

The Two Machines

How work lives, and how the system thinks.
3

Agency API

Send a goal, get one durable, verified run (public preview contract; not served yet).
4

Contracts, not models

Graphs request capabilities, never a named model.

​
Workspace workflows

Start with Platform workflows for bots, durable threads, project launch coordination, connected subscriptions, computers, and artifact modes. The guide distinguishes merged source from installation requirements and MCP Apps installation and documentation status.

​
Core Components

The runtime (Gizzi)

Executes agent work: sessions, tools, sandboxing, and calls to whichever model the system routes to.

Surfaces

Desktop, Web, CLI, and Browser Extension interfaces. They hold no agent logic of their own.

SDK

A unified interface connecting all surfaces to the runtime.
An agent in Allternit is a profile: identity, instructions, capabilities, policies and a default model preference the router may use. The model is not the agent’s brain. The earlier product line, “One Brain, Multiple Faces, One Nervous System”, described one runtime behind many surfaces; the systems architecture is the Agency Kernel.

​
Key Features

Multi-Model Support

Multiple LLM providers and local models through a unified gateway

Git-Based Lineage

Version control for agent evolution and state tracking

Real-time Communication

WebSocket-based event streaming for live agent updates

Polyglot Services

Rust, Python, and TypeScript microservices architecture

Skill System

Extensible capabilities framework for agent abilities

BYOC Deployment

Bring Your Own Cloud - deploy to your own infrastructure

Quickstart

Get up and running in minutes

Architecture

Understand the platform design

API Overview

Cloud API vs Allternit API

​
Installation

Install Gizzi Code, the Allternit CLI, globally:
Then run gizzi from your terminal to start the interactive TUI. Or use the one-line installer for the BYOC runtime: