Windows-Copilot-API

环境要求

• Python 3 环境与 pip
• 可联网的浏览器环境（Playwright 首次下载 Chromium）
• 一个可正常登录的 Microsoft 或 Google 账号
• 可选：已安装 Docker 与 Docker Compose（仅容器方式需要）

安装与启动步骤

1. 1获取项目代码

   克隆仓库并进入项目根目录，后续命令都在该目录执行。

   git clone https://github.com/sums001/Windows-Copilot-API.git
   cd Windows-Copilot-API

   复制

2. 2安装 Python 依赖

   按 README 提供的依赖清单安装，建议先建虚拟环境避免污染全局。

   pip install -r requirements.txt

   复制

3. 3安装浏览器内核

   Playwright 需要 Chromium 才能完成登录流程，只需执行一次。

   playwright install chromium

   复制

4. 4登录账号保存会话

   会弹出可见浏览器窗口，用微软或 Google 账号登录，会话保存到 session/ 目录并自动续期。

   python -m copilot login

   复制

5. 5启动本地 API 服务

   启动后提供 OpenAI 兼容接口，可直接用 openai SDK 或兼容应用对接。

   python app.py

   复制

6. 6可选：Docker 运行

   需先在宿主机完成登录生成 session/，容器挂载该目录后启动服务。

   docker compose up --build

   复制

7. 7Python 库方式调用

   不启服务时可直接用库调用，构造客户端时会自动加载已登录的会话。

   python -c "from copilot import CopilotClient; client = CopilotClient(); print(client.chat('Hi'))"

   复制

关键配置

如何确认成功

服务启动后，用 openai SDK 把 base_url 指向 http://localhost:8000/v1 调用 /v1/chat/completions，能返回对话内容即成功。

常见问题

注意事项

• 这是非官方项目，与微软无隶属关系，请遵守微软服务条款并仅用于个人合理用途。
• 服务默认监听本机地址，不要直接暴露到公网，以免会话被他人滥用。
• README 未给出端口、模型名清单等细节，可在启动后查看服务输出或项目文档确认。
• Docker 方式属于可选路径，本地 pip 安装已能满足大部分使用场景。