docker / docker-agent

# 🤖 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.
 [code] 
 [code] 
## 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
- **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
## 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 `docker-agent` directly.
Set at least one API key (or use Docker Model Runner for local models):
 [code] 
See Set Up a Model for the full walkthrough of both paths (cloud API key or local model).
## Quick Start
 [code] 
More examples in the `examples/` directory.
## Documentation
📖 **Full documentation**
- Installation · Set Up a Model · Quick Start
- Agents · Models · Tools · Multi-Agent
- Configuration Reference
- TUI · CLI · MCP Mode · RAG
- Model Providers · Docker Model Runner
## Contributing
Read the Contributing guide to get started. We use `docker-agent` to build `docker-agent`:
 [code] 
## Telemetry
We collect anonymous usage data to improve the tool. See Telemetry.
## Community
Docker Community Slack · #docker-agent channel
Explore community projects, videos, and articles about Docker Agent.