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.0
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.0.tar.gz | 47.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| thirst-0.3.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 104.2 kB
Release files / thirst-0.3.0.tar.gz
| Download URL | thirst-0.3.0.tar.gz |
|---|---|
| Size | 47.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
dba72fa8e25a2ba3c73fcb24a941eac9f875239f84e0de8e4be88f32ea572639
|
|
BLAKE2b-256 checksum How to use checksums |
88a37d32adf02ff47009c286b8b740f045b9d106c16744eaba80904169332337
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.30 {"installer":{"name":"uv","version":"0.11.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / thirst-0.3.0-py3-none-any.whl
| Download URL | thirst-0.3.0-py3-none-any.whl |
|---|---|
| Size | 56.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
306a7499e055a5f97aa07c0d016134fb4f05e1269364b28269a78c4ec71d1940
|
|
BLAKE2b-256 checksum How to use checksums |
ac29f55a4c7a3fba581844221ffa71a1512375fe5c203768fee55954987a4891
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.30 {"installer":{"name":"uv","version":"0.11.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
