HESTIA plugin

HESTIA skills for AI coding assistants. Ask Claude Code, Codex or Antigravity a question about HESTIA data — why a model failed on your Cycle, where an aggregated number came from — and get an answer built from what HESTIA actually computed rather than from guesswork.

This is public. It is published to PyPI as hestia-earth-plugin, and works against the public HESTIA API, the public data downloads and the public hestia-engine-models repository — no checkout, no internal access and no credential is required to use it.

pip install hestia-earth-plugin    # or: uv tool install hestia-earth-plugin
hestia-plugin install              # register the skills with your assistant

Then open your assistant and ask.

Until the first release lands on PyPI, install from the repository instead: pip install git+https://gitlab.com/hestia-earth/hestia-plugin.git.

The skills

More are being moved across; the Skills page is generated from the skills themselves, so it is always the current list.

Documentation

https://hestia-earth.gitlab.io/hestia-plugin

• Install — every assistant it supports, and where each one reads its skills
• Configure — what a HESTIA API token buys you, and what works without one
• Skills — the full catalogue, generated from the skills themselves
• How it works — the division of labour between the assistant and the tools, and what each skill reads
• Troubleshooting
• Contributing — adding a skill, and what must never be committed

Kept there rather than here so each thing is written down once: the install steps lived in both places until they disagreed.

Working on the plugin

Each skill is a folder in skills/ — a SKILL.md your assistant reads, and any knowledge/ playbooks it consults before diagnosing anything. The deterministic tools they call are in src/hestia_earth/plugin/, one package per skill; nothing there talks to an LLM.

pip install -e '.[dev,models]'
pytest && black src tests && flake8
hestia-plugin install          # re-run after every change to a SKILL.md

To preview a docs change:

scripts/serve-docs.sh          # http://127.0.0.1:8000, rebuilding as you edit
scripts/serve-docs.sh --build  # one-shot --strict build, the same gate CI runs

It creates a .venv on first run and builds the two generated pages — docs/skills.md and docs/contributing.md are git-ignored.

Merge requests target master. The rest — commits, playbooks — is in CONTRIBUTING.md, which is also the source of the Contributing page.

License

MIT — see LICENSE.