ouestcharlie-whitebeard 0.3.0

OuEstCharlie Whitebeard — photo indexer agent for local drives

Whitebeard: Photo library indexer

Whitebeard is the indexing agent for OuEstCharlie. It operates in index mode: scan an existing local photo library in place (no files moved), create XMP sidecars with ouestcharlie: fields, and write leaf manifests.

MCP tool exposed: index_partition(partition, force=False).

Project Layout

src/whitebeard/
  indexer.py    — core logic (no MCP dependency, independently testable)
  agent.py      — WhitebeardAgent(AgentBase) registering MCP tools
  __main__.py   — entry point: python -m whitebeard
tests/
  test_indexer.py

Installation

From PyPI (recommended)

pip install whitebeard

From source (development)

Requires the sibling ouestcharlie-py-toolkit repo and a built image-proc binary (see its README_DEV.md):

uv venv
uv sync

Running Tests

Always use .venv/bin/python -m pytest:

.venv/bin/python -m pytest tests/ -v

Context

Repository	Purpose
ouestcharlie	Architecture docs, HLR/HLD, MCP interface
ouestcharlie-woof	Woof controller
ouestcharlie-py-toolkit	Python toolkit for agents
ouestcharlie-whitebeard This repo	Indexing agent
ouestcharlie-wally	Search/consumption agent