k-m-irfan commited on
Commit
257fd44
Β·
1 Parent(s): e416924

updated readme

Browse files
Files changed (1) hide show
  1. README.md +33 -52
README.md CHANGED
@@ -4,13 +4,22 @@ Supported Languages: Assamese, Bengali, Bodo, Gujarati, Hindi, Kannada, Malayala
4
  ---
5
 
6
  # Fastspeech2_HS_Flask_API
7
- Flask API implementation of the Text to Speech Model developed my Speech Lab, IIT Madras.
8
 
9
- Please refer the original repository for more details of models and inference.
 
 
10
 
11
- The Repo is large in size, some of the alrge files are uploaded using gut lfs
 
 
 
 
12
 
13
- please install latest git LFS from the link, before proceeding to download large model files.
 
 
 
 
14
 
15
  ```
16
  curl -s https://packagecloud.io/install/repositories/github/git-lfs/script.python.sh | bash
@@ -18,88 +27,60 @@ sudo apt-get install git-lfs
18
  git lfs install
19
  ```
20
 
21
- The complete repository along with the models are uploaded into hugginface.
 
 
22
 
23
- Clone the huggingface repo below
24
  ```
25
  git clone https://huggingface.co/k-m-irfan/Fastspeech2_HS_Flask_API
26
  ```
27
- Or download the models form original repository [add link] and arrange the folder structure in the given format:
 
 
28
 
29
  ```
30
  models
31
- β”œβ”€β”€ assamese
32
- β”‚ β”œβ”€β”€ female
33
- β”‚ └── male
34
- β”œβ”€β”€ bengali
35
- β”‚ β”œβ”€β”€ female
36
- β”‚ └── male
37
- β”œβ”€β”€ bodo
38
- β”‚ └── female
39
- β”œβ”€β”€ english
40
- β”‚ β”œβ”€β”€ female
41
- β”‚ └── male
42
- β”œβ”€β”€ gujarati
43
- β”‚ β”œβ”€β”€ female
44
- β”‚ └── male
45
  β”œβ”€β”€ hindi
46
  β”‚ β”œβ”€β”€ female
47
  β”‚ └── male
48
- β”œβ”€β”€ kannada
49
- β”‚ β”œβ”€β”€ female
50
- β”‚ └── male
51
- β”œβ”€β”€ malayalam
52
- β”‚ β”œβ”€β”€ female
53
- β”‚ └── male
54
- β”œβ”€β”€ manipuri
55
- β”‚ β”œβ”€β”€ female
56
- β”‚ └── male
57
- β”œβ”€β”€ marathi
58
- β”‚ β”œβ”€β”€ female
59
- β”‚ └── male
60
- β”œβ”€β”€ odia
61
- β”‚ β”œβ”€β”€ female
62
- β”‚ └── male
63
- β”œβ”€β”€ punjabi
64
- β”‚ β”œβ”€β”€ female
65
- β”‚ └── male
66
- β”œβ”€β”€ rajasthani
67
- β”‚ β”œβ”€β”€ female
68
- β”‚ └── male
69
  β”œβ”€β”€ tamil
70
  β”‚ β”œβ”€β”€ female
71
  β”‚ └── male
72
- β”œβ”€β”€ telugu
73
- β”‚ β”œβ”€β”€ female
74
- β”‚ └── male
75
- └── urdu
76
  β”œβ”€β”€ female
77
  └── male
78
  ```
79
 
80
- Installation:
81
 
82
- create a virtual environment, and activate it:
83
  ```
84
  python3 -m venv tts-hs-hifigan
85
  source tts-hs-hifigan/bin/activate
86
  ```
87
- install requirements:
 
88
  ```
89
  pip install -r requirements.txt
90
  ```
91
- check if the app is running correctly, or look for any errors using commands below:
 
 
92
  ```
93
  python3 flask_app.py
94
  # OR
95
  gunicorn -w 2 -b 0.0.0.0:5000 flask_app:app --timeout 600
96
  ```
97
- If it's running without any problem. run the start command to start the server.
 
98
  ```
99
  bash start.sh
100
  ```
101
 
102
- ### Citation
103
  If you use this Fastspeech2 Model in your research or work, please consider citing:
104
 
105
  β€œ
 
4
  ---
5
 
6
  # Fastspeech2_HS_Flask_API
 
7
 
8
+ This repository contains the Flask API implementation of the Text to Speech Model developed by the Speech Lab at IIT Madras.
9
+ For a comprehensive understanding of the models and inference details, please consult the original repository
10
+ [Fastspeech2_HS](https://github.com/smtiitm/Fastspeech2_HS).
11
 
12
+ ### Table of Contents
13
+ - [Setup](#setup)
14
+ - [Installation](#installation)
15
+ - [Run Flask server](#run-flask-server)
16
+ - [Citation for the original repo](#citation-for-the-original-repo)
17
 
18
+ ### Setup
19
+ Some of the large files in this repo are uploaded using git lfs. Install latest git LFS by following the given commands:
20
+
21
+ Some of the large files in this repository have been uploaded using Git-LFS.
22
+ To ensure seamless handling of these files, please install Git-LFS by executing the provided commands:
23
 
24
  ```
25
  curl -s https://packagecloud.io/install/repositories/github/git-lfs/script.python.sh | bash
 
27
  git lfs install
28
  ```
29
 
30
+ The entire repository, including the models, has been uploaded to Hugging Face
31
+ "[Fastspeech2_HS_Flask_API](https://huggingface.co/k-m-irfan/Fastspeech2_HS_Flask_API)" due to size restrictions on GitHub for Git LFS.
32
+ To clone the repository from Hugging Face, please use the following command:
33
 
 
34
  ```
35
  git clone https://huggingface.co/k-m-irfan/Fastspeech2_HS_Flask_API
36
  ```
37
+
38
+ Alternatively, you can download the models from the original repository [Fastspeech2_HS](https://github.com/smtiitm/Fastspeech2_HS)
39
+ and organize the folder structure as specified below. Skip this step if already cloned the repository from Hugging Face.
40
 
41
  ```
42
  models
 
 
 
 
 
 
 
 
 
 
 
 
 
 
43
  β”œβ”€β”€ hindi
44
  β”‚ β”œβ”€β”€ female
45
  β”‚ └── male
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
46
  β”œβ”€β”€ tamil
47
  β”‚ β”œβ”€β”€ female
48
  β”‚ └── male
49
+ .
50
+ .
51
+ .
52
+ └── marathi
53
  β”œβ”€β”€ female
54
  └── male
55
  ```
56
 
57
+ ### Installation:
58
 
59
+ Create a virtual environment and activate it:
60
  ```
61
  python3 -m venv tts-hs-hifigan
62
  source tts-hs-hifigan/bin/activate
63
  ```
64
+
65
+ Install the required dependencies by running:
66
  ```
67
  pip install -r requirements.txt
68
  ```
69
+
70
+ ### Run Flask server:
71
+ Ensure the server application is running correctly before proceeding. Use the following commands and check for any errors:
72
  ```
73
  python3 flask_app.py
74
  # OR
75
  gunicorn -w 2 -b 0.0.0.0:5000 flask_app:app --timeout 600
76
  ```
77
+
78
+ If the application is running without any issues, proceed to start the server using the following command:
79
  ```
80
  bash start.sh
81
  ```
82
 
83
+ ### Citation for the original repo
84
  If you use this Fastspeech2 Model in your research or work, please consider citing:
85
 
86
  β€œ