Data-Copilot

环境要求

• Python 3.8–3.10（README 在 3.9 与 3.10 上测试过）
• Conda（README 使用 conda 创建虚拟环境）
• 能访问 GitHub 与 pip 源
• 网页演示需要一个 OpenAI（或 Azure-OpenAI）API Key

安装与启动步骤

1. 1克隆仓库

   把 Data-Copilot 源码下载到本地，并进入项目目录，后续命令都在该目录执行。

   git clone https://github.com/ZJU-OmniAI/Data-Copilot.git
   cd Data-Copilot

   复制

2. 2创建 conda 环境

   用 Python 3.10 新建名为 data-copilot 的虚拟环境并激活，避免污染系统环境。

   conda create -n data-copilot python=3.10 -y
   conda activate data-copilot

   复制

3. 3安装依赖

   按 requirements.txt 一次性安装项目所需的 Python 包，网络慢时可换国内 pip 源。

   pip install -r requirements.txt

   复制

4. 4命令行试跑

   运行 main.py，它会回答文件末尾内置的示例请求；换问题需编辑文件里的 instruction。

   python main.py

   复制

5. 5切换模型

   在 main.py 中把 model 改为 "gpt" 或 "qwen-chat-72b"；模型版本名写在 lab_gpt4_call.py 和 lab_llms_call.py 中。

6. 6启动网页演示

   运行 app.py 启动本地 Web 界面，随后在浏览器访问 127.0.0.1:7860。

   python app.py

   复制

7. 7填入密钥并提问

   在页面输入 OpenAI Key 点 OK；Azure 用户改填 key、API base 和部署名，再输入需求点 Start。

关键配置

如何确认成功

浏览器打开 http://127.0.0.1:7860 能看到界面，点 Start 后 Solving Step 显示中间流程，并输出摘要、图表和表格。

常见问题

注意事项

• Python 版本必须控制在 3.8–3.10，过新版本 README 未验证。
• 项目未提供环境变量配置说明，密钥是在网页界面中手动输入。
• 修改 instruction 或 model 需要直接编辑源码文件，改完重新运行。
• 项目处于成长阶段，README 未给出完整配置说明，遇到问题以仓库最新文档为准。