gqqi/edgesidekick

英文 |简体中文

EdgeSidekick——本地优先的多智能体AI工作台，专为你自己的机器打造

GitHub 页面 · 麻省理工学院许可

EdgeSidekick 是一个开源的本地多代理 AI 工作台。打开磁盘上的文件夹，在浏览器或桌面壳层聊天，让主代理和子代理搜索和编辑文件——需要人工批准、可随时加入的技能、记忆保存、MCP 工具和浏览器沙盒。

设计为分叉（清晰的Python + Vite图层）和低成本运行（上下文压缩、按需技能、独立主/子/压缩模型）。

Windows ·macOS ·Linux ·默认API http://127.0.0.1:8787

截图

更多产品页面和双语营销网站都位于网站/下。

快速开始

要求：

• Python 3.10+
• Node.js 18+（界面/桌面构建）
• 可选：Playwright Chromium 用于浏览器沙盒/代理浏览器工具

运行API + Web UI

Windows （PowerShell）

或者双击start.bat。

macOS / Linux

打开 http://127.0.0.1:8787 →选择一个工作区文件夹→设置→模型→ API 密钥。

无API密钥的离线演示

剧本/mock_llm。

English | 简体中文

EdgeSidekick — local-first multi-agent AI workbench for your own machine

GitHub Pages · MIT License

EdgeSidekick is an open-source local multi-agent AI workbench. Open a folder on your disk, chat in the browser or desktop shell, and let a main agent plus sub-agents search and edit files — with human approval, drop-in Skills, Memory that sticks, MCP tools, and a browser sandbox.

Built to be forked (clear Python + Vite layers) and cheap to run (context compression, on-demand Skills, separate main / sub / compress models).

Windows · macOS · Linux · default API http://127.0.0.1:8787

Screenshots

More product pages and the bilingual marketing site live under website/.

Quick start

Requirements:

• Python 3.10+
• Node.js 18+ (UI / desktop build)
• Optional: Playwright Chromium for the browser sandbox / agent browser tools

Run the API + web UI

Windows (PowerShell)

cd path\to\Sidekick
python -m pip install -r requirements.txt
python main.py

Or double-click start.bat.

macOS / Linux

cd /path/to/Sidekick
python3 -m pip install -r requirements.txt
python3 main.py

Open http://127.0.0.1:8787 → pick a workspace folder → Settings → Model → API key.

Offline demo without an API key

scripts/mock_llm.py is an OpenAI-compatible offline demo model that understands the Social-mode planner and member prompts, so you can try the full group collaboration flow without a key (for real use, configure your own model in Settings → Model):

python scripts/mock_llm.py --port 18931
SIDEKICK_DATA_DIR=/tmp/sidekick-demo META_PORT=18787 \
OPENAI_API_KEY=mock OPENAI_BASE_URL=http://127.0.0.1:18931/v1 OPENAI_MODEL=mock-team \
python main.py

Then open http://127.0.0.1:18787. After changing the UI, rebuild it with cd ui && npm install && npm run build.

If you save a model in Settings → Model, that account uses it instead of the environment variables. Leaving its API key empty switches to Demo mode, where every member only replies “【Demo 模式】…”; when pointing at the mock model, any key (e.g. mock) works.

Tests