Spaces:
Sleeping
Sleeping
updated README file
Browse files
README.md
CHANGED
|
@@ -7,6 +7,45 @@ sdk: docker
|
|
| 7 |
pinned: true
|
| 8 |
---
|
| 9 |
|
| 10 |
-
# Omoku
|
| 11 |
|
| 12 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 7 |
pinned: true
|
| 8 |
---
|
| 9 |
|
| 10 |
+
# Omoku Analysis Dashboard Automation
|
| 11 |
|
| 12 |
+
## Overview
|
| 13 |
+
This repository supports the Omoku Analysis Dashboard, which is hosted on Hugging Face Spaces. It's designed to automate the data updating process for the dashboard, ensuring that the displayed data is consistently refreshed from a Google Sheets source. This README provides guidance on how the automation works, how to utilize the repository for similar projects, and how you can contribute to its development.
|
| 14 |
+
|
| 15 |
+
## Purpose
|
| 16 |
+
- **For GitHub Users**: This repository contains scripts, automation workflows (GitHub Actions), and documentation for setting up and managing the dashboard's data pipeline.
|
| 17 |
+
- **For Hugging Face Users**: If you're viewing this on Hugging Face Spaces, this repository is where all the backend automation is managed. You can explore how the dashboard data is updated automatically and even adapt the methods for your own projects.
|
| 18 |
+
|
| 19 |
+
## How It Works
|
| 20 |
+
1. **Data Source**: Data is stored and manually updated in a Google Sheet.
|
| 21 |
+
2. **Data Processing**:
|
| 22 |
+
- A [Python script](update_data.py) is used to download data from the Google Sheet and convert it to a CSV file.
|
| 23 |
+
- The script is automatically triggered by GitHub Actions to run at a specified time daily.
|
| 24 |
+
3. **Automation**:
|
| 25 |
+
- Two main GitHub Actions workflows handle the automation:
|
| 26 |
+
- [One workflow](.github/workflows/update_data_workflow.yml) pulls the latest data from Google Sheets, converts it to CSV, and pushes it to the repository.
|
| 27 |
+
- [The other workflow](.github/workflows/main.yml) pushes updates from the GitHub repository to the Hugging Face Space.
|
| 28 |
+
|
| 29 |
+
## Dashboard
|
| 30 |
+
Access the live dashboard here: [Omoku Analysis Dashboard](https://huggingface.co/spaces/Azaya89/omoku-analysis)
|
| 31 |
+
|
| 32 |
+
## Getting Started
|
| 33 |
+
To set up this project locally or contribute to it, follow these steps:
|
| 34 |
+
1. Clone the repository:
|
| 35 |
+
```
|
| 36 |
+
git clone git@github.com:Azaya89/omoku-analysis.git
|
| 37 |
+
```
|
| 38 |
+
2. Install the required Python libraries:
|
| 39 |
+
```
|
| 40 |
+
pip install -r requirements.txt
|
| 41 |
+
```
|
| 42 |
+
3. Set up your Google API credentials and save them as `omoku-analysis-cred_key.json`
|
| 43 |
+
|
| 44 |
+
## Contributing
|
| 45 |
+
Contributions to the Omoku Analysis project are welcome! Please consider the following ways to contribute:
|
| 46 |
+
- Submit bugs and feature requests.
|
| 47 |
+
- Review the source code and enhance the automation scripts.
|
| 48 |
+
- Update documentation as the project evolves.
|
| 49 |
+
|
| 50 |
+
## License
|
| 51 |
+
This project is licensed under the GNU GENERAL PUBLIC LICENSE - see the [LICENSE](LICENSE) file for details.
|