A modern, modular cryptocurrency mining management platform with GPU support, RESTful API, and cross-platform desktop application.

• Multi-Algorithm Mining: Support for CPU and GPU mining across multiple algorithms
• Dual Mining: Run CPU and GPU mining simultaneously with separate pools
• Profile Management: Save and switch between mining configurations
• Real-time Monitoring: Live hashrate, shares, and performance metrics
• RESTful API: Full control via HTTP endpoints with Swagger documentation
• Web Dashboard: Embeddable Angular web component for any application
• Desktop Application: Native cross-platform app built with Wails v3
• Mobile Responsive: Touch-friendly UI with drawer navigation
• Simulation Mode: Test the UI without real mining hardware

Manages installation and configuration of:

• XMRig - High-performance CPU/GPU miner (RandomX, CryptoNight)
• T-Rex - NVIDIA GPU miner (KawPow, Ethash, and more)
• lolMiner - AMD/NVIDIA GPU miner (Ethash, Beam, Equihash)
• TT-Miner - NVIDIA GPU miner (Ethash, KawPow, Autolykos2)

# Run with Docker - no dependencies required
docker run -p 9090:9090 ghcr.io/snider/mining:latest

# Access the dashboard at http://localhost:9090

# Install
go install github.com/Snider/Mining/cmd/mining@latest

# Start the API server
miner-ctrl serve --host localhost --port 9090

# Or use the interactive shell
miner-ctrl serve

<script type="module" src="./mbe-mining-dashboard.js"></script>
<snider-mining api-base-url="http://localhost:9090/api/v1/mining"></snider-mining>

Download pre-built binaries from Releases or build from source:

cd cmd/desktop/mining-desktop
wails3 build

Mining/
├── cmd/
│   ├── mining/              # CLI application (miner-ctrl)
│   └── desktop/             # Wails desktop app
├── pkg/mining/              # Core Go package
│   ├── mining.go            # Interfaces and types
│   ├── manager.go           # Miner lifecycle management
│   ├── service.go           # RESTful API (Gin)
│   └── profile_manager.go   # Profile persistence
├── miner/                   # Standalone C++ mining tools
│   ├── core/                # CPU/GPU miner binary
│   ├── proxy/               # Stratum proxy for farms
│   ├── cuda/                # CUDA plugin for NVIDIA
│   └── README.md            # Miner documentation
└── ui/                      # Angular 20+ web dashboard
    └── src/app/
        ├── components/      # Reusable UI components
        └── pages/           # Route pages

The miner/ directory contains standalone C++ mining programs that can be used independently without the GUI:

# Build miner binaries
make build-miner

# Or build individually
make build-miner-core   # CPU/GPU miner
make build-miner-proxy  # Stratum proxy

# Run directly
./miner/core/build/miner -o pool.example.com:3333 -u WALLET -p x
./miner/proxy/build/miner-proxy -o pool.example.com:3333 -b 0.0.0.0:3333

Pre-built binaries are available from Releases. See miner/README.md for full documentation.

Base path: /api/v1/mining

Swagger UI: http://localhost:9090/api/v1/mining/swagger/index.html

• Go 1.24+
• Node.js 20+ (for UI development)
• CMake 3.21+ (for miner core)
• OpenCL SDK (for GPU support)

# Go Backend
make build              # Build CLI binary
make test               # Run all tests (Go + C++)
make dev                # Start dev server on :9090

# Miner (C++ Binaries)
make build-miner        # Build miner and proxy
make build-miner-all    # Build and package to dist/miner/

# Frontend
cd ui
npm install
npm run build           # Build web component
npm test                # Run unit tests

# Desktop
cd cmd/desktop/mining-desktop
wails3 build            # Build native app

Mining profiles are stored in ~/.config/lethean-desktop/mining_profiles.json

Example profile:

{
  "id": "uuid",
  "name": "My XMR Mining",
  "minerType": "xmrig",
  "config": {
    "pool": "stratum+tcp://pool.supportxmr.com:3333",
    "wallet": "YOUR_WALLET_ADDRESS",
    "algo": "rx/0"
  }
}

We welcome contributions! Please read our Code of Conduct and Contributing Guidelines first.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

See CONTRIBUTORS.md for the list of contributors.

This project is licensed under the EUPL-1.2 License - see the LICENSE file for details.

• XMRig - High performance miner
• Wails - Desktop application framework
• Angular - Web framework
• Gin - HTTP web framework
• Cobra - CLI framework