PaperOrchestra 是一个用于自动化撰写 AI 研究论文的多智能体框架。在 Python 3.11 的 Conda 环境中,通过 git clone 获取源码、pip 安装依赖并配置 .env 文件即可完成安装,使用 python paper_writing_cli.py --help 命令验证环境可用性。
准备开发环境与拉取代码
官方安装说明使用 python 3.11。先创建独立 conda 环境,激活后再拉取项目代码。
conda create -n paper_orchestra python=3.11 conda activate paper_orchestra git clone https://github.com/google-research/paper-orchestra.git cd paper-orchestra
跑完上面几行命令,终端会显示环境切换成功的提示,当前路径也会跳到项目根目录,后面所有操作都得在这个路径下进行。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

安装项目依赖包
进到项目根目录之后,直接用pip安装requirements.txt里列出的所有依赖项,里面包含大模型调用客户端、PDF处理工具还有绘图相关的库。
pip install -r requirements.txt
等安装流程正常跑完,终端没弹出任何报错,就说明基础依赖都就绪了,框架的核心Python逻辑才能被正确加载。

配置环境变量与密钥
生成论文之前得在项目根目录配置你选用的大模型的凭据。查CLI帮助不需要密钥,默认的Gemini模型需要提前配置对应的API密钥或者Vertex AI的相关参数。
touch .env
编辑 .env 文件,至少添加一个模型服务商的密钥,参考示例如下:
OPENAI_API_KEY=your_openai_api_key # 或者使用 Google Vertex AI VERTEX_AI_PROJECT=your_project_id VERTEX_AI_LOCATION=your_location
存好配置之后在项目目录运行后续命令就行,检查配置的时候只确认参数有没有正常设置,不要把密钥明文输出出来。
验证安装是否成功
安装完成的判断标准很简单,就是命令行工具能正常识别参数。运行帮助命令,检查输出里有没有完整的参数列表,同时没有Traceback类的报错。
python paper_writing_cli.py --help
光跑出帮助信息只能说明参数入口正常,还得在当前环境先后运行python -m pip check,以及python -c "from methods.paper_writer import write_single_paper",确认论文写作相关的依赖都能正常导入。
排查常见启动故障
如果在运行--help或者实际跑生成任务的时候遇到报错,按下面的顺序一步步检查就行。
检查 pdflatex 与 bibtex 环境
PaperOrchestra 最终产出的是LaTeX格式文档,所以系统必须提前安装TeX编译器。在终端运行以下两行命令:
pdflatex --version bibtex --version
如果提示command not found,说明你还没安装TeX Live或者MacTeX。缺少编译器只会在论文生成阶段触发失败,刚装完验收CLI的时候一般不会阻塞启动。
处理网络与包导入错误
要是安装依赖的时候出现下载超时,直接换成国内清华镜像源即可:
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
如果运行的时候弹出ImportError导入错误,基本都是Conda环境没激活,或者虚拟环境路径冲突。先确认当前终端最前面的前缀是(paper_orchestra),再重试命令就行。
检查写作依赖的导入
CLI 的帮助入口没有加载全部写作模块。继续用下面的命令验证依赖;如果包已安装但仍无法导入,核对已装版本、模块名与当前 Python 路径。
python -m pip check
python -c "from methods.paper_writer import write_single_paper; print('writer import OK')"










