Spaces:
Running
Running
zach
commited on
Commit
Β·
e898abd
1
Parent(s):
a4e10c8
Update README to include instructions to install pre-commit hook, and include project structure
Browse files
README.md
CHANGED
@@ -24,22 +24,46 @@ Expressive TTS Arena is an open-source web application that enables users to com
|
|
24 |
- API keys for Hume AI, Anthropic, and ElevenLabs
|
25 |
- For a complete list of dependencies, see requirements.
|
26 |
|
27 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
28 |
|
29 |
1. Create and activate the virtual environment:
|
30 |
-
|
31 |
-
|
32 |
-
python -m venv gradio-env
|
33 |
source gradio-env/bin/activate # On Windows, use: gradio-env\Scripts\activate
|
34 |
```
|
35 |
|
36 |
2. Install dependencies:
|
37 |
-
|
38 |
```sh
|
39 |
pip install -r requirements.txt
|
40 |
```
|
41 |
|
42 |
-
3.
|
|
|
|
|
|
|
|
|
|
|
43 |
- Create a `.env` file based on `.env.example`
|
44 |
- Add your API keys:
|
45 |
|
@@ -49,9 +73,8 @@ Expressive TTS Arena is an open-source web application that enables users to com
|
|
49 |
ELEVENLABS_API_KEY=YOUR_ELEVENLABS_API_KEY
|
50 |
```
|
51 |
|
52 |
-
|
53 |
-
|
54 |
-
```sh
|
55 |
watchfiles "python -m src.app"`
|
56 |
```
|
57 |
|
|
|
24 |
- API keys for Hume AI, Anthropic, and ElevenLabs
|
25 |
- For a complete list of dependencies, see requirements.
|
26 |
|
27 |
+
## Project Structure
|
28 |
+
```
|
29 |
+
Expressive TTS Arena/
|
30 |
+
βββ src/
|
31 |
+
β βββ integrations/
|
32 |
+
β β βββ __init__.py # Makes integrations a package; exposes API clients
|
33 |
+
β β βββ anthropic_api.py # Anthropic API integration
|
34 |
+
β β βββ elevenlabs_api.py # ElevenLabs API integration
|
35 |
+
β β βββ hume_api.py # Hume API integration
|
36 |
+
β βββ __init__.py # Makes src a package; exposes key functionality
|
37 |
+
β βββ app.py # Entry file
|
38 |
+
β βββ config.py # Global config and logger setup
|
39 |
+
β βββ constants.py # Global constants
|
40 |
+
β βββ theme.py # Custom Gradio Theme
|
41 |
+
β βββ utils.py # Utility functions
|
42 |
+
βββ .env.example
|
43 |
+
βββ .gitignore
|
44 |
+
βββ .pre-commit-config.yaml
|
45 |
+
βββ requirements.txt
|
46 |
+
```
|
47 |
+
|
48 |
+
## Installation
|
49 |
|
50 |
1. Create and activate the virtual environment:
|
51 |
+
```
|
52 |
+
sh python -m venv gradio-env
|
|
|
53 |
source gradio-env/bin/activate # On Windows, use: gradio-env\Scripts\activate
|
54 |
```
|
55 |
|
56 |
2. Install dependencies:
|
|
|
57 |
```sh
|
58 |
pip install -r requirements.txt
|
59 |
```
|
60 |
|
61 |
+
3. Install pre-commit hook for automatic file formatting:
|
62 |
+
```sh
|
63 |
+
pre-commit install
|
64 |
+
```
|
65 |
+
|
66 |
+
4. Configure environment variables:
|
67 |
- Create a `.env` file based on `.env.example`
|
68 |
- Add your API keys:
|
69 |
|
|
|
73 |
ELEVENLABS_API_KEY=YOUR_ELEVENLABS_API_KEY
|
74 |
```
|
75 |
|
76 |
+
5. Run the application:
|
77 |
+
```sh
|
|
|
78 |
watchfiles "python -m src.app"`
|
79 |
```
|
80 |
|