gqqi/edgesidekick

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