Skip to main content

A command line tool used to automate the Bobcat miner. This project also offers a robust python SDK's for interacting with the Bobcat miner.

Project description

PyPI Dockerhub Release Tests Lint Code style: black

bobcat miner python

A command line tool used to automate the Bobcat miner. This project also offers a robust python SDK's for interacting with the Bobcat miner.

Install

$ pipx install bobcat-miner

Please see this guide for more information about installing stand alone command line tools with pipx.

Quick Start

The bobcat autopilot command will automatically diagnose and repair the Bobcat miner!

$ bobcat autopilot
✅ Online Status: Online ⭐
✅ Sync Status: Synced (gap:-1) 💫
✅ Relay Status: Not Relayed ✨
✅ Network Status: Good 📶
✅ Temperature Status: Good (38°C) ☀️

or run with the offical Docker image

$ docker run --rm -it aidanmelen/bobcat autopilot

Run bobcat --help to learn about the available commands and options.

Finding your Bobcat

By default, the Bobcat Autopilot will search the common 192.168.0.0/24 and 10.0.0.0/24 local networks to find the Bobcat miner.

Find Bobcat by Animal Name

This will connect to the Bobcat on your network that matches the animal name.

$ bobcat --animal "Fancy Awesome Bobcat" -C DEBUG autopilot
🐛 Connected to Bobcat: 192.168.0.10
🐛 Refresh: Miner Data
🐛 Verified Bobcat Animal: fancy-awesome-bobcat
🐛 The Bobcat Autopilot is starting 🚀 🚀 🚀

Specify the Hostname / IP Address

Otherwise, you can follow these instructions to find your Bobcats's ip address and specify it with:

$ bobcat --hostname 192.168.0.10 -C DEBUG autopilot
🐛 Connected to Bobcat: 192.168.0.10
🐛 The Bobcat Autopilot is starting 🚀 🚀 🚀

Monitoring with Discord

Monitor your Bobcat remotely by sending events to a Discord channel by specifying a webhook URL. No need for VPN or SSH agent setup!

$ bobcat --discord-webhook-url https://discord.com/api/webhooks/xxx autopilot
✅ Online Status: Online ⭐
✅ Sync Status: Synced (gap:0) 💫
⚠️ Relay Status: Relayed
✅ Network Status: Good 📶
❌ Temperature Status: Hot (78°C) 🌋

By default, all events WARNING or higher (i.e. ERROR and CRITICAL) will be sent to the Discord channel. This can be configured to include DEBUG and INFO events as well.

drawing

Dry Run

This example is admittedly contrived, but it demonstrates how the --dry-run option can be used show what actions would normally be performed against the bobcat without actually running them.

$ bobcat --dry-run reboot
Do you want to reboot the Bobcat? [y/N]: y
⚠️ Dry run is enabled: Reboot Skipped

Bobcat SDK

Please see docs/bobcat_sdk.md for more information.

Contributions

Please see docs/contributions.md for more information.

DIY Troubleshooting

Please see No Witness's Troubleshooting Guide for more information.

Donations

Donations are welcome and appreciated! :gift:

HNT: 14HmckNU4WHDDtGH29FMqVENzZAYh5a9XRiLfY2AN6ghfHMvAuR

HNT: 14HmckNU4WHDDtGH29FMqVENzZAYh5a9XRiLfY2AN6ghfHMvAuR

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bobcat-miner-0.14.7a1.tar.gz (25.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

bobcat_miner-0.14.7a1-py3-none-any.whl (27.4 kB view details)

Uploaded Python 3

File details

Details for the file bobcat-miner-0.14.7a1.tar.gz.

File metadata

  • Download URL: bobcat-miner-0.14.7a1.tar.gz
  • Upload date:
  • Size: 25.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.12 CPython/3.10.0 Linux/5.11.0-1028-azure

File hashes

Hashes for bobcat-miner-0.14.7a1.tar.gz
Algorithm Hash digest
SHA256 9007100bdf38b9122059f3023a912f47e703fcba2eff2ffaf24cee6fdbb19100
MD5 da05e8dc9887319397330d9b1b913138
BLAKE2b-256 eed57d02b520d0912d3f7545de5e54bc674755afebf2df319a14382fae2cd495

See more details on using hashes here.

File details

Details for the file bobcat_miner-0.14.7a1-py3-none-any.whl.

File metadata

  • Download URL: bobcat_miner-0.14.7a1-py3-none-any.whl
  • Upload date:
  • Size: 27.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.12 CPython/3.10.0 Linux/5.11.0-1028-azure

File hashes

Hashes for bobcat_miner-0.14.7a1-py3-none-any.whl
Algorithm Hash digest
SHA256 716bcee536c229b555460d22d7f10be507fb4a1c3ea5402b8b923b8a2b0ccfc5
MD5 1d2b95c83165189d7879a47647090599
BLAKE2b-256 377a33d043c6b9e725effa7e828a9ac804b8d460689296b19ee4a25f9d008804

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page