Skip to main content

​
Prerequisites

1

Go 1.22 or later

Fracta is a Go binary. You need Go 1.22+ to build it from source.
go version
Install via your platform package manager or from golang.org/dl.
2

A runtime CLI

Fracta orchestrates one or more of these AI CLIs. Install at least one:
  • Claude CLI —
  • Codex CLI —
  • OpenCode —
3

Optional: Docker

Required only for the docker-compose deployment mode.
4

Optional: A Kubernetes cluster

Required only for the kubernetes deployment mode. kind or k3d works locally.

​
Build from source

git clone https://github.com/darkquasar/fracta
cd fracta
go build -o bin/fracta .
./bin/fracta --version
The binary lands at bin/fracta. Add bin/ to your PATH or copy the binary somewhere on PATH: 
cp bin/fracta /usr/local/bin/

​
Verify

fracta --help
You should see the list of subcommands (spawn, list, peek, say, kill, init, etc.).

​
Initialize a project

From the root of your own git repository, scaffold a fracta project: 
fracta init --scaffold local             # single-machine development
fracta init --scaffold docker-compose    # containerized stack
fracta init --scaffold k8s               # Kubernetes deployment
This drops a complete deployment tree (fracta.yaml, deployment/, .fracta/) into your project. See the fracta init reference for all flags, and the per-mode quickstarts below.

​
What’s next

Your First Agent

Spawn, peek, and clean up an agent in five minutes.

Pick a Deployment Mode

Decide whether to run fracta locally, in compose, or on kubernetes.