Synth Swarms Python 工具包

通过 Python、命令行或 MCP 启动 Synth 托管的研究任务,并获取答案、来源和费用。

Star 数
★ 81
最近更新
1 天前
License
MIT
主语言
Python

30 秒速览

运行形态
代码库 / SDK命令行工具MCP 服务器
可在哪里用
平台专用
上手难度
低 · 几分钟可跑通
开始前需要
Python 3.11+Synth 公共 API v1SYNTH_API_KEYShell / 命令行网络访问本地文件系统MCP Server
典型场景
需要在 Python 研究脚本中提交有预算上限的 Synth Swarms 任务并读取答案、来源和费用的开发者。
不适合
  • 需要完全离线运行的团队
  • 需要自托管研究执行服务的团队
官网
docs.usesynth.ai/intro ↗ 来自 GitHub 仓库设置
维护状态
近 30 天有提交最近提交 2026-11-20最新版本 v0.23.9(2026-10-26)

这个 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 功能。

  1. 需要在 Python 研究脚本中提交有预算上限的 Synth Swarms 任务并读取答案、来源和费用的开发者。
  2. 希望在终端登录、选择运行配置、启动任务并等待完成的研究人员。
  3. 需要将 Markdown、文本或 JSON 任务文件上传后作为运行输入的团队。
  4. 想检查已发布配置及其描述、修订、路由支持和调用者可用性的 API 使用者。
  5. 需要把 Synth Swarms 操作接入支持 stdio MCP 服务器的客户端的开发者。

安装与配置要点

摘自下方的安装和使用说明,以项目 README 的最新说明为准。

安装 / 启动命令
  • pip install synth-ai
  • pip install 'synth-ai[mcp]'
环境变量
SYNTH_API_KEY SYNTH_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?

FollowAgents 源码审查 · FARS-2.1
存在缺口
63/ 100 五分制 3.2 / 5
信任安全 16/29
可靠稳定 8/14
适用触发 12/18
规范维护 13/18
有效结果 9/13
证据核验 5/8
查看各维度的扣分理由
信任安全16 / 29 · 2.8/5

SDK、CLI 和 MCP 将能力限定在公开 API 操作;运行要求预算,变更工具要求幂等键,文档描述暂停、恢复和取消。文件上传、运行和账单属于外部影响,但来源未展示权限细分或通用确认流程,故未给满分。MCP 示例把 API 密钥放在配置环境变量中,未展示更完整的密钥保护;依赖有版本范围但无安全审计证据。发布者身份未核验,许可证署名只能证明文件声明,不能确认发布者归属。

可靠稳定8 / 14 · 2.9/5

文档提供错误指南、统一错误码、CLI 退出码和超时语义,依赖也有版本约束;但 README 声称发布版为 0.34.0,pyproject.toml 为 0.38.0,存在直接版本冲突。

适用触发12 / 18 · 3.3/5

材料覆盖 Python SDK、CLI 和 MCP 三种入口,说明同步与异步用法、运行配置及研究任务条件。适用范围和文件限制有描述,但未展示完整场景矩阵或所有运行环境边界。

规范维护13 / 18 · 3.6/5

目录与文档入口清楚,安装步骤、快速开始和限制说明较充分;MIT 许可证明确。示例涉及 SDK、CLI、MCP 与上传流程。版本号互相冲突,材料未展示变更日志或明确维护责任人,因此命名稳定性、版本追踪和维护归属得分较低。

有效结果9 / 13 · 3.5/5

产品提供类型化 API、运行生命周期管理、结果与费用查询,并能从 CLI 和 MCP 使用;预算和结果输出有助于实际使用。但证据不能量化相对价值或用户成本,故为中等分。

证据核验5 / 8 · 3.1/5

安装、限制和用法能在 README、快速开始、配置及源码中找到对应证据;CI 文件列出检查步骤,但本次静态审查未执行或验证它们。不同文件相互支持主要接口说明,不过发布版本冲突削弱一致性。材料区分了一些明确限制与能力描述,但没有系统标注事实和推断。

风险与缓解建议
  • README 与 pyproject.toml 的发布版本分别为 0.34.0 和 0.38.0;使用者应在安装或升级前核对目标版本及对应契约。
  • 运行、上传和账单查询可能产生费用或外部数据传输;示例要求配置 API 密钥,使用者应妥善管理密钥并核对预算与上传内容。
证据充分度:低 评估于 2026年11月11日 审查版本 196c892be335 评估后仓库已有新提交,评分可能未覆盖最新改动
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/synth-ai.svg?lang=zh)](https://followagents.com/zh/agents/synth-ai)
<a href="https://followagents.com/zh/agents/synth-ai"><img src="https://followagents.com/badge/synth-ai.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. sdk-qualification-0.24.0-32d61d0c-20261103 SDK 0.24.0 qualified artifact 预发布
    发布说明摘录
    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 查看 ↗
  2. 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 查看 ↗
  3. 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 查看 ↗

常见问题

运行费用是多少?
README 未给出价格表。运行调用包含预算参数,结果包含费用;资格冒烟流程设有三个各 4 美元的运行上限,总计 12 美元。
是否必须使用 API 密钥?
是。配置 SYNTH_API_KEY 才能调用 Synth API;SYNTH_API_BASE_URL 是可选项。
可以使用自己的运行配置吗?
运行时可选择已发布配置;研究配置还需要已发布且获批的研究任务。README 表示任意 actor 覆盖不属于公共 API。
上传有哪些限制?
文件必须是 UTF-8 文本、Markdown 或 JSON;每个文件和每次启动最多 32 MiB,最多 32 个文件引用。upload_text 和 MCP 的 swarms_upload_file 内联内容最多 32 KiB。
MCP 支持是否意味着托管 OAuth 已可用?
README 记录的是可选 stdio MCP 服务器,并明确指出资格冒烟流程不验证托管 MCP OAuth。
Synth Swarms Python 工具包 官网是什么?
Synth Swarms Python 工具包 的 GitHub 仓库填写的官网是 https://docs.usesynth.ai/intro。这个链接由仓库作者设置;源码在 GitHub(synth-laboratories/synth-ai)。
Synth Swarms Python 工具包 开源吗?
开源。源码在 GitHub(synth-laboratories/synth-ai),许可证是 MIT。
Synth Swarms Python 工具包 安全吗?
FollowAgents 的 FARS 评审(2026年11月11日)给 Synth Swarms Python 工具包 的“信任与安全”打了 16/29 分。评审检查的 8 项安全措施没有完全缺失的。评审之后仓库已有更新。
Synth Swarms Python 工具包 还在维护吗?
在维护。GitHub 上最近一次提交是 2026-11-20,在最近 30 天内。最新版本是 v0.23.9(2026-10-26)。
Synth Swarms Python 工具包 是谁开发的?
Synth Swarms Python 工具包 由 GitHub 账号 synth-laboratories 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念