OuEstCharlie — Wally
Wally is the search/consumption agent for OuEstCharlie. It is stateless and read-only: Woof launches it as a child process (MCP server over stdio), passes a structured search predicate via search_photos, and Wally returns matching photo metadata by traversing the manifest tree. It never reads XMP sidecars or writes anything.
More about OuEstCharlie on the OuEstCharlie Blog
Design Documents
| Document | Purpose |
|---|---|
| wally_LLD.md | Low-level design |
Repository Structure
See wally_LLD.md
Installation
From PyPI (recommended)
pip install wally
System prerequisites:
- macOS:
brew install inih brotli gettext(required by pyexiv2 at runtime) - Linux/Windows: no extra steps
From source (development)
Requires the sibling ouestcharlie-py-toolkit repo:
uv venv
uv sync
Running Tests
.venv/bin/pytest tests/ -v
MCP Inspector
Wally runs as a standalone HTTP server (streamable HTTP transport), so it cannot use mcp dev. Start it manually and connect the Inspector to the printed port:
WOOF_BACKEND_CONFIG='{"type":"filesystem","root":"/path/to/photos","name":"my-backend"}' \
.venv/bin/python -m wally
# stdout: WALLY_READY port=<port>
Then start the Inspector and connect to http://127.0.0.1:<port>/mcp (no auth token needed when WOOF_AGENT_TOKEN is unset):
npx @modelcontextprotocol/inspector
Note: The default MCP Inspector timeout is too low for large-library search queries. Increase it in the Inspector settings before calling
search_photos.
Context
| Repository | Purpose |
|---|---|
| ouestcharlie | Architecture docs, HLR/HLD, MCP interface |
| ouestcharlie-py-toolkit | Python toolkit for agents |
| ouestcharlie-whitebeard | Indexing agent |
| ouestcharlie-wally (this repo) | Search/consumption agent |
| ouestcharlie-woof | Woof controller |
See ouestcharlie/HLD.md for the overall system architecture.
1 maintainer
Release files for ouestcharlie-wally 0.15.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ouestcharlie_wally-0.15.0.tar.gz | 1.4 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ouestcharlie_wally-0.15.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.4 MB
Release files / ouestcharlie_wally-0.15.0.tar.gz
| Download URL | ouestcharlie_wally-0.15.0.tar.gz |
|---|---|
| Size | 1.4 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e3bde9ad1e9161cc3004d6b3ba4a25c136c418ec8df0b82d95c4e82a261a23da
|
|
BLAKE2b-256 checksum How to use checksums |
2f94a20e344b1d4f8b3c30dbbbadce185c9e36ae5b150964f52e47219919fe1c
|
| 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 17, 2026.
Transparency logRelease files / ouestcharlie_wally-0.15.0-py3-none-any.whl
| Download URL | ouestcharlie_wally-0.15.0-py3-none-any.whl |
|---|---|
| Size | 24.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a74dac3fa13f3f6dfd0554c102121438d8cc20514ed6d66e3b45e7bda7e71db1
|
|
BLAKE2b-256 checksum How to use checksums |
1323e7a6157f6af007b648489c23f8c1a6d39ba2459a6c1a2ed3167510bfaf05
|
| 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 17, 2026.
Transparency log
