bittensor-burn-alert

bittensor-burn-alert

Install

For all users (PyPI):

pip install bittensor-burn-alert

From source (developers):

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

That installs the bittensor-burn-alert command.

Linux: if you see command not found after pip install, pip put the script in ~/.local/bin. Either add it to your PATH:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

or run via Python (always works):

python3 -m bittensor_burn_watch install
python3 -m bittensor_burn_watch status

python scripts/build_wheel.py          # compiled wheels (Cython; see PUBLISHING.md)
twine upload dist/*.whl                # upload all OS/Python wheels

pip install bittensor-burn-alert
bittensor-burn-alert install

Use

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

Windows (native):

pip install .
bittensor-burn-alert install
bittensor-burn-alert status

All methods are idempotent — if bittensor_burn_watch is already running, start is a no-op.

Auto-start on login (after install):

OS	Mechanism
Windows	Task Scheduler (logon + 15‑min watchdog)
Linux	systemd user service + 15‑min watchdog timer
macOS	LaunchAgent + 15‑min watchdog (com.bittensor.burn-alert.plist)

Runs until bittensor-burn-alert uninstall. After login/reboot, auto-start waits for the network (up to ~3 min), retries burn startup every 5 min until Telegram succeeds, and runs a 15‑min wake watchdog on all platforms. If all retries fail, run bittensor-burn-alert wake. Re-run install to refresh autostart/watchdog units after upgrading. macOS LaunchAgent uses KeepAlive so the daemon restarts if it crashes.

Telegram setup

• Message @BotFather in Telegram → /newbot → copy the token.
• Send your new bot any message (e.g. "hi").
• Open https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates and copy the "chat":{"id": ...} number into TELEGRAM_CHAT_ID.