You will:
- Install
- Check health
- Start services
- (Optional) ping your desktop from your phone on the same Wi‑Fi
If something breaks, jump to If something fails at the bottom.
Copy this block (Linux / macOS):
git clone https://github.com/rudi193-cmd/willow-2.0
cd willow-2.0
bash setup.sh --publicAgents without willow-config: read root ../willow.md or docs/CONTRACT.md for the public contract. Private operator context lives in willow-config — see docs/WILLOW_CONFIG.md.
Fleet operators: clone willow-config to ~/github/.willow, then run bash setup.sh so runtime config points at the private home while root willow.md stays public-safe.
Pre-commit hooks (ruff + path guard; mypy report on pre-push) — installed automatically by setup.sh. To reinstall:
source .venv-dev/bin/activate
pre-commit install
pre-commit install --hook-type pre-push(setup.sh already installs editable willow + dev tools into .venv-dev.)
Use bash setup.sh without --public when private willow-config is present at ~/github/.willow. Manual lower-level path: python3 -m venv .venv-dev, pip install -r requirements.txt, pip install -e . --no-deps, pip install -r requirements-dev.txt, then python3 seed.py.
What you should see: setup steps scrolling, then your shell prompt back. No panic unless it stops with an error.
Default database name is willow_20. If you still have willow_19 from an old install, see CODE_DIFF_1.9_to_2.0.md.
./willow.sh fleet_status
./willow.sh statusGood: JSON or lines with [✓] on postgres, ollama, manifests.
Bad: degraded, not_connected, or a traceback — stop and fix before step 2.
./willow.sh startLeave that terminal open if it streams logs. Open a second terminal for the next steps.
./willow.sh serveNote the listening port (usually 7777) and ~/.willow/grove_token.
pkg install python git
git clone https://github.com/rudi193-cmd/willow-2.0
cd willow-2.0
python3 seed.py --termux --skip-pgCopy the desktop token:
echo "TOKEN" > ~/.willow/grove_token && chmod 600 ~/.willow/grove_tokenAsk the desktop for status (replace IP):
bash ~/willow-2.0/willow.sh grove send 192.168.x.x:7777 status-allGood: your desktop’s status printed on the phone.
Prefer the installer:
./willow.sh agents active <agent>
./willow.sh agents install <agent> --ide <cursor|claude|codex>
./willow.sh agents check --ide <cursor|claude|codex>This writes MCP config for sap/unified_mcp.sh and links runtime settings for the chosen IDE. Manual .mcp.json setup is covered in IDE_INTEGRATION.md.
Not required. Ollama is enough to start.
./willow.sh providers enable anthropic --key YOUR_KEY
./willow.sh providers list| Path | What |
|---|---|
~/.willow/ |
Local Willow home |
~/.willow/store/ |
SOIL collections |
~/.willow/grove_token |
LAN pairing secret |
Postgres willow_20 |
KB atoms (desktop) |
Nothing uploads by default.
Wrong folder
pwd && ls willow.sh seed.pyPostgres down
python3 seed.pyPhone cannot connect
- Same Wi‑Fi as desktop
./willow.sh servestill running- LAN IP, not
127.0.0.1 chmod 600 ~/.willow/grove_token
Tests or agents complain about identity
export WILLOW_AGENT_NAME=your_agent
export WILLOW_SAFE_ROOT=$HOME/SAFE/ApplicationsΔΣ=42