skills.rest
synapz-org
synapz-orgCOMMUNITY
Explore all skills by this author →
Website𝕏@synapz_orgGitHub

grail-miner

Automate Grail miner setup, operation, and optimization on Bittensor Subnet 81.

Updated Aug 23, 2026
Search Tags:#checkpoints#GRPO#SAT#GSM8K#grail#miner-setup#R2-storage
One-click install
npx skills add https://github.com/synapz-org/grail-miner-claude-skill --skill grail-miner
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grail-miner
Source: https://github.com/synapz-org/grail-miner-claude-skill/tree/main
Command: npx skills add https://github.com/synapz-org/grail-miner-claude-skill --skill grail-miner

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python-dotenv, boto3, botocore, requests, torch, bittensor, transformers, typer, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill provides end-to-end guidance and tooling to set up, manage, and optimize Grail miners on Bittensor Subnet 81, covering environment configuration, R2 storage, model checkpoints, GRPO rollout generation, performance tuning, monitoring, and common troubleshooting.

Core Features & Use Cases

  • Miner Setup: Interactive wizard and health checks to bootstrap a production-ready miner, including wallet verification and systemd deployment.
  • R2 Storage & Checkpoints: Dual-credential storage configuration, bucket validation, and checkpoint lifecycle management.
  • Rollout Generation & Monitoring: Deterministic GRPO rollout creation, performance tuning, and real-time monitoring dashboards.
  • Troubleshooting: Guidance for CUDA/GPU errors, upload failures, and low/zero weights with pragmatic recovery steps.

Quick Start

Use the skill to configure a Grail miner for subnet 81 and start the end-to-end setup in Claude Code.

Frequently Asked Questions about grail-miner

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a Grail miner on Bittensor Subnet 81?▼

To set up a Grail miner, use an interactive wizard with health checks to bootstrap your environment, verify your registered Bittensor wallet, and deploy via systemd. This requires Claude Code, Python 3.11+ with uv, and Cloudflare R2 credentials.

How do I configure Cloudflare R2 storage for Bittensor model checkpoints?▼

Configure R2 storage using dual-credential setup and bucket validation to manage your model checkpoint lifecycle. This ensures secure storage and retrieval of checkpoints generated during your Grail miner operations on subnet 81.

What is the best way to generate GRPO rollouts for GSM8K and SAT environments?▼

Generate deterministic GRPO rollouts using built-in performance tuning and monitoring tools. This allows you to create, track, and optimize rollouts specifically tailored for SAT and GSM8K evaluation environments.

Why does my Grail miner receive zero weights on Bittensor subnet 81?▼

Zero weights may result from misconfigured R2 storage, failed checkpoint uploads, or CUDA/GPU errors. Use the troubleshooting guidance to apply pragmatic recovery steps, validate your bucket configuration, and check GPU compatibility.

Do I need a specific Python version and package manager to run a Grail miner?▼

Yes, running a Grail miner requires Python 3.11 or higher and the uv package manager. You also need dependencies like torch, transformers, and bittensor, along with Claude Code for the interactive setup wizard.

Can I monitor Bittensor miner performance and troubleshoot CUDA errors in real-time?▼

Yes, you can monitor performance using real-time dashboards and troubleshoot CUDA/GPU errors using provided recovery steps. The skill offers tools for performance tuning and diagnosing upload failures during operation.

Related Skills

Explore More Software Engineering Skills→
SoljournerSoljourner
45

get-available-resources

Enumerate installed Python packages, databases, and software tools with versions and connectivity.

Community
Basic
haitao2016haitao2016

introspection-debugger

Monitor game runtime performance and recover from errors using Lua scripts.

Community
Advanced
RheasilviaRheasilvia

axolotl

Fine-tune large language models via centralized YAML configuration.

Community
Advanced
jpfieldingjpfielding

usgs-minerals

Retrieve and analyze USGS mineral commodity data from ScienceBase.

Community
Intermediate