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
Files changed (1) hide show
  1. README.md +32 -9
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
- ### Installation
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
28
 
29
  1. Create and activate the virtual environment:
30
-
31
- ```sh
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. Configure environment variables:
 
 
 
 
 
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
- 4. Run the application:
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