File size: 3,495 Bytes
5a1bc87
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
549f6a6
5a1bc87
 
 
 
 
 
 
 
 
 
 
549f6a6
5a1bc87
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
549f6a6
5a1bc87
 
 
282fafd
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
---
title: Base Course Personalization
emoji: πŸ“š
colorFrom: purple
colorTo: indigo
sdk: streamlit
sdk_version: "1.37.0"
app_file: app.py
pinned: false
---

# Base Course Personalization

![Banner](https://img.shields.io/badge/Streamlit-App-FF4B4B?style=for-the-badge&logo=streamlit&logoColor=white)
![Python](https://img.shields.io/badge/Python-3.7+-blue?style=for-the-badge&logo=python&logoColor=white)

## πŸ“š Overview

Base Course Personalization is an interactive web application that tailors educational content to match individual learning preferences. By collecting user profile information and preferences, the system generates personalized course materials optimized for each learner's unique needs.

## ✨ Features

- **Personalized User Profiles**: Customize learning experiences based on user demographics and preferences
- **Adaptive Learning Styles**: Support for visual, auditory, and kinesthetic learning approaches
- **Language Customization**: Set your preferred language and voice settings
- **Technical Preferences**: Specify programming language preferences
- **Dark Mode Interface**: Easy-on-the-eyes interface for extended learning sessions

## πŸš€ Quick Start

The application is hosted on Hugging Face Spaces. You can access it here:

[Launch Base Course Personalization App](https://huggingface.co/spaces/banao-tech/base-course-personalization)

## πŸ› οΈ Local Development

### Prerequisites
- Python 3.7+
- Streamlit

### Installation

1. Clone this repository
```bash
git clone https://github.com/banao-tech/base-course-personalization.git
cd base-course-personalization
```

2. Install dependencies
```bash
pip install -r requirements.txt
```

3. Run the application
```bash
streamlit run main.py
```

## πŸ“‹ How It Works

1. **Fill Your Profile**: Enter personal details and preferences
2. **Specify Learning Style**: Choose your preferred learning style (visual, auditory, kinesthetic)
3. **Set Language Preferences**: Select language settings and voice preferences
4. **Submit**: Generate your personalized course structure
5. **View Results**: See your personalized course outline and settings

## πŸ”§ Technical Details

The application generates a JSON payload that can be processed by the backend learning management system to create personalized course content. Key components include:

- **User Profile**: Demographic and preference information
- **Topics**: Course structure and content links
- **Settings**: Language, voice, and technical preferences

### API Integration

The application integrates with a personalization API that processes the user preferences and returns customized course content. The API endpoint accepts POST requests with a JSON payload containing all collected user information.

```python
# Example API call
import requests

response = requests.post(
    "https://api.example.com/personalize-course", 
    json=payload
)
```

Response format:
```json
{
  "success": true,
  "course_id": "personalized-123",
  "topics": [...]
}
```

## πŸ”’ Privacy

All data is processed in the browser and is not stored unless explicitly submitted to the API. Your preferences are used solely to tailor the learning experience.

## πŸ“ License

This project is licensed under the MIT License - see the LICENSE file for details.

## πŸ‘₯ Contact

For questions, feedback, or support, please [open an issue](https://github.com/banao-tech/base-course-personalization/issues).

---

Β© 2025 Base Course Personalization | All Rights Reserved