From a single S19 keeping your living-room cozy to an institutional-scale blockchain datacenter running thousands of ASICs – ThermoHash turns excess mining heat into intelligent, profitable energy while slashing setup time to minutes.
- Zero-Config IP Geolocation – auto-detects your coordinates to pull hyper-local weather forecasts (fallback to manual).
- Machine-Learning Optimizer – TensorFlow-powered neural network predicts the optimal wattage ahead of weather changes.
- Bitcoin-Price & Hashprice Intelligence – dynamically throttles power to protect margins during price swings.
- One-Line Installers –
install.sh&install.bathandle everything (Python, virtual-env, grpcurl, systemd). - Interactive Setup Wizard – guided CLI (
wizard_setup.py) stores API keys, detects location, previews live data. - Cross-Platform, Single Script – one code-base for Linux, Windows, bare-metal or containers.
- Smooth Power-Smoothing Algorithm – eliminates rapid watt jumps, prolonging miner life.
- Comprehensive Logging & Metrics – granular INFO/DEBUG streams plus daily profit reports.
- Immersion & Heat-Reuse Ready – validated with FogHashing, BitChimney, StealthMiner JPro+, and more.
- Web-Based Setup Wizard – run
web_wizard.pyfor browser configuration and automatic miner discovery.
Ready in 5 minutes. Saves for a lifetime.
- Whisper-Quiet Efficiency – run a down-clocked S19 on 120 V without tripping breakers.
- Automatic Comfort Mode – maintain a target room temperature; excess hash shuts off politely.
- Heat-Reuse Guides – detailed immersion and radiator tutorials included.
- Multi-Miner Scaling – drop-in support for Braiins OS (gRPC) & LuxOS (TCP API) fleets.
- Financial Guardrails – pause or reduce power when profit margins dip below your SLA.
- Ops Friendly – systemd services, Prometheus-ready logs, and REST hooks (coming soon).
# 1. Clone & install (Linux)
git clone https://github.com/dibend/thermohash.git && cd thermohash
chmod +x install.sh && ./install.sh
# 2. Run the interactive wizard (CLI)
python wizard_setup.py
# 3. Optional web wizard
python web_wizard.py # then open http://localhost:8000
# 4. Launch!
python thermohash_optimized.pyWindows users: just double-click install.bat.
ThermoHash includes a lightweight test-suite powered by pytest. Running it is optional but recommended after you make changes or before you submit a pull-request.
# From the repository root
pip install -r requirements.txt # if you did not run install.sh / install.bat
pytest -q # execute all tests quietlyNotes:
- The geolocation test requires external network calls and is skipped by default via
pytest.skip(...)– the rest of the suite is fully offline-friendly. - Use
pytest -vvfor verbose output orpytest tests/to target a specific folder. - Feel free to remove the skip marker if you wish to test the live geolocation flow.
| Category | Highlights |
|---|---|
| Weather Intelligence | IP geolocation, OpenMeteo 72-h forecast, humidity & wind analysis |
| Machine Learning | 32→16→8→1 dense NN, auto-retraining every 7 days, >20 % efficiency gain |
| Financial Insight | CoinGecko price feed, Luxor hashprice, profitability-aware throttling |
| Power Control | gRPC SetPowerTarget (Braiins) / TCP set_power_limit (LuxOS), exponential smoothing, multi-level fallback |
| Installation | Automated scripts, virtual-envs, env-var secret storage |
| Logging & Monitoring | JSON logs, rotating files, optional Prometheus exporter |
| Compatibility | Braiins OS, LuxOS, BitChimney, StealthMiner, immersion tanks |
ThermoHash interfaces with miner firmware using two protocols:
- Braiins OS – communicates over gRPC using the official BOSminer PAPI endpoints (
braiins.bos.v1.AuthenticationService/Loginandbraiins.bos.v1.PerformanceService/SetPowerTarget). See the Braiins PAPI docs. - LuxOS (Luxor) – speaks a CGMiner-style TCP API on port
4028. Refer to Luxor's firmware API documentation. LuxOS does not use BOSminer or gRPC.
ThermoHash is 100 % open-source and community-driven. If this project reduces your heating bill or boosts your farm's bottom line, please consider becoming a GitHub Sponsor. Every sponsorship accelerates:
- Multi-miner orchestration
- Web & mobile dashboards
- Native Prometheus/Grafana integration
- Advanced ML models & edge deployments
- Full User Guide:
README_OPTIMIZED.md - Implementation & Improvements:
IMPLEMENTATION_SUMMARY.md/IMPROVEMENTS_SUMMARY.md - Weather + Financial API details: see inline docstrings.
- GitHub Issues for bugs & feature requests
- Pull Requests welcome
ThermoHash – because your hash-rate should power your world.
