monohunter

Find single long-period mono-transits in public TESS light curves — the single-transit events that periodic pipelines (SPOC/QLP, which fold on a period) structurally under-find. Built so many people can each search under-covered targets and combine machine-readable finds.

Status: early. Detection core (P1) done and tested; CLI + packaging in progress.

Why

Automated TESS pipelines run periodic searches (BLS/TLS) over every target. A single transit has no period to fold on, so those searches miss it. Real long-period planets have been co-discovered exactly here (e.g. TOI-2180 b, found from one ~24-hour transit). monohunter targets that gap.

How it works

fetch (dedup sectors, prefer 2-min, stream) ->
detrend (wotan, window >> transit or the dip gets eaten) ->
detect (matched-filter box scan, non-periodic) ->
FindRecord (versioned + validated JSON)  ->  candidates/

The Detector interface is a seam: v1 is a matched-filter box scan; a GP-based detector (nuance) plugs in later without touching the pipeline. The versioned FindRecord JSON is the contract a future aggregation server consumes.

Reuse, not reinvention

Stands on lightkurve, wotan, scipy, and astroquery. monohunter is orchestration + the single-transit gap + result aggregation, not a new detection engine.

Dev

python -m venv .venv && . .venv/Scripts/activate   # Windows
pip install -e ".[dev]"
pytest -q

Releasing to PyPI

CI (.github/workflows/ci.yml) runs the tests on every push. Publishing (.github/workflows/release.yml) fires on a version tag and uses Trusted Publishing — no token in GitHub.

One-time PyPI setup (before the first release):

  1. On PyPI: Account → Publishing → Add a pending publisher:
    • PyPI project name: monohunter
    • Owner: Rinkia · Repository: monohunter
    • Workflow: release.yml · Environment: leave blank (Any)
  2. (Optional) For a manual approval gate, create a GitHub Environment, set it as the pending-publisher Environment, and add environment: <name> back to the publish job in release.yml.

Then release:

# bump version in pyproject.toml first
git tag v0.1.0
git push --tags

License

MIT.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.3.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for Rinkia from gravatar.com Rinkia

License

MIT

Requires

Python >=3.10

Provides Extra

dev

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

monohunter-0.1.0.tar.gz (14.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

monohunter-0.1.0-py3-none-any.whl (13.4 kB view details)

Uploaded Python 3

File details

Details for the file monohunter-0.1.0.tar.gz.

File metadata

  • Download URL: monohunter-0.1.0.tar.gz
  • Upload date:
  • Size: 14.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for monohunter-0.1.0.tar.gz
Algorithm Hash digest
SHA256 43bfd8e6b66f77c9f9b454b6bffdaef778c35239fecfe1039b951e1fb11043d4
MD5 6c47ae5e74c720d72a1d2f47486dd651
BLAKE2b-256 0b68edd09bb15324b2e9c6dc9364ae736411c77b87f4bac1dc659ee297d9ae80

See more details on using hashes here.

Provenance

The following attestation bundles were made for monohunter-0.1.0.tar.gz:

Publisher: release.yml on Rinkia/monohunter

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file monohunter-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: monohunter-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 13.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for monohunter-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 78888002ce188fdab01fb53f81bbd38ca365339b9b61d404f656750567af8fe8
MD5 90c68fd546b157e68757eb043b26ab94
BLAKE2b-256 04eeb4dd8d0198b8edec6d8409c59420fffbb6c82e215dc46db8b57dd2ae4435

See more details on using hashes here.

Provenance

The following attestation bundles were made for monohunter-0.1.0-py3-none-any.whl:

Publisher: release.yml on Rinkia/monohunter

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page