Define agents as code

Stop clicking. Version your agent infrastructure.

resource "agyn_agent" "support" {
  organization_id = agyn_organization.acme.id

  name       = "Support"
  nickname   = "support"
  model      = agyn_llm_model.gpt_4o.name
  image      = "ghcr.io/agynio/agent-runtime:v1.0.0"
  init_image = "ghcr.io/agynio/agent-init-codex:v1.0.0"

  idle_timeout = "5m"
  availability = "internal"
}

resource "agyn_agent_mcp" "zendesk" {
  agent_id = agyn_agent.support.id
  name     = "zendesk"
  image    = "ghcr.io/acme/zendesk-mcp:latest"

  envs = [
    {
      name      = "ZENDESK_TOKEN"
      secret_id = agyn_secret.zendesk_token.id
    },
  ]
}

terraform init && terraform apply

See the Terraform provider reference for every resource.

How it works

Each agent is a first-class citizen:

• Isolated sandbox — own container, filesystem, env vars, secrets
• MCPs in separate containers — full process isolation per tool
• Observability built in — token usage, compute, activity logs
• Auto-scaling — agents spin up on demand, terminate on idle

Full architecture: docs/operate/architecture.md.

Video walkthroughs

| Video | What it shows | |---|---| | | Agyn in 5 minutes — From clean cluster to a working agent answering a chat message. End-to-end tour. | | Coming soon | Deploying agents with Terraform — Define an agent fleet as code, apply it, talk to them. | | Coming soon | Inspecting a run with Tracing — Every LLM call, every tool execution, every context decision. |

Documentation

Full docs live in docs/:

• Introduction — what Agyn is, concepts, architecture at a glance.
• Self-host install — bootstrap, production install, upgrades.
• Administer — Console + Terraform for orgs, agents, models, secrets, runners, apps.
• Use — chat, files, tracing, usage, port exposure.
• Build & extend — Gateway API, MCP servers, agent CLIs, apps.
• Operate — networking, identity, scaling, backups, security.
• Reference — glossary, service catalog, schema pointers.
• Troubleshooting — diagnostic playbook by symptom + FAQ.

Repository map

Agyn is split across focused repositories. The most useful starting points:

| Repo | What it is | |---|---| | agynio/platform | This repo. Documentation hub. | | agynio/architecture | Source-of-truth architecture and product specs. | | agynio/bootstrap | One-command local install (k3d + Terraform). | | agynio/platform-charts | Production Helm charts. | | agynio/api | Protobuf schemas for every service. | | agynio/terraform-provider-agyn | Terraform provider. | | agynio/agyn-cli | Platform CLI. | | agynio/console-app · chat-app · tracing-app | Browser UIs. | | agynio/agent-init-codex · agent-init-claude · agent-init-agn | Agent CLI init images. |

Full list with descriptions: docs/reference/service-catalog.md.

Community

• Website
• Blog
• Discord

Contributing

Good places to start:

• Read the architecture docs to understand the system before touching code.
• Join the Discord for questions while you work.

License

AGPL-3.0