MathModelAgent的.env环境变量配置全解：DEV/PROD环境与Redis URL设置

MathModelAgent的.env环境变量配置全解DEV/PROD环境与Redis URL设置【免费下载链接】MathModelAgent专为数学建模设计的 Agent skills ,自动完成数学建模生成一份完整的可以直接提交的论文。 An Agent Designed for Mathematical Modeling ,Automatically complete mathmodel and generate a complete paper ready for submission.项目地址: https://gitcode.com/GitHub_Trending/ma/MathModelAgentMathModelAgent 是一个专为数学建模设计的多智能体Agent系统可自动完成问题分析、数学建模、编码求解与论文撰写最终生成一份可直接提交的完整论文。想要跑起来这个项目最关键的一步就是配置后端的.env 环境变量文件其中ENV变量决定加载dev还是prod环境的配置文件REDIS_URL则决定系统能否连上 Redis 消息服务。本文用最短路径带你完成 MathModelAgent 的 .env 配置避开新手最容易踩的坑。一、MathModelAgent 有哪几类 .env 文件MathModelAgent 采用前后端分离 按环境区分配置文件的组织方式仓库中会用到以下三类文件文件所在位置作用.env.examplebackend/后端配置模板带详细中文注释不会被直接使用.env.dev/.env.prodbackend/实际生效的后端配置dev对应开发环境prod对应生产环境.env.developmentfrontend/前端环境变量配置后端接口地址 注意仓库里只提供.env.example模板你需要自己复制一份改名为.env.dev来填写真实配置这是新手最常困惑的一点。二、ENV 变量如何切换 dev / prod 双环境环境变量ENV是整个配置体系的总开关。它的加载逻辑在 backend/app/config/setting.py 中实现后端启动时读取ENV的值默认dev系统据此动态拼接出配置文件名.env.{ENV}例如ENVprod时加载.env.prod如果只准备了一份开发配置直接把模板复制为.env.dev即可无需设置ENV默认就走dev分支。两种常见的设置方式手动启动本地开发在启动 uvicorn 之前先导出变量例如export ENVDEVmacOS/Linux或$env:ENVDEVWindows PowerShell官方步骤详见 README.md。Docker Compose 启动无需手动设置docker-compose.yml 已为 backend 服务显式声明了ENVDEV并自动挂载./backend/.env.dev作为环境变量文件env_file: - ./backend/.env.dev # 从此文件加载环境变量 environment: - ENVDEV # 为后端显式设置 ENV建议的分工dev用于日常调试DEBUGtrue、日志级别DEBUGprod用于正式部署关闭调试、日志级别调高、填入正式 API Key。三、Redis URL 设置本地开发与 Docker 环境的区别Redis 在 MathModelAgent 中承担消息发布/订阅与任务状态管理的角色——四个 Agent 之间的实时消息就是经它转发给前端页面的实现代码见 backend/app/services/redis_manager.py。因此REDIS_URL配错会导致系统直接无法启动这是配置中优先级最高的一项。不同部署方式对应不同的正确地址模板中也有对应注释见 backend/.env.example部署方式REDIS_URL 正确写法原因本地手动启动redis-serverredis://localhost:6379/0Redis 跑在你自己的机器上Docker Compose 启动redis://redis:6379/0容器间要用服务名redis作为主机名不能用 localhost⚠️ 最常见的报错是无法连接到 Redis用 Docker 部署却写了localhost或本地启动却写了redis主机名。改完后务必重启后端服务才生效。连接池大小由REDIS_MAX_CONNECTIONS控制默认 10一般无需修改。四、常用配置项速查清单.env.dev里的配置项分为核心项与可选项完整注释版模板见 backend/.env.example 核心必填四个 Agent 各自独立配置配置项说明{AGENT}_API_TYPEAPI 类型openai-chat/openai-responses/anthropic{AGENT}_API_KEY模型服务的 API 密钥必填{AGENT}_MODEL模型名称如deepseek-chat、gpt-4o-mini{AGENT}_BASE_URL模型服务的 API 地址{AGENT}_MAX_TOKENS最大输出 token 数默认 8192其中{AGENT}替换为COORDINATOR协调器、MODELER建模手、CODER代码手、WRITER论文手四个前缀每个 Agent 均可指定不同的模型实现不同角色不同脑。⚙️ 系统配置有默认值可按需调整LOG_LEVEL日志级别DEBUG/INFO/WARN/ERRORDEBUG调试开关开发环境true生产建议falseMAX_RETRIESAPI 调用失败重试次数默认 3CORS_ALLOW_ORIGINS允许访问后端的域名逗号分隔多个SERVER_HOST后端服务地址默认http://localhost:8000 可选服务不配置不影响核心建模流程E2B_API_KEY云代码沙箱不配置则使用本地解释器执行代码TAVILY_API_KEYSEARCH_ENABLEDtrue启用 Web 联网搜索OPENALEX_EMAIL/OPENALEX_API_KEY学术文献检索RAG_ENABLED等本地知识库检索增强HIL_ENABLED人机协作审批关键节点问题拆分、模型选择、论文审查人工确认五、前端 .env.development两个变量就够了前端配置非常轻量见 frontend/.env.developmentVITE_API_BASE_URLhttp://localhost:8000 VITE_WS_URLws://localhost:8000它只负责告诉浏览器后端在哪。当后端换端口或部署到远程服务器时同步修改这两个值即可Vite 项目修改环境变量后必须重启前端开发服务器才会生效。六、配置完成后的三个高频故障排查改了配置没反应所有 .env 修改都需要重启后端uvicorn/前端pnpm dev服务不会热更新。启动报 Redis 连接错误确认redis-server已启动或 Redis 容器正在运行再核对第三节表格中REDIS_URL的主机名写法。页面提示跨域 / CORS 错误把前端实际访问地址如http://localhost:5173追加进CORS_ALLOW_ORIGINS逗号分隔。按本文完成配置后MathModelAgent 即可正常启动上传赛题资料协调器、建模手、代码手、论文手四个 Agent 便会接力工作最终产出一篇可直接提交的数学建模论文。相关源码与配置路径后端配置模板backend/.env.example环境加载逻辑backend/app/config/setting.pyRedis 连接管理backend/app/services/redis_manager.pyDocker Compose 环境编排docker-compose.yml前端环境变量frontend/.env.development部署教程docs/md/tutorial.md【免费下载链接】MathModelAgent专为数学建模设计的 Agent skills ,自动完成数学建模生成一份完整的可以直接提交的论文。 An Agent Designed for Mathematical Modeling ,Automatically complete mathmodel and generate a complete paper ready for submission.项目地址: https://gitcode.com/GitHub_Trending/ma/MathModelAgent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考