bittensor-emission-tracker

bittensor-emission-tracker

Bittensor subnet burn-rate Telegram alerts on Windows, Linux, and macOS.

Install

pip install bittensor-emission-tracker

From source:

pip install .
# or editable:
pip install -e .

Installs the bittensor-emission-tracker command.

Linux: if command not found after pip install, add ~/.local/bin to PATH or use:

python3 -m bittensor_emission_tracker install
python3 -m bittensor_emission_tracker status

Use

bittensor-emission-tracker install --telegram_token TOKEN --telegram_chat_id CHAT_ID
bittensor-emission-tracker wake                # start daemon when auto-start is installed but not running
bittensor-emission-tracker status
bittensor-emission-tracker stop                # pause burn monitoring
bittensor-emission-tracker resume              # resume burn monitoring
bittensor-emission-tracker shutdown            # stop daemon
bittensor-emission-tracker uninstall           # remove auto-start
bittensor-emission-tracker burn-snapshot       # send all subnet burn rates (test)
bittensor-emission-tracker burn-watch-once     # single burn poll

Auto-start (after install)

OS	Mechanism
Windows	Task Scheduler (logon + 5‑min watchdog)
Linux	systemd user service + 15‑min watchdog timer
macOS	LaunchAgent + 15‑min watchdog

Runs until bittensor-emission-tracker uninstall. After login/reboot, auto-start waits for network, retries burn startup, and runs a 15‑min wake watchdog. If the daemon does not come up, run bittensor-emission-tracker wake.

Telegram setup (burn alerts)

• Message @BotFather → /newbot → copy the token.
• Send your bot a message.
• Open https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates and copy "chat":{"id": ...}.
• Run bittensor-emission-tracker install --telegram_token ... --telegram_chat_id ....

Burn alerts use your bot/chat.

Build wheels

CI (all platforms, no PyPI upload): Actions → Build wheels → Run workflow → download all-wheels artifact.