README.md

metadata

title: Alpha9 Miners Dashboard
emoji: 🧠
colorFrom: indigo
colorTo: purple
sdk: streamlit
sdk_version: 1.28.0
app_file: app.py
pinned: false

Alpha9 Training Dashboard 🧠

Real-time monitoring dashboard for the Alpha9 Bittensor network, displaying training metrics and performance data from decentralized AI training operations.

You can find the dashboard here: Hermit11/A9-Dashboard.

Features

• Real-time training progress monitoring
• Historical analysis of training metrics
• Miner performance rankings and geographical distribution
• Network status overview
• Auto-refreshing metrics

System Requirements

• Python 3.8+
• 2GB RAM minimum
• Internet connection for real-time updates
• Hugging Face account and API token

Getting Started

Prerequisites

1. Get a Hugging Face Account and Token:

   • Create an account at Hugging Face
   • Generate an access token from Settings → Access Tokens
   • Make sure you have read access to the metrics repository

2. Clone the repository:

git clone https://github.com/bigideainc/A9Labs-Dashboard.git
cd A9Labs-Dashboard

3. Set up your Python environment:

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

4. Install dependencies:

pip install -r requirements.txt

Configuration

1. Create a .env file in the project root:

HF_TOKEN="your_hugging_face_token_here"
CENTRAL_REPO="Tobius/yogpt_test"  # or your metrics repository

Running Locally

1. Start the dashboard:

streamlit run app.py

2. Access the dashboard in your browser:

• The dashboard will automatically open at http://localhost:8501
• For remote access, use the network URL provided in the terminal

Dashboard Sections

Training Progress

• Overall progress bar showing completion percentage
• Total tokens processed
• Target token goal

Training Metrics

• Loss curves
• Perplexity measurements
• Tokens per second performance
• Learning rate adaptation

Network Overview

• Active miners leaderboard
• Geographical distribution map
• Real-time status indicators

Development

Project Structure

A9-Dashboard/
├── app.py              # Main dashboard application
├── utils/
│   └── HFManager.py    # Hugging Face integration utilities
├── requirements.txt    # Project dependencies
└── .env               # Environment configuration

Contributing

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request

Accessing the Hosted Dashboard

The dashboard is hosted as a Hugging Face Space at Hermit11/A9-Dashboard.

Authentication

• No authentication required for viewing
• HF token required for deployment and modifications

Troubleshooting

Common Issues

1. "No Hugging Face token found":

   • Ensure your .env file contains a valid HF_TOKEN
   • Check token permissions on Hugging Face

2. "Cannot connect to metrics repository":

   • Verify repository access permissions
   • Check internet connection
   • Confirm repository name in .env

Support

• Create an issue in the GitHub repository
• Contact the development team through GitHub Issues

License

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