Run the image
Start with the published Docker image or the bundled compose file. The default runtime exposes /portal, /chat, health checks, and the portal API.
Deployable agent platform
Run the platform in Docker. Extend it with tools when you need to.
AgentCircuits ships as a hosted runtime with /portal, /chat, REST APIs,
SignalR, provider adapters, and file or SQL storage. The NuGet packages are there when you need
custom hosting or deeper .NET integration, but they are not the starting point.
- Single host for operators, end users, and agents
- CLI tools, MCP servers, and C# custom tools
- Docker-first deployment with optional NuGet extension points
Docker quick start ghcr.io
docker run -p 8080:8080 \
-v ./data:/data \
-e AGENTCIRCUITS__AUTH__PROVIDERS__0=LocalUserId \
-e AGENTCIRCUITS__AUTH__LOCALUSERID__ENABLED=true \
-e AGENTCIRCUITS__PORTAL__REQUIREAUTHENTICATION=true \
-e AGENTCIRCUITS__PROVIDERS__ANTHROPIC__API_KEY=sk-ant-... \
ghcr.io/agent-circuits/agentcircuits-server:latestWhat ships
The product is the platform runtime. The packages are there when you need to go deeper.
Hosted runtime
Run one deployable host for the portal, chat UI, REST APIs, SignalR, authentication, and file or SQL-backed storage.
Open guideCustom tools
Bring in CLI tool directories, MCP servers, and custom tool implementations without rebuilding the whole platform around them.
Open guideOptional NuGet packages
Use AgentCircuits.Server, AgentCircuits.Core, and related packages when you need a custom host or deeper .NET integration.
Open guideDeployment model
Start with the host. Only drop into code when the default runtime stops being enough.
Configure the platform
Set provider credentials, authentication, and storage through environment variables or configuration files. Move to PostgreSQL when you need shared state.
Extend with tools
Mount CLI tool directories, register MCP servers, or use the NuGet packages to add your own services and tool implementations in a custom host.
Documentation
Read the platform docs in the order most teams actually adopt the product.
Docker quick start
Run the platform locally with the published server image and the minimum auth and provider settings.
Read guidePlatform runtime
Understand the hosted server, portal, chat UI, REST APIs, authentication, and deployment model.
Read guideCustom tools
See how CLI tools, MCP servers, and custom tool implementations fit into the runtime.
Read guideNuGet packages
Use the package surface when you need to embed or extend the platform from your own .NET host.
Read guideEarly access
Get deployment and release updates.
Join the waitlist for Docker releases, provider updates, tool integrations, and implementation notes as the platform continues to harden.
Open waitlist status