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.
1 maintainer
Metadata
1 maintainer
Release files for willow-ratatosk 1.12.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| willow_ratatosk-1.12.5.tar.gz | 264.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| willow_ratatosk-1.12.5-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 383.4 kB
Release files / willow_ratatosk-1.12.5.tar.gz
| Download URL | willow_ratatosk-1.12.5.tar.gz |
|---|---|
| Size | 264.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
478fdd07e91085d93ed2bbbbcb65df4da32c2ccd0b7f3ec7d5afa239769ea770
|
|
BLAKE2b-256 checksum How to use checksums |
b480ee829dc6f08a94935a75da7b3fcce2d5f355b3191d8e19c51a426ab2dbf8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 30, 2026.
Transparency logRelease files / willow_ratatosk-1.12.5-py3-none-any.whl
| Download URL | willow_ratatosk-1.12.5-py3-none-any.whl |
|---|---|
| Size | 119.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3dc77e36abda82483097705f18d75851cc72bdfffd988d3b5479462c13f8369b
|
|
BLAKE2b-256 checksum How to use checksums |
6e154fb30fecebff2f3e4c13b1468fa544179ca582950c523bdcbede920c9e0c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 30, 2026.
Transparency log
