安装 Edge Studio
常规本地开发先创建并激活 Python 3.11 环境，再从 Python 软件包安装 Edge Studio：
python3.11 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install edge-studio
edge doctor
如果你使用 uv：
uv venv --python 3.11 .venv
source .venv/bin/activate
uv pip install edge-studio
edge doctor
参与 Edge Studio 开发或测试本地 checkout 时，再使用源码安装路径。
要求
| 要求 | 版本 |
|---|---|
| macOS | 14 或更高 |
| 硬件 | Apple Silicon |
| Python | 推荐 3.11 |
| Node.js | 只有构建或开发 Web UI 时需要 |
从源码安装
git clone https://github.com/AtomGradient/edge-studio.git
cd edge-studio
python3.11 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e .
edge doctor
使用 edge 检查模型就绪状态、写入模型下载回执，并运行本地学习演示：
edge models where qwen3.5-9b-4bit --json
edge models fetch qwen3.5-9b-4bit --source auto
edge demo chat --model qwen3.5-9b-4bit --interactive
edge models fetch --source auto 可以在 ModelScope、Hugging Face 或 HF 镜像中选择当前可用的预览下载路径。下载行为是显式的，并会写入下载回执。
看到 [chat:ready] 后，可以连续问几个普通问题，并用 /exit 退出。第一次加载 9B 模型可能需要几十秒。
基础对话跑通后，继续看 CLI 学习演示，检查合成纠错样本，并对比基础回答和 Neural Imprint 恢复后的回答哈希。
启动 Web UI
安装后的软件包只暴露一个 edge 命令。用下面的命令启动本地 Studio UI 和 API server：
edge studio
打开：
http://127.0.0.1:18842
服务默认只运行在本机地址。用 Ctrl+C 停止。
从源码进行前端开发时，单独运行 Vite，并保持后端服务运行：
npm --prefix frontend ci
npm --prefix frontend run dev
edge studio
本地构建 wheel
需要验证已发布软件包形态时，运行发布打包脚本：
./scripts/build_wheel.sh
该脚本会构建前端、打包后端资源，并把 wheel 写入 dist/。