File size: 18,618 Bytes
554ae53
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
import streamlit as st
from streamlit_extras.switch_page_button import switch_page
from streamlit_extras.colored_header import colored_header
from streamlit_extras.card import card
from dataclasses import dataclass
from typing import Dict, List, Optional, Tuple
from duckduckgo_search import DDGS
from groq import Groq
import logging
from enum import Enum

# Set page configuration
st.set_page_config(
    page_title="Course compass ",
    page_icon="πŸ“š",
    layout="wide",
    initial_sidebar_state="auto"
)

st.markdown("""
    <style>
    .stProgress .st-bo {
        background-color: #3b71ca;
    }
    .stButton button {
        background-color: #3b71ca;
        color: white;
        border-radius: 20px;
        padding: 0.5rem 2rem;
        border: none;
    }
    .stButton button:hover {
        background-color: #2c5494;
    }
    .recommendation-card {
        border: 1px solid #e0e0e0;
        border-radius: 10px;
        padding: 20px;
        margin: 10px 0;
        background-color: white;
    }
    </style>
    """, unsafe_allow_html=True)

# Define Enums
class LearningFormat(str, Enum):
    VIDEO = "Video Lectures"
    INTERACTIVE = "Interactive Exercises"
    TEXT = "Text-based Content"
    PROJECT = "Project-based Learning"
    BLENDED = "Blended Learning"

class ExperienceLevel(str, Enum):
    BEGINNER = "Beginner"
    INTERMEDIATE = "Intermediate"
    ADVANCED = "Advanced"
    EXPERT = "Expert"

class CareerGoal(str, Enum):
    KNOWLEDGE = "Knowledge Acquisition"
    PROFESSIONAL = "Professional Development"
    CAREER = "Career Transition"
    ACADEMIC = "Academic Requirement"

@dataclass
class UserPreferences:
    name: str
    subject: str
    availability: str
    budget: int
    format: LearningFormat
    experience: ExperienceLevel
    goal: CareerGoal

class CourseRecommender:
    def __init__(self, api_key: str):
        self.groq_client = Groq(api_key=api_key)  # Use the passed api_key parameter

    def generate_recommendations(self, preferences: UserPreferences) -> Tuple[str, Optional[List[Dict]]]:
        try:
            prompt = self._create_prompt(preferences)
            response = self._get_ai_response(prompt)
            search_results = self._get_additional_resources(preferences.subject)
            return response, search_results
        except Exception as e:
            logging.error(f"Error generating recommendations: {str(e)}")
            return str(e), None  # Return the error message as the first element

    def _create_prompt(self, preferences: UserPreferences) -> str:
        return f"""As a course recommendation expert, suggest 3-5 specific courses for someone with these preferences:
        - Name: {preferences.name}
        - Subject: {preferences.subject}
        - Time available: {preferences.availability}
        - Budget: ${preferences.budget}
        - Preferred format: {preferences.format}
        - Experience level: {preferences.experience}
        - Learning goal: {preferences.goal}

        For each course, include:
        1. Course title and platform
        2. Price and duration
        3. Key features
        4. Why it matches their preferences
        5.link to redirect to the course
        
        Format the response in clear, readable markdown."""

    def _get_ai_response(self, prompt: str) -> str:
        response = self.groq_client.chat.completions.create(
            messages=[
                {
                    "role": "system",
                    "content": "You are a helpful course recommendation assistant."
                },
                {
                    "role": "user",
                    "content": prompt
                }
            ],
            model="mixtral-8x7b-32768",
            temperature=0.7,
            max_tokens=2048
        )
        return response.choices[0].message.content

    def _get_additional_resources(self, subject: str) -> List[Dict]:
        try:
            with DDGS() as ddgs:
                results = list(ddgs.text(
                    f"learn {subject} course tutorial guide",
                    max_results=5
                ))
            return results
        except Exception as e:
            logging.error(f"Error fetching additional resources: {str(e)}")
            return []

class StreamlitUI:
    def __init__(self):
        self.initialize_session_state()
        
    def initialize_session_state(self):
        if 'initialized' not in st.session_state:
            st.session_state.update({
                'initialized': True,
                'step': 0,
                'user_responses': {},
                'ready_for_recommendations': False,
                'recommendations_generated': False,
                'current_recommendations': None,
                'current_results': None,
                'error_message': None,
                'theme_color': '#3b71ca',
                'api_key_valid': False,
                'api_key': None
            })

    def validate_api_key(self, api_key: str) -> bool:
        """Validate if the API key is in the correct format."""
        return api_key.startswith('gsk_') and len(api_key) > 20

    def render_questionnaire(self) -> bool:
        questions = [
            ("Please enter your name:", "user_name", None),
            ("What subject or skill would you like to learn?", "subject", None),
            ("How many hours per week can you dedicate to learning?", "availability", 
             ["1-2 hours", "3-5 hours", "6-10 hours", "More than 10 hours"]),
            ("What is your maximum budget for this course?", "budget", None),
            ("What is your preferred learning format?", "format", [f.value for f in LearningFormat]),
            ("What is your current experience level?", "experience", [e.value for e in ExperienceLevel]),
            ("What is your primary goal?", "goal", [g.value for g in CareerGoal])
        ]

        if st.session_state.step >= len(questions):
            return self.handle_questionnaire_completion()

        # Create a container for the questionnaire
        with st.container():
            colored_header(
                label=f"Step {st.session_state.step + 1} of {len(questions)}",
                description="Tell us about your learning preferences",
                color_name="blue-70"
            )

            progress = min(st.session_state.step / (len(questions) - 1), 1.0)
            st.progress(progress)

            current_question = questions[st.session_state.step]
            return self.handle_current_question(current_question)

    def handle_current_question(self, question_data: Tuple) -> bool:
        question, key, options = question_data
        
        with st.form(key=f"question_form_{key}"):
            st.write(f"### {question}")
            
            if options:
                user_input = st.selectbox(
                    "Choose an option:",
                    options,
                    key=f"input_{key}",
                    help=f"Select your preferred {key}"
                )
            elif key == "budget":
                budget_ranges = [
                    {"label": "Free Courses Only", "value": 0},
                    {"label": "Under $50", "value": 50},
                    {"label": "$50 - $100", "value": 100},
                    {"label": "$100 - $200", "value": 200},
                    {"label": "$200 - $500", "value": 500},
                    {"label": "$500 - $1000", "value": 1000},
                    {"label": "Over $1000", "value": 1500}
                ]
                
                selected_range = st.radio(
                    "Select your budget range:",
                    options=[r["label"] for r in budget_ranges],
                    key="budget_range",
                    horizontal=True,
                    help="Choose your preferred budget range for the course"
                )
                
                # Get the corresponding value for the selected range
                user_input = next(
                    (r["value"] for r in budget_ranges if r["label"] == selected_range),
                    100
                )
            else:
                user_input = st.text_input(
                    "Your answer:",
                    key=f"input_{key}",
                    placeholder=f"Enter your {key.replace('_', ' ')}",
                    help=f"Enter your {key.replace('_', ' ')}"
                )

            submit_button = st.form_submit_button(
                "Next" if st.session_state.step < 6 else "Get Recommendations"
            )

            if submit_button and (user_input or user_input == 0):
                self.save_user_input(key, user_input)
                st.session_state.step += 1
                st.rerun()

        return False

    def save_user_input(self, key: str, user_input: str):
        st.session_state.user_responses[key] = user_input

    def handle_questionnaire_completion(self) -> bool:
        """Handle the completion of the questionnaire and prepare for recommendations."""
        try:
            if not all(key in st.session_state.user_responses for key in ['user_name', 'subject', 'availability', 'budget', 'format', 'experience', 'goal']):
                st.error("Please complete all questions before proceeding.")
                self.reset_session()
                return False

            preferences = UserPreferences(
                name=st.session_state.user_responses['user_name'],
                subject=st.session_state.user_responses['subject'],
                availability=st.session_state.user_responses['availability'],
                budget=int(st.session_state.user_responses['budget']),
                format=st.session_state.user_responses['format'],
                experience=st.session_state.user_responses['experience'],
                goal=st.session_state.user_responses['goal']
            )
            
            with st.spinner('Generating recommendations...'):
                recommendations, additional_results = self.recommender.generate_recommendations(preferences)
                
                if isinstance(recommendations, str) and "Error" in recommendations:
                    st.error(recommendations)
                    return False
                
                st.session_state.current_recommendations = recommendations
                st.session_state.current_results = additional_results
                st.session_state.ready_for_recommendations = True
                st.session_state.recommendations_generated = True
                st.session_state.user_name = preferences.name
                
                return True
        except Exception as e:
            st.error(f"An error occurred: {str(e)}")
            logging.error(f"Error in handle_questionnaire_completion: {str(e)}")
            return False

    def reset_session(self):
        """Reset the session state to initial values."""
        api_key = st.session_state.api_key  # Preserve API key
        api_key_valid = st.session_state.api_key_valid  # Preserve API key validation status
        st.session_state.clear()
        st.session_state.update({
            'step': 0,
            'user_responses': {},
            'ready_for_recommendations': False,
            'recommendations_generated': False,
            'current_recommendations': None,
            'current_results': None,
            'error_message': None,
            'api_key': api_key,
            'api_key_valid': api_key_valid
        })

    def display_recommendations(self):
        if st.session_state.error_message:
            st.error(st.session_state.error_message)
            if st.button("Try Again", use_container_width=True):
                self.reset_session()
                st.rerun()
            return

        if not st.session_state.current_recommendations:
            st.warning("No recommendations available. Please start a new search.")
            if st.button("Start New Search", use_container_width=True):
                self.reset_session()
                st.rerun()
            return

        colored_header(
            label=f"Personalized Course Recommendations for {st.session_state.user_name}",
            description="Based on your preferences, we recommend the following courses:",
            color_name="blue-70"
        )

        # Display recommendations in a modern card layout
        col1, col2 = st.columns([7, 3])
        
        with col1:
            with st.container():
                st.markdown(
                    f"""<div class="recommendation-card">
                        {st.session_state.current_recommendations}
                    </div>""", 
                    unsafe_allow_html=True
                )

        with col2:
            with st.container():
                st.write("### Quick Summary")
                st.info(f"""
                **Selected Preferences:**
                - Subject: {st.session_state.user_responses.get('subject')}
                - Format: {st.session_state.user_responses.get('format')}
                - Level: {st.session_state.user_responses.get('experience')}
                """)

                if st.button("Start New Search", key="new_search", use_container_width=True):
                    self.reset_session()
                    st.rerun()

            # Additional resources in a collapsible section
            with st.expander("πŸ“š Additional Learning Resources", expanded=False):
                if st.session_state.current_results:
                    for result in st.session_state.current_results[:3]:
                        card(
                            title=result['title'],
                            text=result['body'],
                            url=result['href']
                        )
                else:
                    st.info("No additional resources found.")

        st.markdown("---")
        
        # Footer with helpful information
        col1, col2, col3 = st.columns(3)
        with col1:
            st.info("πŸ” Verify course details on respective platforms")
        with col2:
            st.info("πŸ’‘ Consider prerequisites before enrolling")
        with col3:
            st.info("πŸ“… Check course start dates and deadlines")

    def generate_recommendations(self):
        """Generate course recommendations based on user preferences."""
        try:
            preferences = UserPreferences(
                name=st.session_state.user_responses.get('user_name', ''),
                subject=st.session_state.user_responses.get('subject', ''),
                availability=st.session_state.user_responses.get('availability', ''),
                budget=int(st.session_state.user_responses.get('budget', 0)),
                format=st.session_state.user_responses.get('format', ''),
                experience=st.session_state.user_responses.get('experience', ''),
                goal=st.session_state.user_responses.get('goal', '')
            )

            with st.spinner('Generating personalized course recommendations...'):
                recommendations, additional_results = self.recommender.generate_recommendations(preferences)
                
                if recommendations:
                    st.session_state.current_recommendations = recommendations
                    st.session_state.current_results = additional_results
                    st.session_state.recommendations_generated = True
                    st.session_state.user_name = preferences.name
                else:
                    st.session_state.error_message = "Unable to generate recommendations. Please try again."
                
                st.rerun()

        except Exception as e:
            st.session_state.error_message = f"Error generating recommendations: {str(e)}"
            st.rerun()

    def run(self):
        with st.sidebar:
            st.image("logo.png")
            st.markdown("---")
            
            # Add API key input section with updated instructions
            st.markdown("### Groq API Key Setup")
            st.markdown("""
            To use the course recommender, you need a Groq API key.
            If you don't have one, you can get it from:
            [Groq Console](https://console.groq.com/keys) πŸ”‘
            """)
            
            api_key = st.text_input(
                "Enter your Groq API Key:",
                type="password",
                help="Enter your Groq API key to use the course recommender",
                key="api_key_input"
            )
            
            if api_key:
                if self.validate_api_key(api_key):
                    st.session_state.api_key = api_key
                    st.session_state.api_key_valid = True
                    self.recommender = CourseRecommender(api_key=api_key)
                else:
                    st.error("Invalid Groq API key format. It should start with 'gsk_'")
                    st.session_state.api_key_valid = False
            
            st.markdown("---")
            st.markdown("""
            ### How it works
            1. Share your preferences
            2. Get personalized recommendations
            3. Explore course options
            """)
            st.markdown("---")
            if st.button("Reset Application", use_container_width=True):
                self.reset_session()
                st.rerun()

        # Main content area with improved API key validation message
        if not st.session_state.api_key_valid:
            st.error("⚠️ Please enter your Groq API key in the sidebar to use the course recommender.")
            st.info("Don't have an API key? Get one for free from [Groq Console](https://console.groq.com/keys)")
            return

        # Main content area with error handling
        try:
            if not st.session_state.ready_for_recommendations:
                if self.render_questionnaire():
                    st.session_state.ready_for_recommendations = True
                    st.rerun()
            elif st.session_state.recommendations_generated:
                self.display_recommendations()
            else:
                self.generate_recommendations()
        except Exception as e:
            st.error(f"An unexpected error occurred: {str(e)}")
            logging.error(f"Error in main UI flow: {str(e)}")
            if st.button("Start Over"):
                self.reset_session()
                st.rerun()

def main():
    app = StreamlitUI()
    app.run()

if __name__ == "__main__":
    main()