Docker Agent is a powerful tool designed to simplify the creation, deployment, and orchestration of AI agents. It enables users to define intelligent agents using declarative YAML configurations, integrate with a variety of tools, and manage multi-agent teams efficiently.
Key Features:
Multi-Agent Architecture: Build teams of specialized agents that collaborate and delegate tasks automatically.
Rich Tool Ecosystem: Utilizes built-in tools and supports any MCP server for extensive functionality.
AI Provider Agnostic: Compatible with major AI providers including OpenAI, Anthropic, Gemini, AWS Bedrock, and more.
YAML Configuration: Offers a declarative, versionable, and shareable approach to agent definition.
Advanced Reasoning Tools: Includes built-in capabilities for thinking, task management, and memory retention.
RAG Capabilities: Supports retrieval with BM25, embeddings, hybrid search, and reranking for enhanced AI interactions.
Package & Share: Easily push agents to OCI registries for distribution and deployment across environments.
Audience & Benefit:
Ideal for developers, data scientists, and teams seeking to build intelligent systems without extensive coding. Docker Agent allows users to streamline the development of sophisticated AI applications, enhancing productivity and scalability.
Installation is straightforward via winget. With its flexible architecture and support for multiple AI providers, Docker Agent empowers organizations to integrate AI solutions seamlessly into their workflows.
README
🤖 Docker Agent 🤖
> Build, run, and share AI agents with a declarative YAML config, rich tool ecosystem, and multi-agent orchestration.
What is Docker Agent?
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
Key Features
Multi-agent architecture — Create teams of specialized agents that delegate tasks automatically
Rich tool ecosystem — Built-in tools + any MCP server (local, remote, or Docker-based)
AI provider agnostic — OpenAI, Anthropic, Gemini, AWS Bedrock, Mistral, xAI, Docker Model Runner, and more
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
Install
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. Symlink the docker-agent binary to ~/.docker/cli-plugins/docker-agent to be able to use docker agent, or use directly.
export OPENAI_API_KEY=sk-... # or ANTHROPIC_API_KEY, GOOGLE_API_KEY, etc.
Quick Start
# Run the default agent
docker agent run
# Run from the agent catalog
docker agent run agentcatalog/pirate
# Generate a new agent interactively
docker agent new
# Run your own config
docker agent run agent.yaml
