- 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.
For certificate trust updates and rebuilding existing images, see Refreshing example certificate trust.
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.envfile from themcp.env.examplefile (if it exists, otherwise the demo doesn't need any secrets) and supply the required MCP tokens - run
docker compose up --build
The demos support using OpenAI models instead of running models locally with Docker Model Runner. To use OpenAI:
-
Create a
secret.openai-api-keyfile with your OpenAI API key:sk-... -
Start the project with the OpenAI configuration:
docker compose -f compose.yaml -f compose.openai.yaml up
| 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 |
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
LICENSEfile. 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