{"id":50453510,"url":"https://github.com/rudi193-cmd/willow-2.0","last_synced_at":"2026-06-08T00:00:18.201Z","repository":{"id":359060966,"uuid":"1242842334","full_name":"rudi193-cmd/willow-2.0","owner":"rudi193-cmd","description":"Willow 2.0 — local-first memory, MCP tools, and fleet coordination for AI agents. Postgres KB, Ollama default, Grove LAN remote.","archived":false,"fork":false,"pushed_at":"2026-05-31T23:49:47.000Z","size":4317,"stargazers_count":1,"open_issues_count":4,"forks_count":1,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-06-01T01:19:32.260Z","etag":null,"topics":["ai-agents","claude-code","cursor","knowledge-graph","local-first","mcp","model-context-protocol","ollama","postgres"],"latest_commit_sha":null,"homepage":"https://rudi193-cmd.github.io/willow-2.0/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rudi193-cmd.png","metadata":{"files":{"readme":"README-FELIX.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY_AUDIT.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-05-18T20:06:24.000Z","updated_at":"2026-05-31T23:43:17.000Z","dependencies_parsed_at":"2026-05-20T11:00:12.377Z","dependency_job_id":null,"html_url":"https://github.com/rudi193-cmd/willow-2.0","commit_stats":null,"previous_names":["rudi193-cmd/willow-2.0"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/rudi193-cmd/willow-2.0","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rudi193-cmd%2Fwillow-2.0","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rudi193-cmd%2Fwillow-2.0/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rudi193-cmd%2Fwillow-2.0/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rudi193-cmd%2Fwillow-2.0/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rudi193-cmd","download_url":"https://codeload.github.com/rudi193-cmd/willow-2.0/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rudi193-cmd%2Fwillow-2.0/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34042554,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-07T02:00:07.652Z","response_time":124,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","claude-code","cursor","knowledge-graph","local-first","mcp","model-context-protocol","ollama","postgres"],"created_at":"2026-06-01T01:04:18.608Z","updated_at":"2026-06-08T00:00:18.196Z","avatar_url":"https://github.com/rudi193-cmd.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Felix — your path into Willow\n\nHi Felix.\n\nSean built this for people he trusts, not for engineers. You do not need to understand databases, MCP, or any of that. You need a computer that can hold memory for you, and a front room where you can see what the system knows and talk to it.\n\nThat front room is **Grove**. This page is the story of how you get there once.\n\n---\n\n## What you are actually doing\n\nThink of Willow as a **house on your PC**:\n\n- **The basement** is where things are stored (your notes, history, what mattered last week). You never have to go down there.\n- **The install wizard** is `seed.py`. It asks your name, walks you through setup step by step, and does the boring work while FRANK narrates the show. If something is wrong, it will stop and tell you — you are not expected to diagnose it.\n- **Grove** is the **living room**. Channels, messages, the dashboard. When setup is done, you live here.\n\nYou are not “deploying a stack.” You are moving in.\n\n---\n\n## Before you start (one-time on Windows)\n\nYou need **Windows 10 or 11** and **WSL** so Linux can run quietly in the background. Sean can sit with you for this part if you want; it is the only Windows-shaped hurdle.\n\n1. Open **PowerShell as Administrator** (right-click → Run as administrator).\n2. Paste this and press Enter:\n\n   ```\n   wsl --install\n   ```\n\n3. Restart when Windows asks.\n4. Open the **Microsoft Store**, install **Ubuntu**, open it once, and pick a username and password. Remember the password.\n\nAfter that, you mostly live inside **Ubuntu** for Willow — not because you are becoming a Linux person, but because that is where the house was built.\n\n---\n\n## The only install block you need to copy\n\nOpen **Ubuntu** from the Start menu. Paste this whole block, press Enter, and let it run. Go get coffee. It may ask for your Ubuntu password once or twice — that is normal.\n\n```bash\nsudo apt update \u0026\u0026 sudo apt install -y git python3 python3-pip python3-venv postgresql curl\ngit clone https://github.com/rudi193-cmd/willow-2.0 ~/github/willow-2.0\ncd ~/github/willow-2.0\npython3 -m venv .venv \u0026\u0026 source .venv/bin/activate\npip install -e .\npython3 seed.py\n```\n\n### What `seed.py` will do (so you are not surprised)\n\nYou are not supposed to run health checks afterward. **Seed is the check.** While it runs you will see lines scrolling — directories, vault, database, a little theater from FRANK. Answer the prompts when it asks (your name, email for the vault, whether you want Grove network features, and so on). If you are unsure, say yes to **Grove** when it offers — that is how you end up in the right place.\n\nWhen seed finishes without a red error wall, **you are installed.** Sean can help if it stops hard; send him a photo of the screen or the last few lines of text.\n\n---\n\n## How you will use it day to day\n\nAfter a good seed on Windows, you should have a shortcut on your **Windows Desktop**:\n\n**Launch Willow.bat**\n\nDouble-click it. A window opens — that is **Grove**. No terminal commands required for normal use.\n\nFrom there:\n\n- You will see **channels** (like rooms). `#general` is the main room.\n- You can **read** what agents and people have posted.\n- You can **write** — ask a question, leave a note, pick up where you left off. Willow and the other voices are meant to remember context that normal chat apps throw away.\n\nThat is the habit: **open Grove, read the room, say what you need.** The system keeps the thread on your machine, not in someone else’s cloud.\n\nIf the desktop shortcut is missing, tell Sean — seed usually creates it; he can fix the path once.\n\n---\n\n## When something feels broken\n\nYou do not need to run `fleet_status` or decode JSON. Try in order:\n\n1. Close the Grove window and double-click **Launch Willow.bat** again.\n2. If it still fails, text Sean. He will ask you to open Ubuntu and paste one thing — he will send it. That is his job, not yours.\n\n---\n\n## Updates (rare)\n\nSean or the repo will tell you when to pull an update. Until then, ignore git. If he says “update Willow,” he will give you a short paste block — same as install, but shorter.\n\n---\n\n## Why you are here\n\nYou are in the **found family** line on the main README for a reason. This tree is tended for people who show up in real life. Grove is where you land after the wizard does its work — not a homework assignment, a place to think out loud with memory that stays.\n\nWelcome in.\n\n*Built by Sean Campbell. You are among the first outside the house to run it.*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frudi193-cmd%2Fwillow-2.0","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frudi193-cmd%2Fwillow-2.0","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frudi193-cmd%2Fwillow-2.0/lists"}