Repository files navigation

Tweak your ESPminer for max hashrate, minimum watts, and thermally clean operation - automagically.Built for the modern sovereign miner, optimized for freedom.

“Don’t trust. Verify. Solo-mine. Then autotune.” - Satoshi, probably

A CLI-based tuner that runs multi-objective optimization on your ESPminer.It finds the best balance of:

• 🧠Hashrate (TH/s)
• 🔌Efficiency (J/TH)
• 🌡Thermal Constraints

All in real-time usingOptuna and your device’s REST API.

🤝 Found new best parameters with your ESPminer? Leave some sats for development support:bc1pgen5mzfdeq4hpwv6t7etjtch5j3dda46pm555vxhn839wq3aggdscrtxws

• 🎛 Optimizes frequency & core voltage
• 🧪 Runs real-time stats collection from the ESPminer
• 🧯 Aborts trials if temps go too high
• 📈 Logs every trial to a CSV
• 📚 Saves study results to a local SQLite DB
• 🌈 Usesrich for pretty CLI output

• This directly modifies your ESPminer settings and restarts the miner every trial.
• Know your thermal + voltage limits.

To enhance your ESPminer optimization workflow, consider integrating the Optuna Dashboard for real-time visualization and analysis of your optimization runs. This tool provides interactive graphs and detailed trial data, allowing you to monitor the optimization process effectively.

Dependencies:

• Python 3
• A ESPminer running firmware with the/api/system endpoints

Directly install from PyPIespminer-optim via pip:

pip install espminer-optim

Clone the repository and install it in editable mode

pip install -e.

Run the executable after install:

espminer-optim

or run directly via Python runtimepython optimize.py if you have cloned the source.

You’ll be prompted for:

• ESPminer IP address
• Frequency & voltage range
• Trial count & duration
• Temperature limits

Then the tuner gets to work - configuring, restarting, collecting stats, and evolving toward greatness. 🙌

Each trial logs:

• Frequency (MHz)
• Core Voltage (mV)
• Avg Hashrate (TH/s)
• Avg Power (W)
• Efficiency (J/TH)
• Objective Score

1. Install Optuna Dashboard:

   pip install optuna-dashboard

2. Run Your Optimization Script

3. Launch the Dashboard:

   In a separate terminal, start the dashboard:

   optuna-dashboard sqlite:///espminer-optim-db.sqlite3

   This will start a local server, typically accessible athttp://localhost:8080/.

• Interactive Visualization: Monitor optimization history, parameter importances, and trial details through dynamic graph.

• Real-Time Updates: Observe the optimization progress as new trials are complete.

• Trial Management: Filter, sort, and inspect individual trials to gain insights into the optimization proces.

For more information and advanced usage, refer toOptuna Dashboard documentation.By incorporating the Optuna Dashboard into your workflow, you can gain deeper insights into your optimization process, leading to more efficient and effective tuning of your ESPminer device.

⚡️⛏️ Built for Bitaxe