ionalpha/flynn repository overview

⁠Flynn

https://flynnhq.com⁠

A secure, self-improving agent operating system in a single Go binary. Bring your own model, point it at a goal, and grant it real authority, because every action is sandboxed, governed, and sealed into a verifiable, tamper-evident record.

Full documentation, source, and issues: https://github.com/ionalpha/flynn⁠

⁠Run

docker run -v flynn-data:/data \
  -e ANTHROPIC_API_KEY=your-key \
  ionalpha/flynn:latest

Mount a volume at /data (SQLite store, credential vault, learned skills) so state survives container replacement. The control-plane API binds loopback inside the container by default; add a channel (for example -e TELEGRAM_BOT_TOKEN=...) to reach the agent. See the repository for remote access and hardening.

⁠Tags

• latest - the most recent release
• X.Y.Z - a specific release, e.g. 0.1.3 (pin this in production)

Images are multi-architecture: linux/amd64 and linux/arm64.

⁠Verify

Every image is signed with keyless cosign:

cosign verify ionalpha/flynn:latest \
  --certificate-identity-regexp 'https://github.com/ionalpha/flynn/.*' \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com

⁠Links

• Source and full docs: https://github.com/ionalpha/flynn⁠
• Install (binaries, deb/rpm/apk): https://github.com/ionalpha/flynn#install⁠
• License: Apache-2.0