GenoMAS
面向基因表达分析的代码驱动多智能体自动化框架。
- Star 数
- ★ 130
- 最近更新
- 15 天前
- License
- MIT
- 主语言
- Python
- FA 评分
- 50/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台OpenAI API · Claude API
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 计算基因组学研究人员需要对 GenoTEX 中的大量性状—条件组合执行一致的基因表达预处理和回归分析。
- 不适合
- 需要完全离线运行且无GPU的团队,本地大模型需多块高端GPU
- 只想快速验证完整分析流程的用户,完整基准需约42GB数据、3-5天和300美元以上
- 没有GEO/TCGA转录组数据或相关生物信息背景的团队
- 源码审查
- 50/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
GenoMAS 包含一个用于科学工作流自动化的极简多智能体框架,以及一个面向基因表达数据分析的专用实现。框架采用类型化消息通信和类似 Notebook 的工作流,使智能体能够规划、编写代码、执行、调试并在多步骤任务中回溯。专用系统处理来自 GEO 与 TCGA 的转录组数据,目标是在考虑混杂因素的前提下识别与性状相关的显著基因。实验通过命令行运行,结果按 GenoTEX 约定写入 output/preprocess、output/regress 和日志文件。它需要本地数据目录、Python 环境及至少一个模型提供商的 API 密钥;也可通过 Ollama 使用本地模型。
用户以 python main.py 启动实验,并通过 --version、--model、--api 和 --data-root 指定运行配置。系统读取 GenoTEX 输入数据,执行队列式的基因表达预处理与回归分析,并将预处理 cohort 数据写入 output/preprocess/{trait_name}/、将回归结果写入 output/regress/{trait_name}/。它支持为 Code Review、Domain Expert、Data Engineer、Statistician 和 planning 机制分别设置模型及 API 索引;--parallel-mode cohorts 可并发处理 cohort。--generate-action-units 会依据智能体 guidelines 生成 Action Unit 提示词,默认允许人工编辑后确认,配合 --non-interactive 时可无交互继续。运行日志保存为 ./output/log_{version}.txt,若中断,以相同命令重跑可利用检查点恢复。
- 计算基因组学研究人员需要对 GenoTEX 中的大量性状—条件组合执行一致的基因表达预处理和回归分析。
- 拥有 GEO 或 TCGA 转录组数据的生物信息团队希望在控制混杂因素时筛选与目标性状相关的显著基因。
- 研究工程师希望为代码审查、领域专家和统计任务分配不同模型,测试异构模型配置。
- 需要先验证 cohort 预处理质量、暂不运行完整统计分析的团队可使用 --quick-test 进行小规模测试。
- 受 API 速率限制约束但希望缩短墙钟时间的用户,可用 --parallel-mode cohorts 和有限的 --max-workers 并行处理。
如何安装或部署这个 Agent?
创建环境并安装依赖:
conda create -n genomas python=3.10
conda activate genomas
pip install -r requirements.txt复制配置模板并至少填写一个模型提供商的 API 密钥:
cp env.example .env使用 OpenAI 模型时还需要组织 ID。输入数据需另行下载到数据根目录;默认数据根目录为 ../data。
如何使用这个 Agent?
先检查已下载数据:
cd download
python validator.py --data-dir /path/to/data --validate随后从项目根目录运行一个基础实验:
python main.py --version exp1 --model gpt-5-mini-2025-08-07 --api 1如需指定数据位置,可追加 --data-root /path/to/data。小规模预处理验证可使用 --quick-test;本地 Ollama 模型可通过例如 --model llama3.1 运行。
这个 Agent 有哪些优点和局限?
- 同时提供通用多智能体工作流框架和面向 GEO、TCGA 转录组分析的专用实现。
- Notebook 式执行模型明确覆盖计划、代码生成、执行、调试和回溯,而非仅输出分析建议。
- 支持全局模型配置及按 Code Review、Domain Expert、Data Engineer、Statistician、planning 角色覆盖模型与 API 索引。
- 输出路径、运行日志和中断恢复机制均有明确约定,便于长时间批量实验排查与续跑。
- 完整 GenoTEX 基准需要约 42 GB 输入数据;README 估计全量运行需连续 3–5 天且成本超过 300 美元。
- 云端运行至少需要一个模型提供商 API 密钥;使用 OpenAI 模型还要求组织 ID,且并行度会受 API 速率限制影响。
- 本地运行大型模型存在显著 GPU 内存和延迟压力;DeepSeek-R1 671B 被说明为需要多张高端 GPU。
- 完整回归依赖相关数据集均已完成预处理,README 建议先用 --quick-test 验证预处理,因此快速端到端评估范围有限。
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| GenoMAS 当前 | 50 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 130 | 15 天前 | Python | OpenAI API · Claude API |
| GenoTEX 基因表达分析基准 | 54 · 缺口较多 | 命令行工具免费 | ★ 65 | 5 个月前 | Jupyter Notebook | — |
| BambooAI 数据分析师 | 70 · 存在缺口 | 网页应用免费 + 模型费 | ★ 842 | 今天 | Python | OpenAI API · Claude API |
| MiroFish Offline | 40 · 缺口较多 | 自托管服务免费 | ★ 2.7k | 7 个月前 | Python | OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
代码展示了多角色客户端、输入数据根目录、输出目录和日志路径,README说明需配置API密钥;但未充分说明发送给外部模型的数据范围、密钥保护方式或依赖风险,故最小权限、数据流、敏感数据与依赖安全仅部分满足。生成Action Units有交互确认,但非交互模式会自动采用生成内容;中断恢复会清理半成品输出,恢复边界说明有限。README列出论文作者及引用信息,支持来源归属。
README称支持检查点续跑并说明超时调整,提供了一些故障处理线索;但给出的主程序片段未展示检查点实现或统一错误处理,依赖未锁定版本,也没有其他文件佐证,故只给部分分。
README明确面向基因表达分析,并说明GEO、TCGA、不同模型、角色配置及并行队列场景;但框架通用性主要是描述,代码所示仍强绑定特定科学工作流,适用边界和触发条件不够精确。
README有清晰章节、安装步骤、多个用例、排错、资源成本与限制说明;MIT许可证文本完整。依赖清单未固定版本,未见变更日志;维护路径通过问题、PR及作者联系说明,但责任安排仍较概括。
文档描述预处理、回归结果、日志和检查点恢复等可用产物,也给出完整运行与小规模预处理示例。基准分数及发现价值属于README中的主张,当前材料没有独立佐证;完整运行耗时数天、费用超过300美元,虽提供小规模路径但成本仍明显。
README把部分主张指向论文、基准、输出文档和配置代码,并给出可复现的命令示例;但本材料没有论文或基准文件、测试材料及主要实现细节来交叉印证性能、恢复和科学发现主张。事实与作者主张之间的区分有限,因此未给高分。
- 运行前需准备约42 GB数据和外部模型API密钥;完整基准运行预计持续3至5天且花费超过300美元。
- 非交互模式会自动采用生成的Action Unit提示;运行前应审阅提示和输入数据,并谨慎处理可能包含敏感信息的数据。
- 性能、检查点恢复及科学发现结论在所给材料中没有独立交叉验证;依赖版本也未锁定。
常见问题
完整运行的时间和费用是多少?
必须使用云端 API 吗?
实验被中断后需要从头开始吗?
它分析哪些数据和产物?
谢谢反馈,我们会据此改进页面。