4.5 KiB
Running this distribution
This archive contains six linux/amd64 binaries:
archied— the resident daemon: polls your forge for assigned issues and dispatches them into sandboxedarchie-agentcontainers. It serves no dashboard: the web UI isarchie-ui's process.archie-ui— serves the operator dashboard and the webhook capture receiver, dialing the Gateway and State Store gRPC contracts. Reads only[services.*],[web]and[capture]from the sharedconfig.toml.archie-gateway— serves the chat (ChatContract) surfacearchied,archie-uiandarchie-messagingdial. Runs as its own process;archiednever embeds a gateway.archie-messaging— serves the Telegram, email and webhook channels, dialing the Gateway for the chat contract and the State Store for the stored channel settings.archiedruns no gateway for those channels, so without this process they are simply absent — and nothing logs an error, which is why it has a unit of its own indeployments/systemd-user-service.md.archie-state-store— owns the task data in PostgreSQL behind a gRPC contract.archiedandarchie-gatewayare gRPC clients of it, not owners of the database.archie-playbooks— standalone CLI to lint playbook binding YAML before it reachesarchied.
archie-agent (the per-task sandboxed runtime) is not in this archive —
it only ever runs inside the Docker container archied spawns per task, never
as a host binary. Pull it from GHCR: ghcr.io/samcharles93/archie-agent.
Quickstart
-
Pick a starting configuration. The full set of annotated templates lives in this repository's
deployments/directory on GitHub (https://github.com/samcharles93/archie-core/tree/main/deployments) —single-forge-github.toml,multi-forge-github-gitea.toml,local-ollama-standalone.toml, anddocker-nats-stack.tomlcover the common cases. Copy whichever fits to:mkdir -p ~/.config/archie cp <template>.toml ~/.config/archie/config.toml -
Edit
config.toml(forge token, repos,[services.state]target, model providers) and place any secrets in~/.config/archie/envor referencedsecret://locations. -
Start the five processes, in order (
archie-state-storeandarchie-gatewayfirst —archied,archie-uiandarchie-messagingdial both at startup):./archie-state-store -config ~/.config/archie/config.toml -listen 127.0.0.1:9090 & ./archie-gateway -config ~/.config/archie/config.toml -listen 127.0.0.1:8585 & ./archie-messaging -config ~/.config/archie/config.toml & ./archie-ui -config ~/.config/archie/config.toml & ./archied -config ~/.config/archie/config.tomlDashboard reachability comes from
[web].listen(default127.0.0.1:8484, which needs no dashboard token). For a non-loopback bind pass-listenwith-tokenor-token-fileto mint and persist one.archie-uireadsGATEWAY_TOKEN/STATE_STORE_TOKENfrom its process environment only — it has no secret registry, so when those tokens live in a secret manager, whatever startsarchie-uimust export them into its environment (the[services.*].target_tokenvalues inconfig.tomlare the other supported source). -
For a persistent, 24/7 deployment instead of a foreground run, follow the systemd user-unit runbook: https://github.com/samcharles93/archie-core/blob/main/deployments/systemd-user-service.md.
Verifying an install
archie-playbooks lint -dir <playbooks-dir> validates playbook binding YAML
against the same schema archied loads at startup — run it against your
playbooks directory before pointing archied at it.
Version
This archive's binaries are built from the archied release tag in its
filename; archie-ui, archie-gateway, archie-state-store,
archie-messaging and archie-playbooks ship at that same version rather than
being independently tagged (see RELEASING.md in the source repository for why
only archied and archie-agent are independently versioned).
archie-state-store, archie-gateway, archie-messaging, archie-ui and
archied are services that must be running and addressable; archie-messaging
carries the Telegram, email and webhook channels since the v1.30.0 extraction, so
an install (or an upgrade across v1.30.0) needs its unit as well -- see
deployments/systemd-user-service.md. archie-playbooks is a CLI and runs on
demand.