docker/docker-agent: AI Agent Builder and Runtime by Docker Engineering · GitHub

Build, run, and share AI brokers with a declarative YAML config, wealthy device ecosystem, and multi-agent orchestration.

docker-agent permits you to create and run clever AI brokers that collaborate to resolve advanced issues — no code required.

docker-agent is a docker CLI plugin and may be run with docker agent.

Define brokers in YAML, give them instruments, and allow them to work.

brokers:
  root:
    mannequin: openai/gpt-5-mini
    description: A useful AI assistant
    instruction: |
      You are a educated assistant that helps customers with varied duties.
      Be useful, correct, and concise in your responses.
    toolsets:
      - kind: mcp
        ref: docker:duckduckgo

docker agent run agent.yaml

• Multi-agent structure — Create groups of specialised brokers that delegate duties routinely
• Rich device ecosystem — Built-in instruments + any MCP server (native, distant, or Docker-based)
• AI supplier agnostic — OpenAI, Anthropic, Gemini, AWS Bedrock, Mistral, xAI, Docker Model Runner, and extra
• YAML configuration — Declarative, versionable, shareable
• Advanced reasoning — Built-in suppose, todo, and reminiscence instruments
• RAG — Pluggable retrieval with BM25, embeddings, hybrid search, and reranking
• Package & share — Push brokers to any OCI registry, pull and run them wherever

Docker Desktop (4.63+) — docker-agent CLI plugin is pre-installed. Just run docker agent.

Homebrew — brew set up docker-agent. Run docker-agent immediately 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 have the ability to use docker agent, or use docker-agent immediately.

Set a minimum of one API key (or use Docker Model Runner for native fashions):

export OPENAI_API_KEY=sk-...        # or ANTHROPIC_API_KEY, GOOGLE_API_KEY, and many others.

See Set Up a Model for the complete walkthrough of each paths (cloud API key or native mannequin).

# Run the default agent
docker agent run

# Run from an OCI registry
docker agent run myorg/agent:tag

# Generate a brand new agent interactively
docker agent new

# Run your personal config
docker agent run agent.yaml

More examples within the examples/ listing.

📖 Full documentation

Read the Contributing guide to get began. We use docker-agent to construct docker-agent:

docker agent run ./golang_developer.yaml

We acquire nameless utilization information to enhance the device. See Telemetry.

Docker Community Slack · #docker-agent channel