Denario 是面向科研的多智能体 AI 系统,基于 AG2 与 LangGraph 编排多个专用智能体,自动化从数据分析到可发表论文的科研工作流。适用场景包括:分析数据集以生成研究假设、构建结构化研究方法、执行计算实验并生成可视化、检索文献背景、将研究结果写成期刊格式的 LaTeX 论文,以及自动化完整科研流水线。
安装:推荐使用 uv,执行 uv init 后运行 uv add "denario[app]";或用 pip 执行 uv pip install "denario[app]"。Docker 部署或源码构建见 references/installation.md。
使用前需配置受支持 LLM 提供商的 API 密钥,支持 Google Vertex AI、OpenAI 及兼容 AG2/LangGraph 的其他服务,密钥应通过环境变量或 .env 文件安全存储,详见 references/llm_configuration.md。
核心流程分四阶段:1) 数据描述,用 Denario(project_dir="./my_research") 初始化并调用 set_data_description 说明数据集、工具与研究领域;2) 想法生成,调用 get_idea() 生成假设,或用 set_idea() 自定义;3) 方法开发,调用 get_method() 生成方法,或用 set_method() 传入 markdown;4) 结果生成,调用 get_results() 执行实验与可视化,或用 set_results() 提供预计算结果;5) 论文生成,调用 get_paper(journal=Journal.APS) 输出期刊格式 LaTeX 论文。
可用期刊格式包括 Journal.APS(美国物理学会格式),完整列表见 references/research_pipeline.md。运行 denario run 可启动基于 Web 的图形界面。
高级特性:多智能体编排、可复现的结构化输出、期刊格式化、各阶段支持手动或自动输入、Docker 部署(含 LaTeX 与依赖)。要求 Python 3.12 或更高版本。常见问题包括 API 密钥错误、LaTeX 编译需安装 TeX 发行版或使用 Docker 镜像、包冲突建议使用虚拟环境或 Docker。更多文档见 references/installation.md、references/llm_configuration.md、references/research_pipeline.md、references/examples.md。