README

The all-in-one open-source enterprise AI platform.
Built on a strong security and observability foundation: SSO and RBAC,
sandboxed code execution, Dual-LLM and Lethal-Trifecta guardrails,
OpenTelemetry traces, and Prometheus metrics — first-class, not bolted on.

Quickstart ·
Docs ·
Releases ·
Slack
What it does
Point your users — or your agents, or Claude / Codex / Cursor — at one URL. Archestra handles the rest:
- 💬 Chat for non-technical users. Internal AI assistant with
projects,
MCP apps, and
Slack,
MS Teams, and
email
front-ends.
- 🛠️ Developer LLM & MCP portal. One token for Claude Code, Codex,
Cursor — see the proxy.
- 🚪 LLM gateway for any provider
(Anthropic, OpenAI, Azure, Bedrock, DeepSeek, …) with
cost limits,
virtual API keys,
and dynamic model routing.
- 🔌 MCP gateway with OAuth + On-Behalf-Of
so tools run as the user, not a shared service account.
- 🤝 A2A gateway for agent-to-agent triggers.
- 📦 Private MCP registry so teams ship their own tools — see
registry docs.
- 🎼 MCP orchestrator with a
Kubernetes operator and
self-serve promotion.
- 🤖 Agent runtime with scheduled / email / webhook triggers,
sub-agent delegation,
reusable skills,
sandboxed code execution, and a K8s-native filesystem.
- 📚 RAG knowledge base plumbed via
connectors to
your existing stack.
- 🧩 Mini app builder — see apps.
- 🛡️ Deterministic guardrails for tool calls,
Dual-LLM verification, and
Lethal Trifecta protections.
- 🪪 Identity & access with SSO
(OIDC, SAML, Okta, Entra), RBAC with role mapping & team sync,
and secrets management.
- 🌎 Environments with per-env egress policies
and per-env cost limits.
- 🔭 Observability out of the box: OpenTelemetry traces, Prometheus
metrics, logs, per-team cost tracking.
Already running dangerous single-tenant agents like Claude Cowork,
OpenClaw, or Hermes in your enterprise? Migration Kit →
Quickstart
docker pull archestra/platform:latest
docker run \
-p 127.0.0.1:9000:9000 -p 127.0.0.1:3000:3000 \
-e ARCHESTRA_QUICKSTART=true \
-e ARCHESTRA_BETA=true \
-v /var/run/docker.sock:/var/run/docker.sock \
-v archestra-postgres-data:/var/lib/postgresql/data \
-v archestra-app-data:/app/data \
archestra/platform
Open http://localhost:3000. Full Docker / Helm / Kubernetes instructions
live in the quickstart docs.
Ready for production
Deeper docs
Thank you for continuously making Archestra better — you're awesome 🫶
Star history
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=archestra-ai/archestra&type=Date" />

Extension points exported contracts — how you extend this code
LLMRequestAdapter (Interface)
(no doc) [16 implementers]
platform/backend/src/types/llm-provider.ts
InteractionUtils (Interface)
(no doc) [16 implementers]
platform/shared/interactions/llmProviders/common.ts
SpeechRecognition (Interface)
(no doc) [3 implementers]
platform/frontend/src/components/ai-elements/prompt-input.tsx
TestFixtures (Interface)
* Playwright test extension with fixtures * https://playwright.dev/docs/test-fixtures#creating-a-fixture
platform/e2e-tests/fixtures.ts
CrawledSkill (Interface)
(no doc)
platform/standalone-scripts/generate-skill-index.ts
ArtifactBytes (Interface)
(no doc)
platform/archestra-rs/sandbox-rs/index.d.ts
LLMStreamAdapter (Interface)
(no doc) [21 implementers]
platform/backend/src/types/llm-provider.ts
BedrockContentBlock (Interface)
* Bedrock Converse API request/response types * Based on backend/src/types/llm-providers/bedrock/api.ts
platform/shared/interactions/llmProviders/bedrock.ts
Core symbols most depended-on inside this repo
makeOrganization
called by 2413
platform/backend/src/test/fixtures.ts
create
called by 2205
platform/backend/src/models/app.ts
makeUser
called by 2148
platform/backend/src/test/fixtures.ts
push
called by 1906
platform/backend/src/logging/log-ring-buffer.ts
makeAgent
called by 1455
platform/backend/src/test/fixtures.ts
get
called by 1024
platform/backend/src/cache-manager.ts
makeMember
called by 1011
platform/backend/src/test/fixtures.ts
info
called by 856
platform/backend/src/knowledge-base/connectors/perforce/p4-rest-client.ts
Shape
Function
9,058
Method
3,370
Class
845
Interface
843
Enum
8
Struct
4
TypeAlias
1
Languages
TypeScript95%
Python4%
Go1%
Modules by API surface
platform/shared/hey-api/clients/api/sdk.gen.ts471 symbols
platform/backend/src/routes/proxy/adapters/openai.ts100 symbols
platform/backend/src/clients/mcp-client.ts100 symbols
platform/backend/src/k8s/mcp-server-runtime/k8s-deployment.ts90 symbols
platform/backend/src/routes/proxy/adapters/bedrock.ts80 symbols
platform/backend/src/models/tool.ts69 symbols
platform/backend/src/models/agent.ts67 symbols
platform/backend/src/routes/proxy/adapters/azure-responses.ts65 symbols
platform/backend/src/agents/chatops/slack-provider.ts65 symbols
platform/backend/src/routes/proxy/adapters/openai-responses.ts64 symbols
platform/backend/src/routes/proxy/adapters/minimax.ts63 symbols
platform/backend/src/routes/proxy/adapters/zhipuai.ts61 symbols
Dependencies from manifests, versioned
github.com/containerd/logv0.1.0 · 1×
github.com/moby/go-archivev0.2.0 · 1×
github.com/moby/patternmatcherv0.6.0 · 1×
github.com/moby/profiles/seccompv0.2.3 · 1×
github.com/moby/sys/mountv0.3.4 · 1×
github.com/moby/sys/mountinfov0.7.2 · 1×
github.com/moby/sys/reexecv0.1.0 · 1×
github.com/moby/sys/sequentialv0.6.0 · 1×
github.com/moby/sys/userv0.4.0 · 1×
github.com/moby/sys/usernsv0.1.0 · 1×
Datastores touched
archestra_devDatabase · 1 repos
dbDatabase · 1 repos
externaldbDatabase · 1 repos
archestraDatabase · 1 repos
(mongodb)Database · 1 repos
mydbDatabase · 1 repos
archestra_dbDatabase · 1 repos
benchDatabase · 1 repos