docker/compose-for-agents

Build and run AI agents using Docker Compose. A collection of ready-to-use examples for orchestrating open-source LLMs, tools, and agent runtimes.

TypeScript

1,054

480 commits

updated Sep 2, 2026

See the code

README

Compose for Agents Demos

Prerequisites

Docker Desktop 4.43.0+ or Docker Engine installed.
A laptop or workstation with a GPU (e.g., a MacBook) for running open models locally. If you don't have a GPU, you can alternatively use Docker Offload.
If you're using Docker Engine on Linux or Docker Desktop on Windows, ensure that the Docker Model Runner requirements are met (specifically that GPU support is enabled) and the necessary drivers are installed.
If you're using Docker Engine on Linux, ensure you have Docker Compose 2.38.1 or later installed.

Demos

Each of these demos is self-contained and can be run either locally or using a cloud context. They are all configured using two steps.

change directory to the root of the demo project
create a .mcp.env file from the mcp.env.example file (if it exists, otherwise the demo doesn't need any secrets) and supply the required MCP tokens
run docker compose up --build

Using OpenAI models

The demos support using OpenAI models instead of running models locally with Docker Model Runner. To use OpenAI:

Create a secret.openai-api-key file with your OpenAI API key:
```
sk-...
```

Start the project with the OpenAI configuration:

docker compose -f compose.yaml -f compose.openai.yaml up

Compose for Agents Demos - Classification

Demo	Agent System	Models	MCPs	project	compose
A2A Multi-Agent Fact Checker	Multi-Agent	OpenAI	duckduckgo	./a2a	compose.yaml
Agno agent that summarizes GitHub issues	Multi-Agent	qwen3(local)	github-official	./agno	compose.yaml
Vercel AI-SDK Chat-UI for mixing MCPs and Model	Single Agent	llama3.2(local), qwen3(local)	wikipedia-mcp, brave, resend(email)	./vercel	compose.yaml
CrewAI Marketing Strategy Agent	Multi-Agent	qwen3(local)	duckduckgo	./crew-ai	compose.yaml
ADK Multi-Agent Fact Checker	Multi-Agent	gemma3-qat(local)	duckduckgo	./adk	compose.yaml
ADK & Cerebras Golang Experts	Multi-Agent	unsloth/qwen3-gguf:4B-UD-Q4_K_XL & ai/qwen2.5:latest (DMR local), llama-4-scout-17b-16e-instruct (Cerebras remote)		./adk-cerebras	compose.yml
LangGraph SQL Agent	Single Agent	qwen3(local)	postgres	./langgraph	compose.yaml
Embabel Travel Agent	Multi-Agent	qwen3, Claude3.7, llama3.2, jimclark106/all-minilm:23M-F16	brave, github-official, wikipedia-mcp, weather, google-maps, airbnb	./embabel	compose.yaml and compose.dmr.yaml
Spring AI Brave Search	Single Agent	none	duckduckgo	./spring-ai	compose.yaml
ADK Sock Store Agent	Multi-Agent	qwen3	MongoDb, Brave, Curl,	./adk-sock-shop	compose.yaml
Langchaingo DuckDuckGo Search	Single Agent	gemma3	duckduckgo	./langchaingo	compose.yaml
MinionS Cost-Efficient Local-Remote Collaboration	Local-Remote Protocol	qwen3(local), gpt-4o(remote)		./minions	docker-compose.minions.yml

License

This repository is dual-licensed under the Apache License 2.0 or the MIT License. You may choose either license to govern your use of the contributions made by Docker in this repository.

ℹ️ Note: Each example under may have its own LICENSE file. These are provided to reflect any third-party licensing requirements that apply to that specific example, and they must be respected accordingly.

SPDX-License-Identifier: Apache-2.0 OR MIT

agentic-workflows

ai-agents

docker

docker-compose

examples

large-language-models

llama-cpp

openai-gym

self-hosted

Significant stargazers

Batuhan Apaydın

958 followers · starred Sep 2025

David Scott

290 followers · starred Jul 2025

Marius Rackwitz

426 followers · starred Mar 2026

Nick Sieger

333 followers · starred Jul 2025

Similar repos

docker/docker-agent

AI Agent Builder and Runtime by Docker Engineering

4,446

same org

docker/cagent

AI Agent Builder and Runtime by Docker Engineering

4,444

same org

chaitin/agent-compose

docker/docker-compose like daemon for agents

266

THUDM/AgentBench

A Comprehensive Benchmark to Evaluate LLMs as Agents (ICLR'24)

3,767

Fosowl/agenticSeek

Fully Local Manus AI. No APIs, No $200 monthly bills. Enjoy an autonomous agent that thinks,…

27,475

AidenFaulconer/AI.DEN

Local agentic LLM using the latest and best in AI (MTP+Quant+Qwen3.5+caveman+claw-code)

Intelligent-Internet/ii-agent

II-Agent: a new open-source framework to build and deploy intelligent agents

3,390

the-open-agent/openagent

⚡️next-generation personal AI assistant powered by LLM, RAG and agent loops, supporting…

5,686

docker/compose-for-agents

Build and run AI agents using Docker Compose. A collection of ready-to-use examples for orchestrating open-source LLMs, tools, and agent runtimes.

TypeScript

1,054

480 commits

updated Sep 2, 2026

See the code

README

Compose for Agents Demos

Prerequisites

Docker Desktop 4.43.0+ or Docker Engine installed.
A laptop or workstation with a GPU (e.g., a MacBook) for running open models locally. If you don't have a GPU, you can alternatively use Docker Offload.
If you're using Docker Engine on Linux or Docker Desktop on Windows, ensure that the Docker Model Runner requirements are met (specifically that GPU support is enabled) and the necessary drivers are installed.
If you're using Docker Engine on Linux, ensure you have Docker Compose 2.38.1 or later installed.

Demos

Each of these demos is self-contained and can be run either locally or using a cloud context. They are all configured using two steps.

change directory to the root of the demo project
create a .mcp.env file from the mcp.env.example file (if it exists, otherwise the demo doesn't need any secrets) and supply the required MCP tokens
run docker compose up --build

Using OpenAI models

The demos support using OpenAI models instead of running models locally with Docker Model Runner. To use OpenAI:

Create a secret.openai-api-key file with your OpenAI API key:
```
sk-...
```

Start the project with the OpenAI configuration:

docker compose -f compose.yaml -f compose.openai.yaml up

Compose for Agents Demos - Classification

Demo	Agent System	Models	MCPs	project	compose
A2A Multi-Agent Fact Checker	Multi-Agent	OpenAI	duckduckgo	./a2a	compose.yaml
Agno agent that summarizes GitHub issues	Multi-Agent	qwen3(local)	github-official	./agno	compose.yaml
Vercel AI-SDK Chat-UI for mixing MCPs and Model	Single Agent	llama3.2(local), qwen3(local)	wikipedia-mcp, brave, resend(email)	./vercel	compose.yaml
CrewAI Marketing Strategy Agent	Multi-Agent	qwen3(local)	duckduckgo	./crew-ai	compose.yaml
ADK Multi-Agent Fact Checker	Multi-Agent	gemma3-qat(local)	duckduckgo	./adk	compose.yaml
ADK & Cerebras Golang Experts	Multi-Agent	unsloth/qwen3-gguf:4B-UD-Q4_K_XL & ai/qwen2.5:latest (DMR local), llama-4-scout-17b-16e-instruct (Cerebras remote)		./adk-cerebras	compose.yml
LangGraph SQL Agent	Single Agent	qwen3(local)	postgres	./langgraph	compose.yaml
Embabel Travel Agent	Multi-Agent	qwen3, Claude3.7, llama3.2, jimclark106/all-minilm:23M-F16	brave, github-official, wikipedia-mcp, weather, google-maps, airbnb	./embabel	compose.yaml and compose.dmr.yaml
Spring AI Brave Search	Single Agent	none	duckduckgo	./spring-ai	compose.yaml
ADK Sock Store Agent	Multi-Agent	qwen3	MongoDb, Brave, Curl,	./adk-sock-shop	compose.yaml
Langchaingo DuckDuckGo Search	Single Agent	gemma3	duckduckgo	./langchaingo	compose.yaml
MinionS Cost-Efficient Local-Remote Collaboration	Local-Remote Protocol	qwen3(local), gpt-4o(remote)		./minions	docker-compose.minions.yml

License

This repository is dual-licensed under the Apache License 2.0 or the MIT License. You may choose either license to govern your use of the contributions made by Docker in this repository.

ℹ️ Note: Each example under may have its own LICENSE file. These are provided to reflect any third-party licensing requirements that apply to that specific example, and they must be respected accordingly.

SPDX-License-Identifier: Apache-2.0 OR MIT

agentic-workflows

ai-agents

docker

docker-compose

examples

large-language-models

llama-cpp

openai-gym

self-hosted

Significant stargazers

Batuhan Apaydın

958 followers · starred Sep 2025

David Scott

290 followers · starred Jul 2025

Marius Rackwitz

426 followers · starred Mar 2026

Nick Sieger

333 followers · starred Jul 2025

Similar repos

docker/docker-agent

AI Agent Builder and Runtime by Docker Engineering

4,446

same org

docker/cagent

AI Agent Builder and Runtime by Docker Engineering

4,444

same org

chaitin/agent-compose

docker/docker-compose like daemon for agents

266

THUDM/AgentBench

A Comprehensive Benchmark to Evaluate LLMs as Agents (ICLR'24)

3,767

Fosowl/agenticSeek

Fully Local Manus AI. No APIs, No $200 monthly bills. Enjoy an autonomous agent that thinks,…

27,475

AidenFaulconer/AI.DEN

Local agentic LLM using the latest and best in AI (MTP+Quant+Qwen3.5+caveman+claw-code)

Intelligent-Internet/ii-agent

II-Agent: a new open-source framework to build and deploy intelligent agents

3,390

the-open-agent/openagent

⚡️next-generation personal AI assistant powered by LLM, RAG and agent loops, supporting…

5,686