tools

The reading harness: the methods given to the agent to make sense of the data of an AIMsight station. Each tool answers a question the analyst asks and returns values, dated ranges, a figure or thumbnails; it shows, it does not judge.

  • scripts/: the tools, one script each; GUIDE.md: which tool for which question, and how to read what it returns. The agent reads it first.
  • DATA.md: the files of a station and the meaning of their columns, maintained by hand; the agent reads it with the guide.
  • scripts/data.py: the one reader of the data, shared by the aimsight-app app, the tools and the detectors (which import it); a change to it changes the detectors' benchmark (python3 detectors/bench/regression.py --labels labeling/auto --data data, from aimsight-app). scripts/common.py: the helpers the tools share.
  • The tools: inventory, summary, ranges, days, overview, metrics, quality, stations, plot, thumbnails, gif (details in the guide).

Using it

The calling repository points to it through a link tools -> ~/aimsight-tools (ignored by git), next to its data/ and labeling/ links, and runs the tools from its root:

python3 tools/scripts/inventory.py data/NORDEND --start 2026-11-05T00:00Z --end 2026-11-06T00:00Z
.venv/bin/python tools/scripts/plot.py data/NORDEND --start 2026-11-05T00:00Z --end 2026-11-06T00:00Z --out out/diagnostic

Without --out, the figures go to out/diagnostic/ of the current folder. Standard library; matplotlib (through the caller's .venv) for the figures only.

Who changes it

Only the upgrader (agents repository) writes there, run by Optimizer's optimize skill after an analysis: it brings the analyst's useful scripts into the tools, it optimizes or adds, it removes nothing.

Copied from aimsight-app (agent-tools/ and the lire-les-donnees skill, commit dd6f1bf) on 2026-11-16. The architecture of the repositories: ~/aimsight-app/docs/architecture.drawio.

S
Description
AIMsight reading harness: the tools agents use to understand station data
Readme
614 KiB
0 Stars 1 Watchers 0 Forks
Languages
Python 100%