Willow 2.0

→ Front door (GitHub Pages) — Oden voiceover, Huginn & Muninn vox pops, dark + colorful. docs/LANDING_DESIGN.md

Local-first memory and tools for AI agents.

Willow keeps a knowledge graph on hardware you control, exposes it through an MCP server, and runs local inference with Ollama by default. Cloud API keys are optional. Your data stays in Postgres (desktop) or SQLite (Termux).

Try it in five minutes (public demo)

Hero moment: ask Willow something — it remembers (from local demo memory on your machine).

git clone https://github.com/rudi193-cmd/willow-2.0.git
cd willow-2.0
python willow-launcher.py

Requires Docker + Python 3.11+. Opens a browser chat on http://127.0.0.1:7788 (or the next free port if 7788 is taken — Grove often uses 7777). Demo memory is labeled honestly — see TRUST.md and docs/PUBLIC_READY_V1.md.

Found family: This repo is tended for the people who show up in real life — not as users, as kin. If you're AHS (AllHailSeizure: beta reader, r/LLMPhysics, optional Necron decoder ring, Windows port contributor) or Felix (Windows/WSL install path), those pages are your front door. Everyone else: keep reading below.

What you get

IDEs connect via MCP (sap/sap_mcp.py). Humans use ./willow.sh and the docs below.

Choose Your Path

Quick Start

New here: docs/FIRST_5_MINUTES.md — copy, paste, verify health.

git clone https://github.com/rudi193-cmd/willow-2.0
cd willow-2.0
bash setup.sh --public

Then:

./willow.sh fleet_status   # postgres, ollama, manifests
./willow.sh start          # services
./willow.sh status         # version + summary

Termux: same clone, then python3 seed.py --termux --skip-pg (SQLite instead of Postgres). Details in docs/QUICKSTART.md.

Windows: use install-windows.ps1 and seed-windows.py instead. Postgres must be installed separately — seed.py uses apt-get and will not work on Windows. Details in docs/QUICKSTART.md.

Default database name is willow_20. Upgrading from 1.9? See docs/CODE_DIFF_1.9_to_2.0.md.

Connect Cursor / Claude Code

Install an agent profile for the IDE you actually use:

./willow.sh agents active <agent>
./willow.sh agents install <agent> --ide <cursor|claude|codex>

The installer writes MCP config for sap/unified_mcp.sh. Agents boot from willow.md, check fleet health and handoff, then act. Details: docs/IDE_INTEGRATION.md.

Phone on the same Wi‑Fi (optional)

Run a signed HTTP listener on your desktop; ping it from Termux. No Discord, no cloud relay.

Desktop:

./willow.sh serve
# Token: ~/.willow/grove_token

Phone:

echo "TOKEN" > ~/.willow/grove_token && chmod 600 ~/.willow/grove_token
bash ~/willow-2.0/willow.sh grove send 192.168.x.x:7777 status-all

Use your LAN IP, not 127.0.0.1. Full walkthrough: docs/FIRST_5_MINUTES.md §3.

Layout (high level)

IDE / CLI / phone
       │
       ├── SAP MCP (stdio) ──► KB, SOIL, fleet, tasks
       │
       └── Grove serve :7777 ──► remote status / commands
                │
                ▼
         Postgres or SQLite  +  Ollama (default)

Repo map: docs/ROOT_LAYOUT.md. Deeper architecture: wiki/what-is-willow.md.

Research & safety context

Willow's multi-session memory, prompt-injection taxonomy, and fleet gates are documented for cross-org citation:

• AI Risk Repository (MIT FutureTech) — taxonomy we map to operational controls: docs/outreach/ai-risk-taxonomy-mapping.md
• Multi-session continuity — reference for eval researchers (METR time-horizon discussion): docs/outreach/multi-session-continuity-reference.md
• Fleet Persuasion Eval sketch — extending FAR AI AttemptPersuadeEval to multi-agent orchestration: docs/outreach/fleet-persuasion-eval-sketch.md

Index: docs/outreach/README.md.

Requirements

• Python 3.11+ (3.12 supported; CI matrix covers both)
• PostgreSQL 15+ with pgvector (or SQLite on Termux)
• GPG (SAFE app identity)
• Ollama for local inference
• Windows: use install-windows.ps1 + seed-windows.py; pywin32 and windows-curses are platform-scoped in requirements.txt. See docs/QUICKSTART.md.

Optional: ./willow.sh providers enable anthropic YOUR_KEY (or OpenAI / Gemini).

Status

Beta (2.0) — tests and packaging are in place; wiki and archive specs may lag code. Honest gaps: docs/KNOWN_GAPS.md. Audit snapshot: docs/BETA_AUDIT_REPORT.md.

Canonical repo: willow-1.9, willow-mcp, willow-nest, and willow-seed are archived — everything ships here now. Upgrading from 1.9: docs/CODE_DIFF_1.9_to_2.0.md.

Documentation

License

PolyForm Noncommercial 1.0.0 — see LICENSE.

Plant the tree. Tend the roots. Name the ones you love. Let nothing be lost.