Docker Agent

Docker released docker-agent, a docker CLI plugin that lets developers build, run, and share AI agents through declarative YAML configuration with no code required. The tool supports multi-agent orchestration, any MCP server as a tool source, provider-agnostic models including OpenAI, Anthropic, Gemini, AWS Bedrock, Mistral, xAI, and Docker Model Runner, plus RAG with BM25, embeddings, hybrid search, and reranking, and agents can be pushed to any OCI registry. Docker Desktop 4.63+ ships the plugin pre-installed, and it is also available via Homebrew and GitHub binary releases.

Build, run, and share AI agents with a declarative YAML config, rich tool ecosystem, and multi-agent orchestration. docker-agent lets you create and run intelligent AI agents that collaborate to solve complex problems — no code required. docker-agent is a docker CLI plugin and can be run with docker agent . Define agents in YAML, give them tools, and let them work. agents: root: model: openai/gpt-5-mini description: A helpful AI assistant instruction: | You are a knowledgeable assistant that helps users with various tasks. Be helpful, accurate, and concise in your responses. toolsets: - type: mcp ref: docker:duckduckgo docker agent run agent.yaml - Multi-agent architecture — Create teams of specialized agents that delegate tasks automatically - Rich tool ecosystem — Built-in tools + any MCP https://modelcontextprotocol.io/ server local, remote, or Docker-based - AI provider agnostic — OpenAI, Anthropic, Gemini, AWS Bedrock, Mistral, xAI, Docker Model Runner https://docs.docker.com/ai/model-runner/ , and more - YAML configuration — Declarative, versionable, shareable - Advanced reasoning — Built-in think, todo, and memory tools - RAG — Pluggable retrieval with BM25, embeddings, hybrid search, and reranking - Package & share — Push agents to any OCI registry, pull and run them anywhere Docker Desktop 4.63+ — docker-agent CLI plugin is pre-installed. Just run docker agent . Homebrew — brew install docker-agent . Run docker-agent directly or symlink the binary to ~/.docker/cli-plugins/docker-agent and run docker agent . Binary releases — Download from GitHub Releases https://github.com/docker/docker-agent/releases . Symlink the docker-agent binary to ~/.docker/cli-plugins/docker-agent to be able to use docker agent , or use docker-agent directly. Set at least one API key or use Docker Model Runner https://docs.docker.com/ai/model-runner/ for local models : export OPENAI API KEY=sk-... or ANTHROPIC API KEY, GOOGLE API KEY, etc. See Set Up a Model https://docker.github.io/docker-agent/getting-started/set-up-a-model for the full walkthrough of both paths cloud API key or local model . Run the default agent docker agent run Run from an OCI registry docker agent run myorg/agent:tag Generate a new agent interactively docker agent new Run your own config docker agent run agent.yaml More examples in the examples/ https://github.com/docker/docker-agent/blob/main/examples/README.md directory. - Installation https://docker.github.io/docker-agent/getting-started/installation · Set Up a Model https://docker.github.io/docker-agent/getting-started/set-up-a-model · Quick Start https://docker.github.io/docker-agent/getting-started/quickstart - Agents https://docker.github.io/docker-agent/concepts/agents · Models https://docker.github.io/docker-agent/concepts/models · Tools https://docker.github.io/docker-agent/concepts/tools · Multi-Agent https://docker.github.io/docker-agent/concepts/multi-agent - Configuration Reference https://docker.github.io/docker-agent/configuration/overview - TUI https://docker.github.io/docker-agent/features/tui · CLI https://docker.github.io/docker-agent/features/cli · MCP Mode https://docker.github.io/docker-agent/features/mcp-mode · RAG https://docker.github.io/docker-agent/tools/rag - Model Providers https://docker.github.io/docker-agent/providers/overview · Docker Model Runner https://docker.github.io/docker-agent/providers/dmr Read the Contributing guide https://docker.github.io/docker-agent/community/contributing to get started. We use docker-agent to build docker-agent : docker agent run ./golang developer.yaml We collect anonymous usage data to improve the tool. See Telemetry https://docker.github.io/docker-agent/community/telemetry .