Ratatosk

Platform session runtime for the Willow fleet — the process that runs agent turns on any node (desk, laptop, Termux phone) and speaks MCP to willow-mcp.

Role

Ratatosk is not memory (Nestor), not the desk (Grove). It is the session process: prompt → tools → loop, Grove lifecycle events, JSONL working set, tier-0 deposit sync.

Install

pip install "willow-ratatosk[mcp,cloud,local]"
# development
pip install -e ".[dev]"

Run

ratatosk --local
ratatosk --mcp
ratatosk --mcp --listen
ratatosk --mcp --deposit

Environment

Var	Default	Purpose
`RATATOSK_GROVE_CHANNEL`	(disabled)	Grove channel for session events
`RATATOSK_MCP_COMMAND`	`python -m willow_mcp`	MCP server command
`RATATOSK_APP_ID`	`ratatosk`	MCP `app_id`
`WILLOW_HOME`	`$WILLOW_HOME` or XDG share	Session data under `$WILLOW_HOME/ratatosk/`
`OLLAMA_URL`	`http://localhost:11434`	Local inference
`ANTHROPIC_API_KEY`	—	Cloud mode

willow-mcp registration

Ratatosk is a platform session identity, not a dispatch specialist. Install its manifest under $WILLOW_HOME/mcp_apps/ratatosk/manifest.json (example in docs/mcp-manifest.example.json). Without this, Grove tools deny with app_id=ratatosk.

Org home

Canonical repo: willow-memory/ratatosk (Platform face, sibling to willow-mcp and kartikeya).

Playground launcher: safe-app-store-public/apps/ratatosk.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

willow_ratatosk-1.2.3.tar.gz (63.2 kB view details)

Uploaded Sep 7, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

willow_ratatosk-1.2.3-py3-none-any.whl (33.0 kB view details)

Uploaded Sep 7, 2026 Python 3

File details

Details for the file willow_ratatosk-1.2.3.tar.gz.

File metadata

Download URL: willow_ratatosk-1.2.3.tar.gz
Upload date: Sep 7, 2026
Size: 63.2 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for willow_ratatosk-1.2.3.tar.gz
Algorithm	Hash digest
SHA256	`8cb0a55a0f14434424d2cc8326e763b0b97219097c82af5b541299e4ef1889de`
MD5	`422f106bdc6690c61c83ef2f7f3593d0`
BLAKE2b-256	`d9523b2dbe16b7c0ed3ee135d533e6dc3a17cf7eb365ef04003a7e200057b748`

See more details on using hashes here.

Provenance

The following attestation bundles were made for willow_ratatosk-1.2.3.tar.gz:

Publisher: release.yml on willow-memory/ratatosk

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: willow_ratatosk-1.2.3.tar.gz
- Subject digest: 8cb0a55a0f14434424d2cc8326e763b0b97219097c82af5b541299e4ef1889de
- Sigstore transparency entry: 2747794958
- Sigstore integration time: Sep 7, 2026
Source repository:
- Permalink: willow-memory/ratatosk@e3143e94606eaefa59af5b72d72128b7759ff60b
- Branch / Tag: refs/tags/v1.2.3
- Owner: https://github.com/willow-memory
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@e3143e94606eaefa59af5b72d72128b7759ff60b
- Trigger Event: push