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.

1. change directory to the root of the demo project
2. 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
3. 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:

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

   sk-...
   

2. 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