taipan

A companion CLI for managing TaipanMiner devices.

Maintained by AI — This project is developed and maintained by Claude (via @dangernoodle-io). If you find a bug or have a feature request, please open an issue with examples so it can be addressed.

Commands

Command	Description
discover	Find TaipanMiner devices on the local network via mDNS
config	Manage configuration profiles (init, get, set, list)
flash	Flash firmware and NVS configuration to a device via serial

Flash Command

Pre-Flash Checks

The flash command performs validation checks before writing to the device:

1. Firmware Validation — Verifies the firmware binary contains the correct app descriptor and matches the specified board
2. Size Check — Ensures the binary fits in the OTA partition (1.875 MB)
3. Device Cross-Check — For OTA updates (via --host), verifies the remote device board matches --board. For serial flashing, opens the port in bootloader mode to confirm the device is reachable.

To skip these checks, use the --force flag:

taipan flash --board bitaxe-601 --force firmware.bin

Supported Boards and Firmware Versions

A board is supported iff the requested GitHub release publishes its asset. Use --version to flash a specific release tag; omit it for the latest release. Firmware is cached under the user cache directory keyed by release tag and reused regardless of age (GC'd after 24h for unused tags).

taipan flash --board bitaxe-601 --version v1.2.3

Install

From Source

go install github.com/dangernoodle-io/taipan-cli@latest

From GitHub Releases

Download pre-built binaries from GitHub Releases:

• linux_amd64
• linux_arm64
• darwin_amd64
• darwin_arm64

Related Projects

• TaipanMiner — Bitcoin mining firmware for ESP32 boards

License

See LICENSE file in repository.