Alirezamp commited on
Commit
137b499
Β·
verified Β·
1 Parent(s): b1ff431

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +119 -108
README.md CHANGED
@@ -1,109 +1,120 @@
1
- # Voice-Enabled Chat Application
2
-
3
- This is a web-based chat application that allows users to interact with a personal assistant through both text and voice. It features a clean user interface with light and dark modes and voice input.
4
-
5
- ## Features
6
-
7
- - **Personal Assistant:** The backend is powered by the Groq API to provide helpful and conversational responses.
8
- - **Text and Voice Input:** Users can type messages or use their microphone to speak to the assistant.
9
- - **Light/Dark Mode:** The user interface can be switched between light and dark themes for user comfort.
10
- - **Multi-language Speech-to-Text:** Users can select from multiple languages for speech-to-text transcription.
11
- - **Docker Support:** The application can be easily containerized and deployed using Docker.
12
-
13
- ## Technologies Used
14
-
15
- - **Docker**
16
-
17
- ### Frontend
18
-
19
- - HTML5
20
- - CSS3
21
- - JavaScript
22
- - jQuery
23
- - Bootstrap
24
- - Font Awesome
25
-
26
- ### Backend
27
-
28
- - Python
29
- - Flask
30
- - Flask-Cors
31
- - Groq API
32
- - SpeechRecognition
33
-
34
- ## Prerequisites
35
-
36
- - Python 3.x
37
- - `pip` for installing Python packages
38
- - A Groq API key
39
-
40
- ## Installation and Setup
41
-
42
- 1. **Clone the repository:**
43
-
44
- ```bash
45
- git clone https://github.com/your-username/chatapp-with-voice.git
46
- cd chatapp-with-voice
47
- ```
48
-
49
- 2. **Create a virtual environment (optional but recommended):**
50
-
51
- ```bash
52
- python -m venv env
53
- source env/bin/activate # On Windows, use `env\Scripts\activate`
54
- ```
55
-
56
- 3. **Install the required Python packages:**
57
-
58
- ```bash
59
- pip install -r requirements.txt
60
- ```
61
-
62
- 4. **Set up your environment variables:**
63
-
64
- Create a `.env` file in the root of the project and add your Groq API key:
65
-
66
- ```
67
- GROQ_API_KEY=your_groq_api_key
68
- ```
69
-
70
- ## Usage
71
-
72
- To run the application, execute the following command from the root of the project:
73
-
74
- ```bash
75
- python -u server.py
76
- ```
77
-
78
- The application will be available at `http://localhost:8000`.
79
-
80
- ## Project Structure
81
-
82
- ```
83
- .
84
- β”œβ”€β”€ Dockerfile
85
- β”œβ”€β”€ LICENSE
86
- β”œβ”€β”€ README.md
87
- β”œβ”€β”€ requirements.txt
88
- β”œβ”€β”€ server.py
89
- β”œβ”€β”€ static
90
- β”‚ β”œβ”€β”€ js
91
- β”‚ β”‚ β”œβ”€β”€ WebAudioRecorder.min.js
92
- β”‚ β”‚ └── WebAudioRecorderWav.min.js
93
- β”‚ β”œβ”€β”€ script.js
94
- β”‚ └── style.css
95
- β”œβ”€β”€ templates
96
- β”‚ └── index.html
97
- └── worker.py
98
- ```
99
-
100
- - `server.py`: The main Flask application file that handles routing and serves the web pages.
101
- - `worker.py`: Contains the core logic for speech-to-text and processing user messages with the Groq API.
102
- - `static/`: Contains the frontend JavaScript and CSS files.
103
- - `templates/`: Contains the HTML templates for the web pages.
104
- - `requirements.txt`: A list of the Python packages required for the project.
105
- - `Dockerfile`: Allows for building a Docker image of the application.
106
-
107
- ## License
108
-
 
 
 
 
 
 
 
 
 
 
 
109
  This project is licensed under the terms of the Apache-2.0 license. See the `LICENSE` file for more details.
 
1
+
2
+ ---
3
+ title: Voice Chat Assistant
4
+ emoji: 🐒
5
+ colorFrom: gray
6
+ colorTo: blue
7
+ sdk: docker
8
+ pinned: false
9
+ license: apache-2.0
10
+ ---
11
+
12
+ # Voice-Enabled Chat Application
13
+
14
+ This is a web-based chat application that allows users to interact with a personal assistant through both text and voice. It features a clean user interface with light and dark modes and voice input.
15
+
16
+ ## Features
17
+
18
+ - **Personal Assistant:** The backend is powered by the Groq API to provide helpful and conversational responses.
19
+ - **Text and Voice Input:** Users can type messages or use their microphone to speak to the assistant.
20
+ - **Light/Dark Mode:** The user interface can be switched between light and dark themes for user comfort.
21
+ - **Multi-language Speech-to-Text:** Users can select from multiple languages for speech-to-text transcription.
22
+ - **Docker Support:** The application can be easily containerized and deployed using Docker.
23
+
24
+ ## Technologies Used
25
+
26
+ - **Docker**
27
+
28
+ ### Frontend
29
+
30
+ - HTML5
31
+ - CSS3
32
+ - JavaScript
33
+ - jQuery
34
+ - Bootstrap
35
+ - Font Awesome
36
+
37
+ ### Backend
38
+
39
+ - Python
40
+ - Flask
41
+ - Flask-Cors
42
+ - Groq API
43
+ - SpeechRecognition
44
+
45
+ ## Prerequisites
46
+
47
+ - Python 3.x
48
+ - `pip` for installing Python packages
49
+ - A Groq API key
50
+
51
+ ## Installation and Setup
52
+
53
+ 1. **Clone the repository:**
54
+
55
+ ```bash
56
+ git clone https://github.com/your-username/chatapp-with-voice.git
57
+ cd chatapp-with-voice
58
+ ```
59
+
60
+ 2. **Create a virtual environment (optional but recommended):**
61
+
62
+ ```bash
63
+ python -m venv env
64
+ source env/bin/activate # On Windows, use `env\Scripts\activate`
65
+ ```
66
+
67
+ 3. **Install the required Python packages:**
68
+
69
+ ```bash
70
+ pip install -r requirements.txt
71
+ ```
72
+
73
+ 4. **Set up your environment variables:**
74
+
75
+ Create a `.env` file in the root of the project and add your Groq API key:
76
+
77
+ ```
78
+ GROQ_API_KEY=your_groq_api_key
79
+ ```
80
+
81
+ ## Usage
82
+
83
+ To run the application, execute the following command from the root of the project:
84
+
85
+ ```bash
86
+ python -u server.py
87
+ ```
88
+
89
+ The application will be available at `http://localhost:8000`.
90
+
91
+ ## Project Structure
92
+
93
+ ```
94
+ .
95
+ β”œβ”€β”€ Dockerfile
96
+ β”œβ”€β”€ LICENSE
97
+ β”œβ”€β”€ README.md
98
+ β”œβ”€β”€ requirements.txt
99
+ β”œβ”€β”€ server.py
100
+ β”œβ”€β”€ static
101
+ β”‚ β”œβ”€β”€ js
102
+ β”‚ β”‚ β”œβ”€β”€ WebAudioRecorder.min.js
103
+ β”‚ β”‚ └── WebAudioRecorderWav.min.js
104
+ β”‚ β”œβ”€β”€ script.js
105
+ β”‚ └── style.css
106
+ β”œβ”€β”€ templates
107
+ β”‚ └── index.html
108
+ └── worker.py
109
+ ```
110
+
111
+ - `server.py`: The main Flask application file that handles routing and serves the web pages.
112
+ - `worker.py`: Contains the core logic for speech-to-text and processing user messages with the Groq API.
113
+ - `static/`: Contains the frontend JavaScript and CSS files.
114
+ - `templates/`: Contains the HTML templates for the web pages.
115
+ - `requirements.txt`: A list of the Python packages required for the project.
116
+ - `Dockerfile`: Allows for building a Docker image of the application.
117
+
118
+ ## License
119
+
120
  This project is licensed under the terms of the Apache-2.0 license. See the `LICENSE` file for more details.