🖥️ Install

One Go core, delivered wherever you work — a scriptable CLI, a visual studio, a native desktop app, a Docker image, a multi-tenant cloud, an autonomous dispatcher, a cron scheduler, and a TypeScript SDK. All eight share the same DSL, compiler, runtime, and logical run contract; only launch transport, persistence, isolation, and process topology vary between local, container, and cloud modes.

Mode	Best for	Install
🖥️ CLI	Scripted runs, CI/CD pipelines, quick iteration	curl -fsSL https://socialgouv.github.io/iterion/install.sh | sh
🌐 Web editor	Visual workflow design on your dev machine	Bundled with the CLI: iterion studio
🪟 Desktop app	Native window with multi-project, OS keychain, auto-update	Download iterion-desktop from Releases
🐳 Docker	Zero-install runs, reproducible CI, isolated environments	docker run --rm ghcr.io/socialgouv/iterion:latest
☁️ Cloud / server	Multi-tenant deployment, shared run store, REST/WS API	helm install iterion oci://ghcr.io/socialgouv/charts/iterion
🎼 Dispatcher	Autonomous loop — poll a tracker, dispatch a workflow per issue	Bundled with the CLI: iterion dispatch iterion.dispatcher.yaml
⏰ Scheduler	Cron or sub-minute keepalive runs without a resident Iterion daemon	Bundled with the CLI: iterion schedule add … && iterion schedule install
📦 TypeScript SDK	Programmatic invocation from Node/Deno/Bun apps	npm install @iterion/sdk

All eight use the same Go core. Pick CLI for automation, the web editor for daily editing, the desktop app for a one-click install with managed credentials, Docker for a self-contained runtime, cloud mode for a shared always-on instance, the dispatcher for an autonomous issue loop, the scheduler for recurring or keepalive runs, or the SDK to embed Iterion in a Node/Deno/Bun application.

---

CLI

curl -fsSL https://socialgouv.github.io/iterion/install.sh | sh

Or install to a custom directory (no sudo needed):

INSTALL_DIR=. curl -fsSL https://socialgouv.github.io/iterion/install.sh | sh

Homebrew (macOS, Linux)

brew tap socialgouv/iterion https://github.com/SocialGouv/iterion
brew install iterion
# Desktop app (macOS only):
brew install --cask iterion-desktop

Updates: brew upgrade iterion (and/or brew upgrade --cask iterion-desktop).

Windows (PowerShell)

Invoke-WebRequest -Uri "https://github.com/socialgouv/iterion/releases/latest/download/iterion-windows-amd64.exe" -OutFile iterion.exe

Manual download

You can also download binaries from the latest release. Builds are available for Linux, macOS (Intel + Apple Silicon), and Windows.

Want a native window instead of a CLI + browser? See Desktop App — it ships an installable .AppImage / .app / .exe with the studio pre-wired, OS-keychain credentials and auto-update.

---

Docker

The published image (ghcr.io/socialgouv/iterion:latest) bundles the iterion binary, git, Node 24 and the pinned claude / codex CLIs. Override the default server command for ad-hoc runs:

# One-off workflow run, mounting your project at /work
docker run --rm \
  -v "$PWD:/work" -w /work \
  -e ANTHROPIC_API_KEY \
  ghcr.io/socialgouv/iterion:latest \
  run workflow.bot --var pr_title="..."

# Editor/server on http://localhost:4891
docker run --rm -p 4891:4891 -v "$PWD:/work" -w /work \
  -e ANTHROPIC_API_KEY \
  ghcr.io/socialgouv/iterion:latest

The image is built by .github/workflows/image.yml on every main push and tag, and scanned by .github/workflows/trivy.yml post-build and weekly (non-blocking, findings land in the repo Security tab).

---

Cloud (Helm)

helm upgrade --install iterion \
  oci://ghcr.io/socialgouv/charts/iterion \
  --version <semver> \
  -f values.yaml

Pick a --version from the iterion releases. The chart bundles server + runner Deployments, KEDA-based runner autoscaling on queue depth, and optional sandbox RBAC for per-run pods.

For the full operator runbook (secrets, NetworkPolicy, observability, resume, migration), see cloud-deployment.md. For a quick architectural overview, see cloud.md.

---

TypeScript SDK

npm install @iterion/sdk

@iterion/sdk wraps the CLI with typed run / resume / events streaming for Node, Deno, and Bun apps. See sdks/typescript/ for usage and API reference.