ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

OpenSwarm Docker部署+FastAPI教程:把多智能体系统变成生产级API服务

OpenSwarm Docker部署+FastAPI教程:把多智能体系统变成生产级API服务 OpenSwarm Docker部署FastAPI教程把多智能体系统变成生产级API服务【免费下载链接】OpenSwarmClaude code for everything except coding项目地址: https://gitcode.com/gh_mirrors/open/OpenSwarm OpenSwarm 是一个完全开源的多智能体 AI 团队一条提示词就能产出幻灯片、研究报告、文档、图片和视频。本教程带你完成OpenSwarm Docker 部署并借助内置的FastAPI 服务把这套 8 智能体系统一键变成生产级 API 服务——无需前端、无需 UI30 秒启动、分钟级投产。一、OpenSwarm 是什么为什么值得部署成 APIOpenSwarm 的核心理念是专家协作而非单兵作战一个编排器Orchestrator负责路由任务8 个专家智能体各司其职智能体职责 Orchestrator只负责调度把请求分发给合适的专家 Virtual Assistant邮件、日历、Slack、文件管理 Deep Research带引用与交叉验证的网络深度调研 Data Analyst在隔离 IPython 内核中做数据分析与可视化️ Slides Agent生成精美 HTML 幻灯片并导出 PPTX Docs Agent从大纲生成 Word 文档与 PDF Image GenerationGemini 图像生成与编辑 Video GenerationSora / Veo 视频生成与剪辑把它部署为 API 服务的好处在于✅服务化调用你的 SaaS、内部系统、CI 流水线都能通过 HTTP 调用多智能体能力✅环境隔离Docker 镜像内置 Node.js、LibreOffice、Playwright 等全部依赖告别在我机器上能跑✅完全可定制100% 开源可 fork改个instructions.md就能变成 SEO 团队或销售团队各智能体源码分别位于 orchestrator/、slides_agent/、docs_agent/、deep_research/ 等目录架构说明见 AGENTS.md。二、Docker 一键部署步骤1. 获取仓库并配置密钥git clone https://gitcode.com/gh_mirrors/open/OpenSwarm cd OpenSwarm cp .env.example .env # 填入你的 API 密钥密钥配置规则很简单必填项二选一OPENAI_API_KEYGPT 模型 Sora 视频生成ANTHROPIC_API_KEYClaude 模型可选超级能力密钥COMPOSIO_API_KEY10000 外部集成、GOOGLE_API_KEYGemini 图像 Veo 视频、FAL_KEY高级视频特效、SEARCH_API_KEY研究智能体联网搜索。缺少密钥时工具会优雅降级并给出提示不会直接报错。2. 启动容器docker-compose up --build就这一条命令。docker-compose.yml 已为你配置好端口映射8080:8080服务直接暴露在 8080 端口环境变量通过env_file自动加载你的.env数据卷./mnt:/app/mnt与./uploads:/app/uploads智能体产出的文件和上传素材都会持久化到宿主机3. 镜像里有什么Dockerfile 基于python:3.13-slim一次装齐了运行全部智能体所需的重型依赖这也是 Docker 部署最省心的地方依赖用途Node.js 20 LTS幻灯片 HTML 转 PPTXLibreOfficePPTX 缩略图与 PDF 转换Playwright Chromium文档/幻灯片渲染与截图Python 全量依赖见 requirements.txtpandas、sklearn、moviepy、python-pptx 等三、FastAPI 服务入口解析OpenSwarm 把变成 API 服务这件事做到了极致——server.py 全文不到 30 行from swarm import create_agency from agency_swarm.integrations.fastapi import run_fastapi if __name__ __main__: run_fastapi( agencies{open-swarm: create_agency}, port8080, enable_loggingTrue, allowed_local_file_dirs[./uploads], )关键点只有两个create_agencyswarm.py 中的工厂函数实例化 8 个智能体、建立编排器→全体专家的消息流与任意两两间的 Handoff 流组装成名为OpenSwarm的 Agencyrun_fastapiAgency Swarm 框架自带的 FastAPI 集成自动挂载对话、文件上传等端点并限制本地文件访问范围为./uploads安全边界清晰。本地开发也可以直接python swarm.py进入终端 TUI 交互模式run_utils.py 负责环境自检、依赖引导与状态目录默认~/.openswarm管理。四、调用 API把提示词变成服务服务启动后向http://localhost:8080发起请求即可。典型场景示例POST / 发送为 Q2 营销活动生成一份完整 PPT 并附执行文档 → Orchestrator 拆分任务 → Slides Agent 出幻灯片 → Docs Agent 出执行文档常用配置速查配置项说明DEFAULT_MODEL默认gpt-5.4支持provider/model形式经 LiteLLM 路由到任意模型见 config.pyENABLE_TELEMETRY0关闭遥测数据卷目录上传文件放uploads/产出文件落mnt/生产化小贴士用docker-compose的 restart 策略 反向代理Nginx/Traefik HTTPS 暴露 8080 端口多密钥按需注入最小化权限./uploads白名单机制已替你拦下了目录穿越风险想改造成自己的团队fork 后只改各智能体目录里的instructions.md再更新 swarm.py 的注册列表即可详见 AGENTS.md五、常见问题速查Q构建很慢是不是挂了A镜像要下载 Node.js、LibreOffice 和 Playwright 依赖首次--build需要几分钟属正常现象。Q端口被占用A修改 docker-compose.yml 中8080:8080的宿主机端口即可。Q某个功能提示缺密钥A按 README.md 的密钥清单补到.env然后docker-compose up -d重建容器生效。 总结三条命令完成OpenSwarm Docker 部署内置FastAPI让 8 个专家智能体立刻以 API 形式对外服务。从终端玩具到生产级多智能体 API 服务OpenSwarm 只隔一个 Dockerfile 的距离——现在就可以 fork 它搭建属于你的智能体团队。【免费下载链接】OpenSwarmClaude code for everything except coding项目地址: https://gitcode.com/gh_mirrors/open/OpenSwarm创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表