ResearchStudio

环境要求

• Python >= 3.10
• 已安装 conda 或 uv（二选一，用于创建隔离环境）
• 已安装 Claude Code 或 Codex（技能运行环境）
• 本地可访问 GitHub 以获取项目代码

安装与启动步骤

1. 1获取项目代码

   从 GitHub 克隆 ResearchStudio 仓库到本地，进入项目目录后再进行后续环境配置。

   git clone https://github.com/microsoft/ResearchStudio.git
   cd ResearchStudio

   复制

2. 2用 conda 建环境

   方式一：创建名为 researchstudio 的隔离环境并指定 Python 3.10 以上版本，-y 表示自动确认。

   conda create -n researchstudio "python>=3.10" -y

   复制

3. 3激活 conda 环境

   创建完成后必须激活环境，后续所有操作都在该环境中进行，避免污染系统 Python。

   conda activate researchstudio

   复制

4. 4用 uv 建环境

   方式二（替代 conda 方案）：用 uv 创建 Python 3.10 的虚拟环境，适合已使用 uv 的用户。

   uv venv --python 3.10

   复制

5. 5激活 uv 环境

   uv 创建的环境默认在 .venv 目录，用 source 激活后即可继续安装和使用。

   source .venv/bin/activate

   复制

如何确认成功

环境激活后运行 python --version，确认输出为 3.10 或更高版本，即表示隔离环境可用。

常见问题

注意事项

• README 仅给出环境创建说明，具体依赖安装与运行命令请以仓库最新文档为准。
• 命令中涉及 Windows 时激活方式可能不同，README 示例为 macOS/Linux 的 source 写法。
• 项目包含 Idea、Reel 等多个子模块，使用前请确认对应子目录中的说明。
• 项目处于成长阶段，接口与命令可能随版本更新变化，建议关注仓库 News。