thirst
Run your GPU job at the right hour and the right speed, so it takes less water and CO₂. Get a signed receipt that proves it.
Thirst is a command-line tool for people who train AI models on NVIDIA GPUs in India. It plans when to start a job and how much to lower the GPU power limit, runs your command on that plan, measures the real GPU energy, and sends a receipt to your lab's page on the Thirst leaderboard.
pip install thirst
thirst register --name "CSE GPU Lab" --city Chennai --cooling room_ac --gpus 4
thirst plan --hours 6 --deadline "2026-10-12 09:00" --pausable
thirst run --hours 6 --deadline "2026-10-12 09:00" --pausable -- python train.py
| Command | What it does |
|---|---|
thirst register |
Creates your lab's site once and saves its key to ~/.thirst/config.toml |
thirst plan |
Shows the best start time and power cap, with savings as ranges |
thirst run -- <cmd> |
Waits, caps the GPU, runs your command, pauses or resumes it, restores the power limit, posts a receipt |
thirst run --modelled |
No NVIDIA GPU: estimates energy instead and labels it "modelled" |
thirst doctor |
Checks GPU, power-cap permission, clock and API |
thirst sync |
Sends receipts that were saved while offline |
Energy is measured from the GPU (NVML). Water and CO₂ are modelled from it, using Indian grid and weather data, and every receipt says which is which.
Project, website and the science: https://github.com/Neal006/Thirst · MIT licence.
1 maintainer
Metadata
1 maintainer
Release files for thirst 0.3.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| thirst-0.3.1.tar.gz | 51.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| thirst-0.3.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 111.6 kB
Release files / thirst-0.3.1.tar.gz
| Download URL | thirst-0.3.1.tar.gz |
|---|---|
| Size | 51.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
216cb2ec074ed9beb1837523ebb1f932cb6904ba91505eccad95af2eceda505b
|
|
BLAKE2b-256 checksum How to use checksums |
4c59ebedeb8b75a4af06525e343a70c1b9189d1551d6416a28cb1d139b22e40b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 11, 2026.
Transparency logRelease files / thirst-0.3.1-py3-none-any.whl
| Download URL | thirst-0.3.1-py3-none-any.whl |
|---|---|
| Size | 60.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c1c748d097699b1157bb233fe8fadba3001f729565478111e94c6e2fec2d9451
|
|
BLAKE2b-256 checksum How to use checksums |
3f658692825f0fa26cadd60970b4b5b05a8b98db1f02464119edf950f103432e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 11, 2026.
Transparency log
