Denario 是 AstroPilot-AI 开发的多智能体科研辅助系统，用 AG2 和 LangGraph 实现智能体，以 cmbagent 为研究分析后端，覆盖假设生成、方法开发、计算分析到论文写作的完整流程。
用途与适用场景：适合分析数据集以生成新研究假设、构建研究方法、执行计算实验与可视化、做文献检索、将研究结果写成期刊格式的 LaTeX 论文，或自动化从数据到发表的完整研究管线。若只需带引用的文献综述或事实核查（无数据集可分析），或需要协调研究→写作→评审→修订、自己撰写或修改论文、基于表格数据集做 LLM 假设生成（HypoGeniC）、市场或行业报告，则应分别使用 alterlab-deep-research、alterlab-research-pipeline、alterlab-paper-writer、alterlab-hypogenic、alterlab-market-research。
安装：推荐 uv：uv init 后执行 uv add "denario[app]"（加引号避免 zsh 通配 [app]）。[app] extra 会拉入 Streamlit 图形界面 DenarioApp，若用于无头或库调用可省略。Docker 部署或源码构建见 references/installation.md。
配置：初始化时通过 KeyManager 从环境变量读取密钥，OPENAI_API_KEY 为必需（分析/结果模块需要），GOOGLE_API_KEY（普通 Gemini 密钥，非 Vertex AI 服务账号 JSON）在选用 Gemini 时必需，ANTHROPIC_API_KEY 与 PERPLEXITY_API_KEY 为可选（后者仅用于引文搜索）。可在 shell 或工作目录 .env 中设置。
模型 ID：denario 1.0.1 的硬编码默认模型已被供应商退役，建议每次调用显式传参。mode="fast" 默认 gemini-2.0-flash 已停用；cmbagent 默认使用 o3-mini 等，需覆盖 idea_hater_model、plan_reviewer_model、formatter_model、researcher_model；不要选用已退役的 gpt-4.5。字符串模型名必须是 denario.models 的键（如 gpt-4.1、gpt-5、gemini-2.5-flash），其他供应商模型需传 LLM 对象。
核心工作流：set_data_description 描述数据与工具；get_idea 生成假设（或用 set_idea 自定义），mode 可选 fast 或 cmbagent；get_method 生成方法（或用 set_method 传入 markdown）；get_results 执行实验并生成结果；get_paper 生成 LaTeX 论文，journal 可选 NONE、AAS、APS、ICML、JHEP、NeurIPS、PASJ。用 den.check_idea(mode="semantic_scholar") 或 futurehouse 做新颖性检查。运行 denario run 启动 Web 图形界面。
限制：输出为端到端 AI 生成，其观点、代码、结果与引用都应视为草稿，须由研究者核实并在论文中披露 AI 协助。denario 1.0.x 需要 Python 3.12 或 3.13（>=3.12,<3.14）。LaTeX 编译需安装 TeX 发行版或用预装 LaTeX 的 Docker 镜像。厂商模型 ID 会持续变动，长任务前应查看供应商模型列表。更多细节见 references/installation.md、llm_configuration.md、research_pipeline.md、examples.md。