setuhq 0.1.0

SetuHQ · the bridge
The open exoplanet observatory: from public sky data to reviewed, explained candidates.

SetuHQ is an open, reproducible transit search of public NASA TESS light curves. A reviewer panel of AI Sentinels (Claude by default; other providers supported and labelled) and deterministic matched-filter Probes marks every dip in blind-coded light curves, the way Planet Hunters volunteers do. The pipeline then vets each dip, fits a limb-darkened transit model and bounds its false-alarm probability. Every candidate keeps its provenance: data hash, config hash, code fingerprint and every reviewer's marks.

Every SetuHQ output is a candidate, never a confirmation. Follow-up observations decide what is a planet.

Install

pip install setuhq                 # the setuhq command
pip install "setuhq[mcp]"          # plus the setuhq-mcp server for AI assistants
pip install "setuhq[tess,mcp]"     # plus TESS downloads through lightkurve

Python 3.11 or later. The package carries the pipeline and the reference tables it reads (the Claret 2017 limb-darkening coefficients and the secondary-eclipse calibration), so setuhq run searches, vets and fits a TESS target from a plain install (with the tess extra for the download). The stored runs, the frozen real-TOI benchmark, the leaderboard and the site are data, not code, and stay in the repository: to reproduce them, or to point the MCP tools at them, use a checkout and set SETUHQ_ROOT to it.

git clone https://github.com/ashfordeOU/SetuHQ
SETUHQ_ROOT=$PWD/SetuHQ setuhq-mcp --list-tools

Use

setuhq --help                                   # every command
setuhq run my_config.toml --out runs/my-run     # a config names the targets and the panel (configs/ in the repository)
setuhq crossmatch runs/my-run                   # the NASA Exoplanet Archive cross-match the Docket shows
setuhq docket runs/my-run --out site/docket --title "My run"
setuhq mcp                                      # the MCP server over stdio (also installed as setuhq-mcp)

Without installing anything: uvx --from "setuhq[mcp]" setuhq mcp.

The quick-start notebook walks through the stored pi Men run offline: the candidates, the docket data, a Probe on a stored light curve and an MCP tool called as a plain function.

The MCP server

setuhq-mcp lets an AI assistant run SetuHQ's own code and read its stored results instead of guessing them: the exoplanet catalogue, a run's candidates with full provenance, BLS search and vetting, the transit fit, the bounded false-alarm probability and the Methods physics. Every answer carries its provenance and honesty labels. The server runs on your computer; nothing is sent to Ashforde OÜ. Set-up for each client is in docs/MCP-INSTALL.md.

Learn more

• The full README, the evidence and the benchmark: https://github.com/ashfordeOU/SetuHQ
• The app: https://setuhq.com
• Changelog: CHANGELOG.md
• Cite: CITATION.cff
• Security: SECURITY.md

Licence

The code is under the GNU AGPL-3.0-only, or under a commercial licence from Ashforde OÜ (contact@ashforde.org) for use the AGPL does not suit. SetuHQ's own data, benchmark, leaderboard data and paper are under CC BY 4.0. See LICENSING.md. "SetuHQ" and the Setu mark are trademarks of Ashforde OÜ (TRADEMARKS.md).