Skip to main content

AlphaScholar — 多智能体文献调研系统

License Python LLM

AlphaScholar 是一个基于大语言模型(LLM)的多智能体文献调研助手。它能够自动分析你的研究方向,在多个学术数据库(PubMed、arXiv、Semantic Scholar)中执行高级检索,随后通过“分析师-作家-审稿人”的协作流水线生成并反复打磨高质量的文献综述报告。


核心特性

  • 🔍 多源智能检索自动为 PubMed、arXiv、Semantic Scholar 生成最合适的检索式(如 PubMed 高级语法 [tiab]),克服不同数据库的检索差异。
  • 🧠 多智能体协作内置检索员、分析师、作家、审稿人四个专职 Agent,各司其职,通过反馈循环不断优化报告质量。
  • 🛠️ 可扩展工具系统使用 Python 装饰器 @tool 即可将任意函数转换为 OpenAI Function Calling 工具,自动生成 Schema,零样板代码。
  • 📝 自动评审与迭代审稿人 Agent 依据文献数量、结构完整性、语言质量等标准进行评分,不达标时自动将修改意见反馈给作家重写,直到质量达标。
  • 💾 长期记忆检索到的文献和生成的报告会自动存入 JSON 文件,下次调研时可注入历史记忆,避免重复劳动。
  • 🌊 流式输出报告撰写过程支持流式输出,像 ChatGPT 一样逐字显示,交互体验流畅。
  • 🔌 兼容多种 LLM 默认支持 OpenAI、DeepSeek 等兼容接口,只需配置 base_url 和 API Key 即可切换模型。

整体架构

┌──────────┐     ┌──────────┐     ┌──────────┐     ┌──────────┐
│ Retriever │────▶│  Analyst │────▶│  Writer  │────▶│ Reviewer │
│  (检索员) │     │  (分析师) │     │  (作家)  │     │  (审稿人) │
└──────────┘     └──────────┘     └──────────┘     └──────────┘
      │                                                  │
      │              ┌──────────────────┐                │
      └─────────────▶│   Tools (工具层)  │◀───────────────┘
                     │  PubMed, arXiv,   │
                     │  Semantic Scholar │
                     └──────────────────┘
  1. Retriever – 解析用户问题,构建检索式,调用学术数据库 API,返回原始文献列表。
  2. Analyst – 去重、筛选、分类文献,输出结构化的文献数据集。
  3. Writer – 根据分类数据撰写 Markdown 格式的综述报告。
  4. Reviewer – 评估报告质量(评分 + 问题 + 建议),若不达标则驱动下一轮“检索 → 分析 → 写作”循环。

快速开始

1. 克隆仓库

git clone https://github.com/yourname/AlphaScholar.git
cd AlphaScholar

2. 安装依赖

pip install -r requirements.txt

主要依赖:openai, pymed, arxiv, requests。

3. 配置环境变量

复制环境变量模板并填写你的 API Key 和邮箱(用于 PubMed):

cp .env.example .env

.env.example 示例:

OPENAI_API_KEY=your_openai_key
DEEPSEEK_API_KEY=your_deepseek_key
EMAIL=your_email@example.com
OPENAI_BASE_URL=https://api.openai.com/v1    # 或你的代理地址

4. 运行

python alpha_scholar.py --help

python .\src\AlphaScholar\alpha_scholar.py --agent two --platform cau --report_path ./reports/vae_with_microbiome_twoagent_cau_log.md --log_path ./logs/training_data.json

按提示输入研究方向(例如 vae 在微生物组学中的应用),AlphaScholar 将自动完成检索、分析、写作、评审,并流式输出最终报告。


使用示例

👋 欢迎使用 AlphaScholar 多Agent 版本!

请输入研究方向(或 'exit' 结束): Transformer在时间序列预测中的应用
👋 研究主题为:Transformer在时间序列预测中的应用

🔍 检索员工作中...
📊 分析师工作中...
✍️ 第 1 次撰写报告...
🔎 审稿人评审中...
📊 当前评分: 8/10
✅ 报告质量达标,输出最终结果。

## Transformer在时间序列预测中的应用:文献综述
...

自定义工具

你可以轻松扩展自己的工具,只需使用 @tool 装饰器并遵循规范的 docstring 格式:

@tool
def my_new_tool(param1: str, param2: int = 10) -> str:
    """
    工具的简要描述。
    Args:
        param1: str; 参数1的描述
        param2: int = 10; 参数2的描述
    Returns:
        str; 返回值的描述
    Example:
        my_new_tool("hello", 5)
    """
    # 实现逻辑
    return "done"

工具会自动注册到全局工具集,并被 Agent 调用。


项目结构

AlphaScholar/
├── agent.py             # 单 Agent 和多 Agent 流程(TwoAgent, MultiAgent)
├── llms.py              # LLM 配置与客户端工厂
├── tools.py             # 工具定义与装饰器(PubMed, arXiv, Semantic Scholar 等)
├── prompts.py           # 系统提示词(Retriever, Analyst, Writer, Reviewer)
├── memory.py            # 短期/长期记忆管理
├── utils.py             # 辅助函数(流式输出、日志等)
├── alpha_scholar.py              # 主入口
├── requirements.txt     # 依赖列表
└── .env.example         # 环境变量模板

路线图

  • 多源文献检索(PubMed, arXiv, Semantic Scholar)
  • 多智能体协作流水线
  • 自动评审与迭代优化
  • 长期记忆(JSON 存储)
  • 流式输出
  • 全文下载与解析(PDF, DOCX)
  • 参考文献格式化(BibTeX, APA)
  • Web 界面(基于 Flet)
  • MCP 工具服务器支持
  • 更多学术数据库(Google Scholar, Web of Science)

贡献

欢迎提交 Issue 和 Pull Request!在贡献之前请阅读我们的 贡献指南(如有)。


许可证

本项目基于 Apache License 2.0 开源。


AlphaScholar — 让你的文献综述,由智能体代劳。

Metadata

Release files for AlphaScholar 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for AlphaScholar 0.1.0
File Size Uploaded Provenance Actions
alphascholar-0.1.0.tar.gz 27.3 kB Without provenance Details for alphascholar-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for AlphaScholar 0.1.0
File Interpreter ABI Platform Actions
alphascholar-0.1.0-py3-none-any.whl Python 3 none any Details for alphascholar-0.1.0-py3-none-any.whl

Total release size: 54.6 kB

Release files / alphascholar-0.1.0.tar.gz

Download URL alphascholar-0.1.0.tar.gz
Size 27.3 kB
Tags Source
SHA-256 checksum
How to use checksums
0e8bb79c6dab3f6c21512ccdb8bc211bebc23e57ecbea5b6c8a8d576992d0ab3
BLAKE2b-256 checksum
How to use checksums
6284fb2ad4c9542b10fc25263803bcf4890e6d1ca91e2964383a3ead78ede8e4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.19 {"installer":{"name":"uv","version":"0.11.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / alphascholar-0.1.0-py3-none-any.whl

Download URL alphascholar-0.1.0-py3-none-any.whl
Size 27.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ed309acf83d48f2909d2e87adb2ea055305b677c74da3ec06fee48bdf40acc82
BLAKE2b-256 checksum
How to use checksums
6a8c15ace1db5d8509040c1a910deb5ef1f424751177ffd85feed3e4d46fb621
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.19 {"installer":{"name":"uv","version":"0.11.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for AlphaScholar 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page