Choose your path

Different roles need different parts of these docs. Pick the path that matches what you are doing.

I want to talk to agents in chat

You are an end user.

  1. What is Agyn — 2 minutes.
  2. Use → Chat — start and manage conversations.
  3. Use → Files — attach files for agents to read.
  4. Use → Run Timeline — see what the agent did.
  5. Use → Reminders — let agents schedule follow-ups.

If your organization isn't set up yet, an admin needs to follow the Administer path first.

I am setting up Agyn for my team

You are an organization admin. Assume Agyn is already installed on a cluster (or you are using Agyn Cloud).

  1. Concepts — skim the glossary.
  2. Administer → Console overview — orient yourself in the Console.
  3. Administer → Organizations — create your organization, invite members.
  4. Administer → LLM providers and Models — let agents call LLMs.
  5. Administer → Secrets — set up credentials your agents need.
  6. Administer → Runners — pick where your agents run (or use a cluster-scoped runner).
  7. Administer → Agents — create your first agent.
  8. Optional: Administer → Apps, Administer → MCP servers, Administer → Terraform.

I am installing Agyn on a Kubernetes cluster

You are a platform operator.

  1. What is Agyn and Architecture at a glance.
  2. Self-host install → Prerequisites.
  3. For dev/demo: Self-host install → Quick bootstrap.
  4. For production: Self-host install → Production install.
  5. Self-host install → First admin — claim the cluster admin role.
  6. Operate → Architecture overview, Networking, Identity, Authorization.
  7. Operate → Backup & DR, Upgrades, Security.

I am building on the platform

You are a developer integrating with Agyn.

  1. Architecture at a glance and Concepts.
  2. Build & extend → Gateway API — the external API surface.
  3. Build & extend → Terraform provider — manage resources as code.
  4. Build & extend → MCP servers — give agents new tools.
  5. Build & extend → Agent CLIs — choose or build the agent loop.
  6. Build & extend → Apps — build services that participate in conversations.

I need to debug something

  1. Troubleshooting — diagnostic playbook by symptom.
  2. Use → Run Timeline — inspect what an agent actually did.
  3. Reference → Service catalog — which service owns what.