← Documentation index · ← Iterion
Iterion ships in seven delivery flavours. Pick the one that fits your workflow — the DSL, runtime, persistence and observability are identical across all of them.
| 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 |
| 📦 TypeScript SDK | Programmatic invocation from Node/Deno/Bun apps | npm install @iterion/sdk |
All seven invoke the same Go core. Pick CLI for automation, the web editor for daily editing, the desktop app if you want a one-click install with managed credentials, Docker when you want to run iterion without installing it on the host, cloud mode when teams need a shared always-on instance, the dispatcher when you want an autonomous issue-dispatch loop, or the SDK to embed iterion inside another Node/Deno/Bun application.
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
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).
Invoke-WebRequest -Uri "https://github.com/socialgouv/iterion/releases/latest/download/iterion-windows-amd64.exe" -OutFile iterion.exe
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/.exewith the studio pre-wired, OS-keychain credentials and auto-update.
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).
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.
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.