Synth Swarms Python 工具包
通过 Python、命令行或 MCP 启动 Synth 托管的研究任务,并获取答案、来源和费用。
- Star 数
- ★ 81
- 最近更新
- 1 天前
- License
- MIT
- 主语言
- Python
- FA 评分
- 63/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 需要在 Python 研究脚本中提交有预算上限的 Synth Swarms 任务并读取答案、来源和费用的开发者。
- 不适合
- 需要完全离线运行的团队
- 需要自托管研究执行服务的团队
- 官网
- docs.usesynth.ai/intro ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-20最新版本 v0.23.9(2026-10-26)
- 源码审查
- 63/100 · 存在缺口
这个 Agent 能做什么,适合哪些场景?
Synth AI 是面向 Synth 公共 API v1 的 Python 3.11+ 类型化客户端,提供 SDK、synth 命令行工具和可选的 stdio MCP 服务器。用户提交任务、预算以及可选的已发布运行配置和输入文件,Swarms API 执行任务;客户端可等待运行并取得最终答案、来源和费用。SDK 同时提供同步的 SynthClient 和异步的 AsyncSynthClient。运行需要配置 SYNTH_API_KEY,并可选设置 SYNTH_API_BASE_URL,因此执行依赖 Synth API,而不是本地自托管服务。文档建议使用最新发布版本;当前 README 标明发布版本为 0.34.0。
Python 程序可用 SynthClient 或 AsyncSynthClient 调用 client.swarms.run(...),向 Synth API 提交研究任务和预算,并等待结果。通过 client.swarms.profiles() 查询可用运行配置;研究配置可指定已发布任务及其审批。用 upload_file 上传 UTF-8 文本、Markdown 或 JSON,再以不可变的文件 ID、修订 ID 和 SHA-256 摘要将其作为运行输入。命令行提供 synth login、synth run、synth profiles、synth logs、synth download 和 synth upload 等操作。安装 synth-ai[mcp] 后,可运行 synth-ai-mcp stdio 服务器,并通过其 MCP 工具使用 Swarms 功能。
- 需要在 Python 研究脚本中提交有预算上限的 Synth Swarms 任务并读取答案、来源和费用的开发者。
- 希望在终端登录、选择运行配置、启动任务并等待完成的研究人员。
- 需要将 Markdown、文本或 JSON 任务文件上传后作为运行输入的团队。
- 想检查已发布配置及其描述、修订、路由支持和调用者可用性的 API 使用者。
- 需要把 Synth Swarms 操作接入支持 stdio MCP 服务器的客户端的开发者。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
pip install synth-aipip install 'synth-ai[mcp]'
- 环境变量
SYNTH_API_KEYSYNTH_API_BASE_URL- 运行环境
- Python 3.11+
如何安装或部署这个 Agent?
需要 Python 3.11+。安装 SDK 和 CLI;使用 MCP 时安装额外依赖。配置 API 密钥后登录 CLI:
pip install synth-ai
pip install 'synth-ai[mcp]'
export SYNTH_API_KEY="your-api-key"
synth login如何使用这个 Agent?
在 Python 中启动任务并读取结果:
from synth_ai import SynthClient
with SynthClient() as client:
run = client.swarms.run("Compare retrieval methods", budget="2.00")
print(run.run_id, run.state)
result = client.swarms.result(run)
print(result.answer)或从终端启动并等待任务:
synth run "Solve this task" --budget 2.00 --profile swarms-v2 --wait设置 SYNTH_API_KEY;需要自定义 API 地址时可设置 SYNTH_API_BASE_URL。异步程序可使用 AsyncSynthClient 和 await。
这个 Agent 有哪些优点和局限?
- 一个包提供类型化 Python SDK、CLI 和可选 stdio MCP 服务器。
- 结果接口包含最终答案、来源和费用,便于在脚本中处理运行结果。
- 支持文件上传及不可变版本和摘要引用,单文件和单次启动最多 32 MiB,最多 32 个文件引用。
- 运行配置目录会展示描述、修订、路由支持和针对调用者的可用性。
- 运行依赖 Synth 公共 API v1 和 API 密钥;README 没有说明离线或本地执行模式。
- 仅支持最新发布版本,旧版升级或兼容需求可能需要迁移。
- 上传文件仅支持 UTF-8 文本、Markdown 和 JSON;内联上传上限为 32 KiB。
- 文档中的资格冒烟流程会产生费用,并明确不代表托管 MCP OAuth、供应商账单最终性或负载能力验收。
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Synth Swarms Python 工具包 当前 | 63 · 存在缺口 | 代码库 / SDK | ★ 81 | 1 天前 | Python | — |
| NotebookLM Python 自动化套件 | 76 · 表现良好 | 命令行工具免费 + 模型费 | ★ 20k | 1 天前 | Python | Codex · Claude Code · Claude.ai |
| Taisly 视频发布工具包 | 71 · 存在缺口 | 命令行工具免费版 + 付费版 | ★ 211 | 1 个月前 | JavaScript | Codex · Claude Code |
| mcp-agent | 60 · 存在缺口 | 开发框架免费 + 模型费 | ★ 8.6k | 9 个月前 | Python | Claude.ai · OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
SDK、CLI 和 MCP 将能力限定在公开 API 操作;运行要求预算,变更工具要求幂等键,文档描述暂停、恢复和取消。文件上传、运行和账单属于外部影响,但来源未展示权限细分或通用确认流程,故未给满分。MCP 示例把 API 密钥放在配置环境变量中,未展示更完整的密钥保护;依赖有版本范围但无安全审计证据。发布者身份未核验,许可证署名只能证明文件声明,不能确认发布者归属。
文档提供错误指南、统一错误码、CLI 退出码和超时语义,依赖也有版本约束;但 README 声称发布版为 0.34.0,pyproject.toml 为 0.38.0,存在直接版本冲突。
材料覆盖 Python SDK、CLI 和 MCP 三种入口,说明同步与异步用法、运行配置及研究任务条件。适用范围和文件限制有描述,但未展示完整场景矩阵或所有运行环境边界。
目录与文档入口清楚,安装步骤、快速开始和限制说明较充分;MIT 许可证明确。示例涉及 SDK、CLI、MCP 与上传流程。版本号互相冲突,材料未展示变更日志或明确维护责任人,因此命名稳定性、版本追踪和维护归属得分较低。
产品提供类型化 API、运行生命周期管理、结果与费用查询,并能从 CLI 和 MCP 使用;预算和结果输出有助于实际使用。但证据不能量化相对价值或用户成本,故为中等分。
安装、限制和用法能在 README、快速开始、配置及源码中找到对应证据;CI 文件列出检查步骤,但本次静态审查未执行或验证它们。不同文件相互支持主要接口说明,不过发布版本冲突削弱一致性。材料区分了一些明确限制与能力描述,但没有系统标注事实和推断。
- README 与 pyproject.toml 的发布版本分别为 0.34.0 和 0.38.0;使用者应在安装或升级前核对目标版本及对应契约。
- 运行、上传和账单查询可能产生费用或外部数据传输;示例要求配置 API 密钥,使用者应妥善管理密钥并核对预算与上传内容。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
Qualified exact SDK 0.24.0 wheel bytes (sha256 64f72a75...) for trusted publication. Source 32d61d0c = dev 3e98a9a6 plus the 0.24.0 version bump; contracts core.v1 b33b2bee, index.v1 72816159, swarms.v1 a1a1c821 match the backend candidate dc8239887d serving staging (staging capability negotiation with these bytes passed). Native Index/Monitor/Swarms E2E are owner-waived in the reviewed release policy for 0.24.0.在 GitHub 查看 ↗ -
v0.23.9 SDK 0.23.9
发布说明摘录
Synth AI 0.23.9 retries a hosted Swarms run create refused with the retryable owner_unavailable readiness refusal (503, Retry-After) under a fresh idempotency key, like launch_admission_busy; exhaustion keeps the refusal code and cause. Otherwise identical to 0.23.8: ProjectTemplate.CODE_NATIVE, typed CodeValidation, shipped contract schemas (index.v1, swarms.v1) match the deployed v0.23.2 backend. Install with python -m pip install 'synth-ai==0.23.9'. …在 GitHub 查看 ↗ -
v0.23.8 SDK 0.23.8
发布说明摘录
Synth AI 0.23.8 adds ProjectTemplate.CODE_NATIVE and typed CodeValidation for hosted code projects. Verified code publications appear in public Swarms results; repository handles retrieve the graded commit and archive. Shipped contract schemas (index.v1, swarms.v1) match the deployed v0.23.2 backend. Install with python -m pip install 'synth-ai==0.23.8'. Qualified source: a6320c1c7df02531173e02268f09d95fd1785b2a. Wheel SHA256: 93c04fce1bb28e43997bdea576bc57d9a101c0b8eabf581e67aec2cd322839b7.在 GitHub 查看 ↗
常见问题
运行费用是多少?
是否必须使用 API 密钥?
SYNTH_API_KEY 才能调用 Synth API;SYNTH_API_BASE_URL 是可选项。可以使用自己的运行配置吗?
上传有哪些限制?
upload_text 和 MCP 的 swarms_upload_file 内联内容最多 32 KiB。MCP 支持是否意味着托管 OAuth 已可用?
Synth Swarms Python 工具包 官网是什么?
Synth Swarms Python 工具包 开源吗?
Synth Swarms Python 工具包 安全吗?
Synth Swarms Python 工具包 还在维护吗?
Synth Swarms Python 工具包 是谁开发的?
谢谢反馈,我们会据此改进页面。