rudi193-cmd/willow-2.0

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).

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

| Piece | What it does | |-------|----------------| | Knowledge base | Atoms that survive across sessions, models, and IDEs | | SAP MCP | Unified MCP with profile-filtered tools for memory, fleet health, tasks, handoffs, and inference | | SAFE gate | Every tool call checked against manifests before it runs | | SOIL | Fast structured state on disk (per agent / collection) | | Grove | Terminal dashboard + LAN remote control (./willow.sh serve) | | Fylgja | Skills and powers — Markdown behaviors any model can follow | | HNS | Routes inference to the best available node by VRAM — activate with WILLOW_INFERENCE_PROVIDER=hns |

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

---

Choose Your Path

| You are | Start with | What happens | |---------|------------|--------------| | New human or contributor | bash setup.sh --public | Uses only files in this public repo; no private config required | | Fleet operator | bash setup.sh | Uses private ~/github/.willow as an overlay for credentials, handoffs, and settings | | Agent in an IDE | [`willow