Files changed (1) hide show
  1. README.md +38 -14
README.md CHANGED
@@ -1,14 +1,38 @@
1
- ---
2
- title: Programming Tutor Chatbot
3
- emoji: 🌍
4
- colorFrom: yellow
5
- colorTo: red
6
- sdk: gradio
7
- sdk_version: 6.2.0
8
- app_file: app.py
9
- pinned: false
10
- license: mit
11
- short_description: CodeMentor is a patient, knowledgeable programming tutor
12
- ---
13
-
14
- Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # CodeMentor - Programming Tutor Chatbot
2
+
3
+ A custom AI chatbot built with Gradio and GROQ API that serves as a personal programming tutor.
4
+
5
+ ## πŸš€ Features
6
+
7
+ - **Programming Tutor Personality**: Patient, encouraging, and knowledgeable
8
+ - **Multiple AI Models**: Choose between Llama 3 8B, 70B, or Mixtral
9
+ - **Language-Specific Focus**: Get tailored examples for Python, JavaScript, Java, etc.
10
+ - **Customizable Responses**: Adjust creativity and response length
11
+ - **Interactive UI**: Clickable example questions
12
+ - **Code Formatting**: Proper syntax highlighting for code examples
13
+
14
+ ## πŸ› οΈ Setup Instructions
15
+
16
+ ### 1. Get GROQ API Key
17
+ 1. Visit [https://console.groq.com](https://console.groq.com)
18
+ 2. Sign up and get your free API key
19
+ 3. Copy the key (starts with `gsk_`)
20
+
21
+ ### 2. Local Deployment
22
+ ```bash
23
+ # Clone or create project
24
+ mkdir programming-tutor-chatbot
25
+ cd programming-tutor-chatbot
26
+
27
+ # Create virtual environment (optional but recommended)
28
+ python -m venv venv
29
+ source venv/bin/activate # On Windows: venv\Scripts\activate
30
+
31
+ # Install dependencies
32
+ pip install -r requirements.txt
33
+
34
+ # Set environment variable (Windows: use set instead of export)
35
+ export GROQ_API_KEY="your-api-key-here"
36
+
37
+ # Run the application
38
+ python app.py