100% Local Fleet Ready Mini 3 + Nano 3S Avalon Q Supported

Control your miners without cloud lock-in.

Thermal Key is a CLI toolkit for monitoring, automation, and fleet management. It speaks directly to your Avalon miners so you can manage everything from any terminal on your LAN.

Get the CLI Quick start

Real-time visibility Hashrate, temps, fan, power, uptime in one call.

Batch automation Run the same command across many IPs at once.

Safe controls Explicit guardrails for reboot, fan, mode, and frequency.

Recovery tools Auth cookie generation and hash retrieval built in.

What Thermal Key can do

Everything you need to run a small farm or a single miner without vendor software.

Monitor

Pull normalized status data for Mini 3, Nano 3S, and Avalon Q miners, including temperature and power.

Control

Change fan speed, set mining modes, tune frequency, and reboot safely.

Automate

Script pool switching, night mode, or heater mode with cron or any scheduler.

Fleet manage

Target dozens of IPs in one command with clean, ordered output.

Recover

Generate auth cookies and retrieve hashes if the web UI locks you out.

Why local-first matters

Vendor apps make hardware control slow, fragile, and account-dependent. Thermal Key keeps you in charge.

Vendor app

Requires cloud login
Phone-only controls
Single device at a time
Limited scripting
Support required for lockouts

Thermal Key

Runs on your LAN only
Use any terminal
Parallel fleet commands
Automate everything
Self-service recovery tools

Quick start

Install once, then control any miner on your network.

git clone https://github.com/mars-llm/thermal-key.git
cd thermal-key

python3 thermal.py -H 192.168.1.100 status
python3 thermal.py -H 192.168.1.100 watch

Command map

Daily controls in a single script. Use one IP or a fleet list.

Status + Pools

thermal.py -H IP status
thermal.py -H IP pools

Fan + Mode

thermal.py -H IP fan 80
thermal.py -H IP mode 1

Performance

thermal.py -H IP freq 500
thermal.py -H IP level 3

Fleet

thermal.py -H ip1,ip2,ip3 reboot
thermal.py -H miners.txt status

Auth + Recovery

thermal.py -H IP auth PASS
thermal.py -H IP getauth

Avalon Q Controls

thermal.py -H IP work-mode-level 1 2
thermal.py -H IP voltage 2250
thermal.py -H IP solo on
thermal.py -H IP loop
thermal.py -H IP timezone
thermal.py -H IP qinfo

Raw API

thermal.py -H IP raw COMMAND
thermal.py -H IP ascset "0,..."

Safety and security

Miners can overheat or be damaged by unsafe settings. Use conservative limits and monitor temperatures.

CGMiner API warning The CGMiner API on port 4028 has no authentication. Anyone on your network can control your miner. Recommended: isolate miners on a VLAN, firewall port 4028, and use strong web UI passwords.

Built for real hardware

Thermal Key is optimized for Avalon Mini 3, Nano 3S, and Avalon Q miners with device-aware parsing and safe defaults.

View on GitHub Read the README