Claude Code Plugins

Community-maintained marketplace

Feedback

Unified Braiins ecosystem skill covering all Bitcoin mining tools - OS firmware, Pool, Toolbox, Manager, Proxy, and Insights calculator

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

name braiins-ecosystem
description Unified Braiins ecosystem skill covering all Bitcoin mining tools - OS firmware, Pool, Toolbox, Manager, Proxy, and Insights calculator

Braiins Ecosystem

Comprehensive skill for the complete Braiins Bitcoin mining ecosystem - covering firmware, pool services, management tools, and profitability analysis.

Description

The Braiins ecosystem provides an integrated suite of Bitcoin mining tools from hardware firmware to pool services and operational management:

  • Braiins OS - ASIC miner firmware with API and build system
  • Braiins Pool - Bitcoin mining pool (oldest active pool, est. 2010)
  • Braiins Toolbox - Batch management GUI/CLI for mining operations
  • Braiins Manager - Web-based monitoring and management dashboard
  • Braiins Farm Proxy - Stratum V2 proxy for hashrate aggregation
  • Braiins Insights - Interactive profitability calculator and analytics

Official Resources:

Ecosystem Overview

The Complete Mining Stack

┌─────────────────────────────────────────────────────────┐
│                  Braiins Ecosystem                      │
├─────────────────────────────────────────────────────────┤
│  PLANNING                                               │
│  • Braiins Insights - Profitability calculator          │
├─────────────────────────────────────────────────────────┤
│  FIRMWARE                                               │
│  • Braiins OS - ASIC firmware with autotuning          │
│  • BOS+ API - Programmatic miner control               │
├─────────────────────────────────────────────────────────┤
│  MANAGEMENT                                             │
│  • Braiins Toolbox - Batch operations (GUI/CLI)        │
│  • Braiins Manager - Web dashboard monitoring          │
├─────────────────────────────────────────────────────────┤
│  NETWORKING                                             │
│  • Braiins Farm Proxy - Hashrate aggregation           │
│  • Stratum V2 - Enhanced mining protocol                │
├─────────────────────────────────────────────────────────┤
│  MINING                                                 │
│  • Braiins Pool - FPPS pool (0% fee with Braiins OS)   │
│  • Solo Mining - High-variance solo option              │
└─────────────────────────────────────────────────────────┘

Quick Reference by Use Case

Starting a New Mining Operation

  1. Plan Profitability → Use braiins-insights skill

    • Calculate break-even scenarios
    • Model electricity costs and BTC price projections
    • Analyze IRR and cash flow with DPS modeling
  2. Select Hardware → Consult braiins-insights skill

    • Review supported ASIC models (S21, S19, S17, M5x, M3x, M2x families)
    • Calculate cost to mine 1 BTC with different hardware
  3. Install Firmware → Use braiins-os and braiins-toolbox skills

    • Deploy Braiins OS via Toolbox batch installation
    • Configure autotuning for efficiency
    • Set up BOS+ API for programmatic control
  4. Configure Mining → Use braiins-pool skill

    • Connect to Braiins Pool (FPPS, 0% fee with Braiins OS)
    • Set up Lightning Network payouts for instant withdrawals
    • Enable Stratum V2 for enhanced security
  5. Monitor Operations → Use braiins-manager skill

    • Real-time dashboards for hashrate, power, temperature
    • Alert configuration for proactive maintenance
    • Multi-user access for team collaboration

Optimizing Existing Operations

Performance Tuningbraiins-toolbox + braiins-os

  • Batch-set power/hashrate targets across devices
  • Enable DPS (Dynamic Power Scaling) for electricity cost optimization
  • Configure cooling modes and temperature thresholds

Large-Scale Managementbraiins-toolbox + braiins-manager + braiins-proxy

  • Use Toolbox for batch firmware updates
  • Aggregate hashrate through Farm Proxy
  • Monitor fleet through Manager dashboard

Profitability Analysisbraiins-insights + braiins-pool

  • Calculate current mining profitability
  • Model halving impact on revenue
  • Track actual rewards via Pool statistics

Individual Skill Summaries

1. Braiins OS (braiins-os skill)

Purpose: Bitcoin mining ASIC firmware with advanced features

Key Features:

  • Autotuning: Automatic power/hashrate optimization
  • BOS+ API: REST API for programmatic miner management (v1.8.0)
  • Build System: Package feeds for customization
  • Stratum V2: Enhanced mining protocol support

When to Use:

  • Installing/upgrading ASIC miner firmware
  • Building custom firmware configurations
  • Integrating miners with automation systems
  • Accessing miner metrics programmatically

Quick Commands:

# API example (requires BOS+ API)
curl -X GET "http://miner-ip/api/v1/status"

2. Braiins Pool (braiins-pool skill)

Purpose: Bitcoin mining pool (oldest active pool, est. 2010)

Key Features:

  • FPPS Rewards: Full Pay Per Share with transaction fee inclusion
  • 0% Fees: When mining with Braiins OS firmware
  • Lightning Payouts: Instant, low-cost Bitcoin transfers
  • Stratum V2: Next-generation mining protocol
  • Solo Mining: 0.5% fee, anonymous mining option
  • API Access: Full JSON API for custom integrations

When to Use:

  • Connecting miners to mining pool
  • Setting up Lightning Network payouts
  • Calculating FPPS reward estimates
  • Implementing Stratum V2 protocol
  • Solo mining with low fees

Quick Commands:

# Pool connection
stratum+tcp://stratum.braiins.com:3333

# Solo mining
stratum+tcp://solo.stratum.braiins.com:3333

Pool Stats:

  • Current Block Reward: 3.125 BTC (post-2024 halving)
  • Pool Fee: 2.5% standard, 0% with Braiins OS
  • Payout Schedule: Daily at 9:00 UTC

3. Braiins Insights (braiins-insights skill)

Purpose: Interactive Bitcoin mining profitability calculator

Key Features:

  • Profitability Calculator: Comprehensive ROI analysis with customizable inputs
  • Future Projections: Model difficulty and price changes over time
  • Break-Even Analysis: CapEx recovery timelines in USD and BTC
  • Debt Financing: Loan modeling with payment schedules
  • Cost Analysis: Calculate cost to mine 1 BTC
  • Halving Impact: Model next halving effect on revenue

When to Use:

  • Planning mining investments
  • Calculating break-even scenarios
  • Modeling debt financing options
  • Analyzing halving impact
  • Comparing mining hardware profitability

Calculator Inputs:

  • Hashrate (TH/s), Power Consumption (W)
  • Electricity Price (USD/kWh)
  • BTC Price, Network Difficulty
  • Difficulty/Price increment rates
  • Optional: Loan amount, interest rate, DPS parameters

URL: https://learn.braiins.com/en/profitability-calculator


4. Braiins Toolbox (braiins-toolbox skill)

Purpose: Batch management tool for mining operations (GUI + CLI)

Key Features:

  • Network Scanning: Discover miners on local network (Antminers, Whatsminers, Avalons, Icerivers)
  • Firmware Management: Batch install/uninstall/upgrade Braiins OS
  • System Management: Reboot, collect data/logs, locate devices
  • Miner Management: Configure pools, start/stop mining
  • Performance Tuning: Set power/hashrate targets, enable DPS
  • Cooling Management: Configure fan speeds and temperatures
  • Keyboard Shortcuts: Command Palette (⌘+P / Ctrl+P) for mouse-free workflow

When to Use:

  • Managing multiple miners simultaneously
  • Scanning network for device discovery
  • Deploying Braiins OS remotely
  • Batch configuration changes
  • Automating workflows with CLI

Quick Commands:

# Scan network
$ ./braiins-toolbox scan '10.10.10-11.*'

# Install Braiins OS
$ ./braiins-toolbox firmware install '10.10.10-11.*'

# Set pool URLs
$ ./braiins-toolbox miner set-pool-urls \
  --url 'stratum+tcp://user@stratum.braiins.com:3333' \
  '10.10.10-11.*'

# Set power target
$ ./braiins-toolbox tuner target --power 3318 '10.10.10-11.*'

Platform Support: Windows, macOS, Linux (x86_64, aarch64, armv7)


5. Braiins Manager (braiins-manager skill)

Purpose: Web-based dashboard for mining fleet monitoring

Key Features:

  • Real-Time Monitoring: Live hashrate, power, temperature
  • Fleet Organization: Group miners by site, model, or custom criteria
  • Performance Analytics: Historical data and trend analysis
  • Alert System: Email/SMS notifications for issues
  • Multi-User Access: Role-based permissions (admin, operator, viewer)
  • Remote Configuration: Adjust settings from centralized interface

When to Use:

  • Monitoring mining operations at scale
  • Managing multiple sites geographically
  • Setting up proactive maintenance alerts
  • Collaborating with team members
  • Analyzing performance trends

Access:

  • Cloud: manager.braiins.com
  • Self-Hosted: Deploy on-premise for air-gapped operations

Note: Placeholder skill - full documentation at https://academy.braiins.com/en/braiins-manager/


6. Braiins Farm Proxy (braiins-proxy skill)

Purpose: High-performance mining proxy for hashrate aggregation

Key Features:

  • Protocol Support: Stratum V1 and V2
  • Hashrate Aggregation: Combine multiple miners into single upstream connection
  • Failover Protection: Automatic pool switching
  • Bandwidth Optimization: Reduce internet usage for large farms
  • Latency Reduction: Local proxy closer to miners

When to Use:

  • Aggregating hashrate from 100+ miners
  • Implementing failover to backup pools
  • Reducing bandwidth costs
  • Deploying Stratum V2 across operations
  • Optimizing connection stability

Deployment Pattern:

Miners (1000s) → Farm Proxy → Mining Pool
  ↓ Stratum V1/V2   ↓ Aggregated    ↓ Single connection

Note: Placeholder skill - full documentation at https://academy.braiins.com/en/braiins-proxy/


Integration Workflows

Complete Mining Farm Setup

# 1. Plan profitability (Insights)
Visit: https://learn.braiins.com/en/profitability-calculator

# 2. Scan and discover miners (Toolbox)
$ ./braiins-toolbox scan '10.10.*.*' --output devices.csv

# 3. Install Braiins OS firmware (Toolbox → OS)
$ ./braiins-toolbox firmware install \
  --contract-code 'XYZ' \
  '10.10.*.*'

# 4. Configure mining pool (Toolbox → Pool)
$ ./braiins-toolbox miner set-pool-urls \
  --url 'stratum+tcp://user@stratum.braiins.com:3333' \
  '10.10.*.*'

# 5. Enable DPS and set power targets (Toolbox → OS)
$ ./braiins-toolbox tuner set-dps on \
  --power-step 200 \
  --min-power-target 2500 \
  '10.10.*.*'

# 6. Monitor operations (Manager)
Login to: manager.braiins.com

Optimizing for Low Electricity Costs

Scenario: Take advantage of cheap overnight electricity

  1. Calculate Economics (Insights):

    • Model DPS with price increment assumptions
    • Set shutdown thresholds for peak hours
  2. Configure DPS (Toolbox):

    $ ./braiins-toolbox tuner set-dps on \
      --shutdown-enabled true \
      --shutdown-duration 8 \
      '10.10.*.*'
    
  3. Monitor Impact (Manager):

    • Track profitability over 24-hour cycles
    • Adjust thresholds based on actual costs

Multi-Site Mining Operation

  1. Deploy Farm Proxies (Proxy):

    • One proxy per site for local aggregation
    • Reduces WAN bandwidth to pool
  2. Centralized Management (Manager):

    • Organize sites in Manager dashboard
    • Set site-specific alert thresholds
  3. Batch Operations (Toolbox):

    • Use Toolbox CLI for scripted updates
    • Schedule maintenance windows per site
  4. Profitability Tracking (Insights + Pool):

    • Compare site profitability
    • Optimize power targets per location

Braiins Advantages

0% Pool Fees

When using Braiins OS firmware with Braiins Pool, miners pay 0% pool fees (standard 2.5% fee is fully rebated).

Integrated Ecosystem

All tools work seamlessly together:

  • Toolbox can deploy OS firmware
  • OS firmware integrates with Manager monitoring
  • Pool statistics feed into Insights profitability models
  • Proxy optimizes connections to Pool

Stratum V2

Braiins pioneered Stratum V2 protocol, offering:

  • Enhanced security (encrypted connections)
  • Job negotiation (miners choose transaction sets)
  • Bandwidth efficiency
  • Support across OS, Pool, and Proxy

Lightning Network Payouts

Instant, low-cost Bitcoin withdrawals from Pool via Lightning Network.


Related Skills

For detailed information, use individual skills:

  • braiins-os - ASIC firmware and API documentation
  • braiins-pool - Mining pool configuration and solo mining
  • braiins-insights - Profitability calculator and financial modeling
  • braiins-toolbox - Batch management and network scanning
  • braiins-manager - Fleet monitoring and alerts (placeholder)
  • braiins-proxy - Hashrate aggregation and failover (placeholder)

External Resources


Notes

  • Ecosystem Completeness: Covers planning (Insights), firmware (OS), management (Toolbox/Manager), networking (Proxy), and mining (Pool)
  • Zero-Fee Advantage: Braiins OS + Braiins Pool = 0% pool fees
  • Protocol Leadership: Braiins developed Stratum V2, supported across ecosystem
  • Scale Support: Tools designed for operations from single miner to thousands of devices
  • Open Source: Many components available on GitHub for customization
  • Active Development: Regular updates across all tools (BOS+ API v1.8.0 as of Nov 2025)

Generated by Skill Seeker | Ecosystem Integration Skill Last Updated: 2025-12-28 Component Skills: 6 individual Braiins skills unified Total Documentation: 200+ pages across all skills combined