Denario 安装指南

# 安装指南 ## 系统要求 - **Python**: 3.12 或更高版本（必需） - **操作系统**: Linux, macOS, 或 Windows - **虚拟环境**: 推荐用于环境隔离 - **LaTeX**: 论文生成必需（或使用 Docker） ## 安装方法 ### 方法 1：使用 uv（推荐） uv 包管理器提供快速、可靠的依赖解析： bash # 初始化新项目 uv init # 添加带有应用支持的 denario uv add "denario[app]" ### 方法 2：替代安装方式 使用 pip 进行替代安装： bash # 创建虚拟环境（推荐） python3 -m venv denario_env source denario_env/bin/activate # Windows 下: denario_envScriptsactivate # 安装 denario uv pip install "denario[app]" ### 方法 3：从源码构建 用于开发或自定义： bash # 克隆仓库 git clone https://github.com/AstroPilot-AI/Denario.git cd Denario # 创建虚拟环境 python3 -m venv Denario_env source Denario_env/bin/activate # 以可编辑模式安装 uv pip install -e . ### 方法 4：Docker 部署 Docker 提供了包含 LaTeX 在内的所有依赖的完整环境： bash # 拉取官方镜像 docker pull pablovd/denario:latest # 运行带有 GUI 的容器 docker run -p 8501:8501 --rm pablovd/denario:latest # 使用环境变量运行（用于 API 密钥） docker run -p 8501:8501 --env-file .env --rm pablovd/denario:latest 容器启动后，通过 `http://localhost:8501` 访问 GUI。 ## 验证安装 安装完成后，验证 denario 是否可用： python # 测试导入 python -c "from denario import Denario; print('Denario installed successfully')" 或检查版本： bash python -c "import denario; print(denario.__version__)" ## 启动应用 ### 命令行界面 运行图形用户界面： bash denario run 这将启动一个基于 Streamlit 的 Web 应用，用于交互式研究工作流管理。 ### 程序化使用 在 Python 脚本中直接使用 denario： python from denario import Denario den = Denario(project_dir="./my_project") # 继续执行工作流... ## 依赖项 Denario 会自动安装关键依赖： - **AG2**: 智能体编排框架 - **LangGraph**: 基于图的智能体工作流 - **pandas**: 数据处理 - **scikit-learn**: 机器学习工具 - **matplotlib/seaborn**: 可视化 - **streamlit**: