GeoResearcher

GeoResearcher is a geospatial research assistant.

It takes a list of place names and produces a CSV tailored to my cartographic needs.

It is built with the fast-agent framework, and makes use of https://github.com/anandaroop/geomcp for its toponymy research tools.

Usage

Interactive mode:

uv run src/researcher.py

Command mode:

uv run src/researcher.py --agent researcher --message "give me a csv with nola and nyc"

Notes

Inspecting LLM I/O

Enable debug logging in config, then…

See all model traffic, with metadata:

cat fastagent.jsonl | jq -c '. | select(.namespace == "fast_agent.llm.provider.anthropic.llm_anthropic") | select(.message | contains("claude-sonnet-4-0"))'

See all model traffic, messages only:

cat fastagent.jsonl | jq -c '. | select(.namespace == "fast_agent.llm.provider.anthropic.llm_anthropic") | select(.message | contains("claude-sonnet-4-0")) | .message'

See input/output token summary:

cat fastagent.jsonl | jq -c '. | select(.namespace == "fast_agent.llm.provider.anthropic.llm_anthropic") | select(.message | contains("Streaming complete"))'