InternAgent 科研发现框架
面向长周期科研的自主框架,串联假设生成、实验执行与文献驱动问答。
- Star 数
- ★ 1.5k
- 最近更新
- 3 个月前
- License
- NOASSERTION
- 主语言
- Python
- FA 评分
- 27/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Claude Code · OpenAI API · Claude API
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 研究人员想先验证本地环境时,可运行无需下载数据集或模型的 AutoDebug 任务。
- 不适合
- 需要开箱即用、无需配置 API 密钥和 Conda 环境的团队
- 希望以托管服务或容器镜像方式部署、而非本地运行的用户
- 需要明确开源许可证条款才能合规使用的团队
这个 Agent 能做什么,适合哪些场景?
InternAgent-1.5 是一个通过本地命令行运行的自主科学研究框架,覆盖发现实验与深度研究问答两种模式。发现模式可围绕 tasks/ 中的算法发现任务执行从创意生成到实验的流程;每个任务可包含 prompt.json、基线 code/ 与 launcher.sh。sci_tasks 模式面向论文复现:系统接收已发表论文及其数据,并尝试自主复现关键发现。QA 模式由深度研究管线处理研究问题,分解子任务、并行检索学术数据库和网页,再生成综合答案或结构化报告。运行结果写入 results/,日志写入 logs/;框架以本地 Python 环境、配置文件和外部模型服务凭据为部署边界。
通过 launch.py 选择 discovery 或 qa 模式:discovery 模式可运行 AutoDebug 等任务,也可使用 --skip_idea_generation 与 --idea_path 从既有 ideas.json 直接开始实验;qa 模式由 launch_qa.py 接收 --question,并可用 -o 将答案保存为 Markdown 文件。任务定义位于 tasks/,其中包含任务提示、基线代码和启动脚本。论文复现任务位于 sci_tasks/tasks/,并以论文及其数据为输入。Deep Research 模块将问题拆分为子任务,分别从学术数据库和网页收集资料后合成答案或报告;持久化 Memory Module 会跨会话记录实验结果,用于回避已失败方向并延续成功方向。模型连接通过 .env 与 config/ 配置,包括 OpenAI 兼容端点、OpenRouter,以及用于 Claude 实验后端的 Anthropic 凭据。
- 研究人员想先验证本地环境时,可运行无需下载数据集或模型的 AutoDebug 任务。
- 算法研究团队需要在 tasks/ 中已有任务、基线代码和任务提示的基础上开展自动化方案探索时,可运行 discovery 模式。
- 需要从已有 ideas.json 开始执行实验、而不重新生成创意的用户,可使用 --skip_idea_generation 和 --idea_path。
- 希望根据一篇已发表论文及配套数据自主尝试复现关键结论的科研人员,可使用 sci_tasks/tasks/ 中的论文复现任务。
- 需要针对“memory-augmented LLMs 的近期进展”等研究问题生成文献综合答案的用户,可使用 QA 模式。
如何安装或部署这个 Agent?
创建并启用环境后安装依赖:
conda create -n InternAgent python=3.11
conda activate InternAgent
pip install -r requirements.txt然后创建配置文件:
mv .env.example .env在 .env 中按所选后端填写凭据。OPENAI_API_KEY 和 OPENAI_API_BASE_URL 用于 OpenAI 或兼容端点的嵌入与记忆;使用 OpenRouter 时填写 OPENROUTER_API_KEY 并采用 config/openrouter_config.yaml;使用 Claude 实验后端时填写 ANTHROPIC_API_KEY。
如何使用这个 Agent?
首次验证可运行:
python launch_discovery.py --config ./config/default_config.yaml --task AutoDebug --exp_backend claudecode统一入口也支持:
python launch.py --mode discovery --task AutoDebug --exp_backend claudecode
python launch.py --mode qa --question "What are recent advances in memory-augmented LLMs?"如需保存 QA 输出:
python launch_qa.py -q "What are recent advances in memory-augmented LLMs?" -o answer.md主配置从 config/default_config.yaml 开始;结果和日志分别位于 results/ 与 logs/。
这个 Agent 有哪些优点和局限?
- 通过 launch.py 在同一框架中提供发现实验与深度研究问答两种明确的运行模式。
- 持久化 Memory Module 会跨会话保留实验结果,设计目标是减少重复尝试已失败方向。
- 同时覆盖算法发现任务与基于论文和数据的科学论文复现任务,而不是只提供问答流程。
- 提供 OpenAI 兼容端点、OpenRouter 和 Claude 实验后端的已文档化配置路径。
- 运行依赖本地 Conda、Python 3.11、命令行和外部 API 凭据;深度研究还会访问学术数据库和网页。
- 不同任务的数据集和环境设置并不统一,需要逐个查看 tasks/ 内对应任务的代码和配置。
- 已提供的材料未说明容器镜像、托管服务、稳定的程序化服务 API 或集群部署方案。
- 许可元数据为 NOASSERTION,采用前需要自行确认可用的许可条款。
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| InternAgent 科研发现框架 当前 | 27 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 1.5k | 3 个月前 | Python | Claude Code · OpenAI API · Claude API |
| Principia | 66 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 1.1k | 1 个月前 | Rich Text Format | — |
| Deep Researcher Agent | 52 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 1.1k | 5 个月前 | Python | Claude Code · OpenAI API · Claude API |
| XScientist | 61 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 127 | 5 天前 | Python | OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
证据显示:仓库未提供权限管理、用户确认、数据流透明性、敏感数据处理、依赖安全、外部影响、回滚或来源归属的说明。README仅提及API密钥配置,但未说明最小权限原则或用户确认机制。依赖列表庞大且未提供安全审计。因此所有信任标准得分为0。
证据显示:README和代码示例在任务描述上基本一致,但未提供错误处理或失败消息的文档。依赖列表完整但未验证可用性。因此自一致性得1分,依赖可用性得1分,失败消息得0分。
证据显示:README明确了目标受众(科研人员)和多种使用场景(算法发现、论文复现、深度研究),但能力边界描述模糊,触发条件(如任务类型)未详细说明,环境适配仅提及Python 3.11和API密钥。因此受众和场景得2分,能力边界得1分,触发精度得1分,环境适配得1分。
证据显示:README结构清晰,包含安装、配置、运行示例,但缺少已知限制、版本变更日志和维护责任说明。许可证为Apache 2.0,但元数据为NOASSERTION。因此信息架构得2分,安装说明得2分,命名稳定性得1分,示例和FAQ得2分,已知限制得0分,许可证得2分,版本变更日志得1分,维护责任得1分。
证据显示:README描述了输出(答案、报告)和多种任务,但未提供成本效益分析或性能基准。因此输出可用性得1分,边际价值得2分,成本效益得1分。
证据显示:README引用了论文和基准,但未提供可复现的验证步骤或事实与推断的区分。因此声明可追溯性得1分,跨来源佐证得1分,事实推断分离得0分。
- 源码中未见:最小权限约束只授予完成任务所需的权限:用专用账号或只读令牌,并限定可访问的目录和仓库。
- 源码中未见:执行前用户确认开启或自行加上执行前确认;先在沙箱或测试环境跑通,确认行为后再接入真实数据。
- 源码中未见:数据流向说明运行时观察它连接了哪些外部服务(代理或防火墙日志);弄清数据去向之前不要输入敏感数据。
- 源码中未见:敏感信息处理使用专用、低权限、可随时吊销的 API 密钥,不要复用生产凭据,也不要让密钥出现在日志里。
- 源码中未见:依赖安全审查安装前固定版本并做一次依赖扫描(如 npm audit、pip-audit);优先放在容器里运行。
- 源码中未见:外部影响披露先弄清它会写入、发送或修改哪些外部系统,用测试账号或测试仓库验证后再接入正式环境。
- 源码中未见:回滚或恢复路径运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
- 源码中未见:来源归属可核验从官方仓库或包源安装,核对发布者和仓库地址,避免同名仿冒包。
- 仓库未提供权限管理、用户确认或数据流透明性文档,存在安全风险。
- 依赖列表庞大且未提供安全审计,可能引入已知漏洞。
- 缺少已知限制和版本变更日志,用户难以评估适用性。