arunasrivastava commited on
Commit
c441a7f
ยท
1 Parent(s): 6869bf9

added readme

Browse files
Files changed (1) hide show
  1. README.md +8 -124
README.md CHANGED
@@ -1,124 +1,8 @@
1
- # ๐ŸŽฏ Phonemic Transcription Leaderboard
2
-
3
- Welcome to the Phonemic Transcription Leaderboard! This simple leaderboard helps you track and compare the performance of different speech-to-phoneme model. Feel free to use it for your own hugging face leaderboards!
4
-
5
- ![leaderboard](img/leaderboard.png)
6
-
7
- ## โœจ Features
8
-
9
- * ๐Ÿ“Š Interactive leaderboard with real-time sorting
10
- * ๐Ÿ”„ Easy model submission system
11
- * ๐Ÿ“ˆ Automatic evaluation of submitted models
12
- * ๐Ÿ“ฑ Responsive design that works on all devices
13
-
14
- ## ๐ŸŽฏ What This Project Does
15
-
16
- This leaderboard tracks two key metrics for phonemic transcription models:
17
-
18
- * **PER (Phoneme Error Rate)**: How accurately your model converts speech to phonemes
19
- * **PWED (Phoneme Weighted Edit Distance)**: A more nuanced metric that considers phonemic features
20
-
21
- Models are evaluated on the TIMIT speech corpus, a gold standard in speech recognition research.
22
-
23
- ## ๐Ÿš€ Getting Started
24
-
25
- ### Prerequisites
26
-
27
- * Python 3.10
28
- * Git
29
- * A love for speech recognition! ๐ŸŽค
30
-
31
- ### Quick Installation
32
-
33
- 1. Clone this repository:
34
-
35
- ```bash
36
- git clone [your-repo-url]
37
- cd phonemic-leaderboard
38
- ```
39
-
40
- 2. Set up your environment:
41
-
42
- ```bash
43
- # Create a virtual environment with Python 3.10
44
- python3.10 -m venv venv
45
-
46
- # Activate the virtual environment
47
- source venv/bin/activate
48
-
49
- # Install the required dependencies
50
- pip install -r requirements.txt
51
- ```
52
-
53
- 3. Launch the leaderboard:
54
-
55
- ```bash
56
- # Run the application
57
- uvicorn app:app --host 0.0.0.0 --port 7860
58
- ```
59
-
60
- 4. Visit `http://localhost:7860` in your browser and see the magic! โœจ
61
-
62
- ## ๐ŸŽฎ Using the Leaderboard
63
-
64
- ### Submitting a Model
65
-
66
- 1. Go to the "Submit Model" tab
67
- 2. Enter your model details:
68
- * Model name (e.g., "wav2vec2-phoneme-wizard")
69
- * Submission name (e.g., "MyAwesomeModel v1.0")
70
- * GitHub/Kaggle/HuggingFace URL (optional)
71
- 3. Click Submit and watch your model climb the ranks! ๐Ÿš€
72
-
73
- ### Checking Model Status
74
-
75
- 1. Navigate to the "Model Status" tab
76
- 2. Enter your model name or task ID
77
- 3. Get real-time updates on your model's evaluation progress
78
-
79
- ## ๐Ÿ“Š Understanding the Results
80
-
81
- The leaderboard shows:
82
-
83
- * Model names and submission details
84
- * PER and PWED scores (lower is better!)
85
- * Links to model repositories
86
- * Submission dates
87
-
88
- Sort by either metric to see who's leading the pack!
89
-
90
- ## ๐Ÿ› ๏ธ Technical Details
91
-
92
- * Built with Gradio for a smooth UI experience
93
- * Runs on a basic compute plan (16GB RAM, 2vCPUs) for easy reproducibility
94
- * Evaluation can take several hours - perfect time to grab a coffee โ˜•
95
-
96
- ## ๐Ÿค Contributing
97
-
98
- Want to make this leaderboard even better? We'd love your help! Here are some ways you can contribute:
99
-
100
- * Add new evaluation metrics
101
- * Improve the UI design
102
- * Enhance documentation
103
- * Submit bug fixes
104
- * Add new features
105
-
106
- ## ๐Ÿ“ License
107
-
108
- This project is licensed under the MIT License - see the LICENSE file for details.
109
-
110
- ## ๐ŸŒŸ Acknowledgments
111
-
112
- * Thanks to the TIMIT speech corpus for providing evaluation data
113
- * Shoutout to the [panphon library](https://github.com/dmort27/panphon) for PWED calculations
114
- * Built with love by Koel Labs ๐Ÿ’™
115
-
116
- ## ๐Ÿ†˜ Need Help?
117
-
118
- Got questions? Found a bug? Want to contribute? Open an issue or reach out to us! We're here to help make speech recognition evaluation fun and accessible for everyone!
119
-
120
- Remember: Every great model deserves its moment to shine! ๐ŸŒŸ
121
-
122
- ---
123
-
124
- Happy Transcribing! ๐ŸŽคโœจ
 
1
+ title: IPA Transcription Leaderboard
2
+ emoji: ๐Ÿ“
3
+ colorFrom: purple
4
+ colorTo: pink
5
+ sdk: gradio
6
+ sdk_version: 5.8.0
7
+ app_file: app.py
8
+ pinned: false