compose-for-agents

用 Docker Compose 一键编排多智能体，快速跑通开源 LLM 应用

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署开源模型 🍴 复刻 484 🐛 待处理 27 👀 关注 30

GitHub ↗

GitHub 星标 ★ 1072

维护状态较活跃

是否开源开源

定价模式 🏷️完全免费开源项目，基于Apache-2.0许可证，可自由使用和部署，无收费计划。

项目预览

compose-for-agents 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类开源模型

开发团队docker

GitHubhttps://github.com/docker/compose-for-agents

定价模式🏷️完全免费

价格说明开源项目，基于Apache-2.0许可证，可自由使用和部署，无收费计划。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议Apache-2.0

主要语言TypeScript

技术栈/模型agentic-workflows,ai-agents,docker,docker-compose,examples,large-language-models,llama-cpp,openai-gym,self-hosted

GitHub 星标★ 1072

上线时间2025-05-09 00:00:00

代码更新2026-10-23

仓库体积32.4 MB

本站数据更新2026-11-09

维护状态较活跃

收录时间2026-08-09

浏览次数8

项目介绍

compose-for-agents 是一个基于 Docker Compose 编排 AI 代理的开源项目，旨在简化多智能体系统的构建与运行。它提供了一系列开箱即用的示例，帮助开发者快速组合开源大语言模型（LLM）、工具和代理运行时，解决 AI 应用部署复杂、环境配置繁琐的问题。核心能力包括：通过声明式 YAML 文件定义代理服务、模型与工具链；支持多种主流开源模型（如 Llama、Mistral）和代理框架（如 LangChain、AutoGen）；提供一键启动的完整环境，便于本地开发与测试。项目采用 TypeScript 编写，强调可移植性和可复制性，适合希望快速原型验证或生产部署的团队。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1072

技术标签

agentic-workflows ai-agents docker docker-compose examples

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：进阶约 10 分钟部署方式：Docker 6 步

环境要求

Docker Desktop 4.43.0+ 或 Docker Engine
带 GPU 的笔记本/工作站；无 GPU 可使用 Docker Offload
Linux 上使用 Docker Engine 时需安装 Docker Compose 2.38.1 或更高版本
Windows 的 Docker Desktop / Linux 的 Docker Engine 需满足 Docker Model Runner 要求（启用 G

安装与启动步骤

1克隆仓库

从 GitHub 拉取 compose-for-agents 源码到本地，后续所有 demo 都在该仓库目录内操作。
```
git clone https://github.com/docker/compose-for-agents.git
```
2进入 demo 目录

每个 demo 自包含，先切换到你要运行的 demo 项目根目录再执行后续命令。
```
cd compose-for-agents
```
3准备 MCP 密钥文件

如果 demo 目录下存在 mcp.env.example，就复制为 .mcp.env；不存在说明该 demo 不需要密钥，可跳过。
```
cp mcp.env.example .mcp.env
```
4填写 MCP 令牌

编辑 .mcp.env，按示例填入所需的 MCP tokens 并保存。
5构建并启动

在 demo 根目录执行，Docker Compose 会构建镜像并启动全部代理、模型与工具服务。
```
docker compose up --build
```
6改用 OpenAI 模型

不想本地跑模型的场景：先写入密钥文件，再用叠加的 OpenAI 配置文件启动。
```
echo 'sk-xxxxxxxx' > secret.openai-api-key
docker compose -f compose.yaml -f compose.openai.yaml up
```

关键配置

配置项	必填	说明	示例
`.mcp.env`	是	存放 demo 所需的 MCP tokens，由 mcp.env.example 复制而来	`cp mcp.env.example .mcp.env`
`secret.openai-api-key`	否	存放 OpenAI API Key，用于替代本地 Docker Model Runner 模型	`sk-xxxxxxxx`