​
Prerequisites

Before you begin, ensure you have the following:

​
Install Gizzi Code

Gizzi Code is the unified Allternit CLI. macOS / Linux:
Windows (PowerShell):
Homebrew: brew tap Gizziio/tap && brew install gizzi-code npm (all platforms):
See CLI Installation for Scoop and winget. The Allternit desktop / BYOC installer is a separate channel: curl -fsSL https://install.allternit.com/install | bash.

​
Talk to the public API

Production clients use the Cloud API only:
Allternit API on :8013 is the private data plane (desktop / your VPS / a provisioned instance). See API Overview.

​
Authenticate

Set your API key so Gizzi Code can talk to the Allternit platform:
For persistent configuration, run:

​
Start the interactive TUI

Launch the terminal user interface and start an agent session:
From the TUI you can:
  • Chat with agents
  • Run tools and browse the web
  • Edit files and review diffs
  • Switch profiles and models

​
Run a headless command

You can also run a single prompt and exit:

​
Start the web platform (optional)

If you installed the full BYOC runtime, start the local platform:
Then open http://localhost:3001.

​
Next steps

CLI overview

Learn everything Gizzi Code can do

Configuration

Profiles, models, and runtime options

Architecture

Understand how Allternit works