# Marg

> The Agent Development Kit for conversational agents that finish a job: runtime-owned steps, typed decisions, evals as the ratchet, a production spine. TypeScript, MCP, any model. Apache-2.0.

The docs are mirrored from the repository (https://github.com/marg-adk/marg); every page is also a markdown file there. Start with the quickstart, then the pattern; the method for building a domain is a skill a coding agent follows (Build with a coding agent).

## Home

- [Marg — agents that finish the job](https://marg-adk.github.io/marg/)

## Get started

- [Quickstart](https://marg-adk.github.io/marg/get-started/)
- [Marg and other frameworks](https://marg-adk.github.io/marg/get-started/compare)
- [The playground](https://marg-adk.github.io/marg/get-started/playground)

## Build

- [The Marg pattern](https://marg-adk.github.io/marg/build/pattern)
- [The playbook — how to build a domain, and how to keep it working](https://marg-adk.github.io/marg/build/playbook)
- [Domain worksheet — answer these before writing code](https://marg-adk.github.io/marg/build/worksheet)
- [Guide: a new domain](https://marg-adk.github.io/marg/build/new-domain)
- [Guide: a new runtime-owned step](https://marg-adk.github.io/marg/build/new-step)
- [Guide: readers — reading a reply in code](https://marg-adk.github.io/marg/build/readers)
- [Guide: evals](https://marg-adk.github.io/marg/build/evals)
- [Guide: tools in Python](https://marg-adk.github.io/marg/build/python-tools)
- [Example domain — support ticket intake](https://marg-adk.github.io/marg/build/example)
- [Build a Marg domain](https://marg-adk.github.io/marg/build/coding-agent)
- [Example domain — table bookings](https://marg-adk.github.io/marg/build/example-bookings)

## Components

- [Architecture](https://marg-adk.github.io/marg/components/architecture)
- [The client protocol](https://marg-adk.github.io/marg/components/client-protocol)
- [Typed decisions — Verdict, and Laya as the embedded open-source decision model](https://marg-adk.github.io/marg/components/decisions)
- [Metering and cost](https://marg-adk.github.io/marg/components/metering)
- [Security design](https://marg-adk.github.io/marg/components/security)
- [Embedding in your app: the agent-token exchange, seats and caps](https://marg-adk.github.io/marg/components/sdk-auth)

## Run

- [Environment variables](https://marg-adk.github.io/marg/run/environment)
- [Observability](https://marg-adk.github.io/marg/run/observability)
- [Production-readiness checklist](https://marg-adk.github.io/marg/run/production-checklist)
- [Deploying a Marg gateway](https://marg-adk.github.io/marg/run/deploy)

## Models

- [Models](https://marg-adk.github.io/marg/providers/)
- [Anthropic (Claude)](https://marg-adk.github.io/marg/providers/anthropic)
- [Azure OpenAI](https://marg-adk.github.io/marg/providers/azure)
- [Amazon Bedrock](https://marg-adk.github.io/marg/providers/bedrock)
- [Cerebras](https://marg-adk.github.io/marg/providers/cerebras)
- [Cohere](https://marg-adk.github.io/marg/providers/cohere)
- [DeepSeek](https://marg-adk.github.io/marg/providers/deepseek)
- [Fireworks AI](https://marg-adk.github.io/marg/providers/fireworks)
- [AI gateways: Apigee, Portkey, Kong, Cloudflare](https://marg-adk.github.io/marg/providers/gateways)
- [Google Gemini (AI Studio)](https://marg-adk.github.io/marg/providers/gemini)
- [Google Gemma (open weights)](https://marg-adk.github.io/marg/providers/gemma)
- [Groq](https://marg-adk.github.io/marg/providers/groq)
- [Hugging Face Inference Providers](https://marg-adk.github.io/marg/providers/huggingface)
- [LiteLLM (proxy to 100+ providers)](https://marg-adk.github.io/marg/providers/litellm)
- [LiteRT-LM and other on-device runtimes](https://marg-adk.github.io/marg/providers/litert)
- [llama.cpp and LM Studio (local)](https://marg-adk.github.io/marg/providers/llamacpp)
- [Mistral](https://marg-adk.github.io/marg/providers/mistral)
- [NVIDIA NIM](https://marg-adk.github.io/marg/providers/nvidia)
- [Ollama (local)](https://marg-adk.github.io/marg/providers/ollama)
- [OpenAI](https://marg-adk.github.io/marg/providers/openai)
- [OpenRouter](https://marg-adk.github.io/marg/providers/openrouter)
- [Perplexity (Sonar)](https://marg-adk.github.io/marg/providers/perplexity)
- [Together AI](https://marg-adk.github.io/marg/providers/together)
- [Google Cloud Vertex AI (Agent Platform)](https://marg-adk.github.io/marg/providers/vertex)
- [vLLM (self-hosted)](https://marg-adk.github.io/marg/providers/vllm)
- [xAI (Grok)](https://marg-adk.github.io/marg/providers/xai)

## Integrations

- [Integrations](https://marg-adk.github.io/marg/integrations/)
- [Claude Code, Codex and other coding agents](https://marg-adk.github.io/marg/integrations/coding-agents)
- [Datadog](https://marg-adk.github.io/marg/integrations/datadog)
- [Deepgram (voice notes)](https://marg-adk.github.io/marg/integrations/deepgram)
- [Grafana Cloud (Tempo, Mimir, Loki)](https://marg-adk.github.io/marg/integrations/grafana)
- [Honeycomb](https://marg-adk.github.io/marg/integrations/honeycomb)
- [Jaeger (traces only)](https://marg-adk.github.io/marg/integrations/jaeger)
- [Langfuse](https://marg-adk.github.io/marg/integrations/langfuse)
- [Laya and System One servers](https://marg-adk.github.io/marg/integrations/laya)
- [MCP tool servers (any language)](https://marg-adk.github.io/marg/integrations/mcp)
- [MongoDB (sessions, ledgers)](https://marg-adk.github.io/marg/integrations/mongodb)
- [New Relic](https://marg-adk.github.io/marg/integrations/newrelic)
- [OpenObserve (default)](https://marg-adk.github.io/marg/integrations/openobserve)
- [From another agent framework](https://marg-adk.github.io/marg/integrations/other-frameworks)
- [Any OTLP backend](https://marg-adk.github.io/marg/integrations/otlp)
- [Arize Phoenix](https://marg-adk.github.io/marg/integrations/phoenix)
- [Redis (rate limits, caps)](https://marg-adk.github.io/marg/integrations/redis)
- [Render, Fly, Railway, Docker](https://marg-adk.github.io/marg/integrations/render)
- [SigNoz](https://marg-adk.github.io/marg/integrations/signoz)
- [Whisper-compatible (OpenAI, Groq, self-hosted)](https://marg-adk.github.io/marg/integrations/whisper)

## Reference

- [Field notes — what we learned building a production agent](https://marg-adk.github.io/marg/reference/lessons)
- [Roadmap](https://marg-adk.github.io/marg/reference/roadmap)
- [Changelog](https://marg-adk.github.io/marg/reference/changelog)
- [Releasing](https://marg-adk.github.io/marg/reference/releasing)
- [ADR 0001 — Domains and routing: compose within, delegate across](https://marg-adk.github.io/marg/reference/adr/0001-domains-and-routing)
- [ADR 0002 — Durable stores with graceful fallback](https://marg-adk.github.io/marg/reference/adr/0002-durable-stores)
- [ADR 0003 — OpenTelemetry everywhere; a feature is done when it is visible](https://marg-adk.github.io/marg/reference/adr/0003-observability)
- [ADR 0004 — The runtime owns the moments that must be right](https://marg-adk.github.io/marg/reference/adr/0004-runtime-owned-steps)
- [ADR 0005 — Typed decisions through a cascade; Laya as the embedded decision model](https://marg-adk.github.io/marg/reference/adr/0005-typed-decisions)
- [ADR 0006 — Metering is pass-through; users see a percentage](https://marg-adk.github.io/marg/reference/adr/0006-metering-pass-through)
- [ADR NNNN — <Decision title>](https://marg-adk.github.io/marg/reference/adr/template)

## Community

- [Contributing](https://marg-adk.github.io/marg/community/contributing)
- [Code of Conduct](https://marg-adk.github.io/marg/community/code-of-conduct)
- [Security policy](https://marg-adk.github.io/marg/community/security-policy)
- [The model must never read "yes"](https://marg-adk.github.io/marg/community/posts/the-model-must-never-read-yes)
- [Review: 0.3, walked as a stranger and set beside its peers](https://marg-adk.github.io/marg/community/reviews/0.3-review-2026-10)
- [Review: adk.dev, and what Marg takes from it](https://marg-adk.github.io/marg/community/reviews/adk-dev-2026-10)