Active pre-release project

HashOrb

A hands-on project for learning how Bitcoin mining works while exploring GPU compute, search strategies, CI/CD, and AI-assisted software engineering.

You can go from setup to actively mining Bitcoin with HashOrb today for free.

HashOrb Dashboard · NVIDIA DGX Spark● MINING
Backendcuda · device 0
Strategyfibonacci-bounce
Effective rate1.87 GH/s
Raw rate2.74 GH/s
Best difficulty176.324
Hashes4.03T
Ranges8,446
Duplicates0
Recent search path: 11 → 56 → 18 → 48 → 26 → 41 → 33 → 04 → 61

Example from a live HashOrb CUDA mining run on NVIDIA DGX Spark.

View on GitHubStart mining
Why this exists

Learning by building something real.

HashOrb is a working Bitcoin miner and learning platform, built to make the protocol, compute path, and engineering around mining understandable.

Learning Bitcoin

Using working code to understand mining instead of treating Bitcoin as a black box.

  • Block headers and double SHA-256
  • Targets, difficulty, nonces, and search spaces
  • Stratum jobs and share submission
  • Bitcoin Core RPC and true-solo mining

Simple multi-machine mining

HashOrb keeps scaling simple: one independent miner per machine.

  • Install HashOrb separately on each computer
  • Use the same CKPool Bitcoin payout address
  • Each miner receives its own Stratum work
  • No HashOrb swarm or coordinator required
Tools

Built as an engineering playground.

The stack spans compute, Bitcoin interfaces, automation, testing, security, and AI-assisted development.

Python 3.13Native CNVIDIA CUDAGitHub CopilotGitHub ActionsDockeruvLinuxmacOSWindowsNVIDIA DGX SparkBitcoin Core RPCStratumpytestRuffmypyTrivy
Examples

From setup to actual Bitcoin mining.

Start offline, then explicitly enable a real bounded CKPool mining run using only a public Bitcoin receive address. HashOrb never needs your seed phrase or private key.

hashorb — terminal
# Check the local environment
$ hashorb doctor

# Optional: benchmark the machine first
$ hashorb compute-benchmark --backend python --hash-count 100000

# In .env, set your PUBLIC Bitcoin receive address
HASHORB_STRATUM_HOST=stratum.ckpool.org
HASHORB_STRATUM_PORT=3333
HASHORB_BITCOIN_ADDRESS=YOUR_BITCOIN_ADDRESS
HASHORB_WORKER_NAME=auto
HASHORB_STRATUM_PASSWORD=x

# Explicitly arm live Stratum + mining for this shell
$ export HASHORB_ENABLE_LIVE_STRATUM=1
$ export HASHORB_ENABLE_LIVE_MINING=1

# Mine real Bitcoin work through CKPool for five minutes
$ hashorb stratum-mine \
    --profile auto \
    --max-runtime-seconds 300 \
    --log-file logs/events.jsonl

# In another terminal, watch the live dashboard
$ hashorb dashboard --log-file logs/events.jsonl
Full Quick Start
Engineering

More than hashing code.

The project practices maintainable software engineering: automation, documentation, CI/CD, reproducibility, testing, and security.

CI/CD

GitHub Actions workflows, pull-request based development, reproducible tooling, and automated checks.

Quality

Unit and regression testing, static analysis, type checking, benchmarking, and multiple compute backends.

Security

Dependency, secret, source, and container scanning using Gitleaks, Trivy, Bandit, and pip-audit.

Support

Support HashOrb.

HashOrb is free and open source. If you find it useful and want to support continued development, testing, and documentation, you can buy me a coffee or contribute Bitcoin directly.

☕ Buy Me a Coffee

Support HashOrb with a one-time or recurring contribution through Buy Me a Coffee.

Buy Me a Coffee

₿ Bitcoin

Send Bitcoin directly to the HashOrb support address.

bc1qgr9cv6n8tl33k96q2nxk6cf9gj2f7asjj264te

Bitcoin network only.

Active development / pre-release

HashOrb is a learning and experimentation project. It is not intended to compete with ASIC mining hardware and does not claim to improve the probability of finding a valid Bitcoin hash.