pypi · umbra-py
UMBRA_CANOPY_TOKEN · secret — Canopy API token. Set it and the same search tools query Umbra's authenticated commercial archive instead of the open bucket; leave it unset for the open data, which needs no credentials.
UMBRA_INDEX_DB — Path to a local catalog index (built with 'umbra index build' or fetched with 'umbra index fetch'). Without one the server walks the public bucket per search, which is correct but slow.
ANTHROPIC_API_KEY · secret — Enables the two opt-in model tools, describe_scene and narrate_change. Every other tool is deterministic and calls no model.
OPENAI_API_KEY · secret — Alternative provider for the same two model tools, and the encoder behind find_similar_text.