|
---
|
|
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](https://huggingface.co/spaces/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](https://huggingface.co/)
|
|
- Generate an access token from [Settings → Access Tokens](https://huggingface.co/settings/tokens)
|
|
- Make sure you have read access to the metrics repository
|
|
|
|
2. Clone the repository:
|
|
```bash
|
|
git clone https://github.com/bigideainc/A9Labs-Dashboard.git
|
|
cd A9Labs-Dashboard
|
|
```
|
|
|
|
3. Set up your Python environment:
|
|
```bash
|
|
python -m venv venv
|
|
source venv/bin/activate # On Windows: venv\Scripts\activate
|
|
```
|
|
|
|
4. Install dependencies:
|
|
```bash
|
|
pip install -r requirements.txt
|
|
```
|
|
|
|
### Configuration
|
|
|
|
1. Create a `.env` file in the project root:
|
|
```bash
|
|
HF_TOKEN="your_hugging_face_token_here"
|
|
CENTRAL_REPO="Tobius/yogpt_test" # or your metrics repository
|
|
```
|
|
|
|
### Running Locally
|
|
|
|
1. Start the dashboard:
|
|
```bash
|
|
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](https://huggingface.co/spaces/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](https://github.com/bigideainc/A9Labs-Dashboard/issues)
|
|
|
|
## License
|
|
This project is licensed under the MIT License - see the LICENSE file for details. |
