89 lines
2.9 KiB
Markdown
89 lines
2.9 KiB
Markdown
# AI Fluency – Personal Learning Plan Generator
|
||
|
||
**AI‑Fluency** is a lightweight Python utility that builds a personalized learning plan for anyone looking to improve their skills in artificial intelligence and related fields.
|
||
Given a user profile (name, experience level, interests) the script produces a step‑by‑step roadmap with suggested resources, projects, and milestones.
|
||
|
||
> **Why this project?**
|
||
> Many people struggle to structure their AI education. This tool removes guesswork by automatically generating a curriculum tailored to your current level and passions.
|
||
|
||
---
|
||
|
||
## 📦 Installation
|
||
|
||
The project depends on the following Python packages:
|
||
|
||
| Package | Purpose |
|
||
|---------|---------|
|
||
| `rich` | Pretty console output (tables, colors) |
|
||
|
||
```bash
|
||
# Clone the repo
|
||
git clone https://github.com/your-username/ai-fluency.git
|
||
cd ai-fluency
|
||
|
||
# Create a virtual environment (recommended)
|
||
python -m venv .venv
|
||
source .venv/bin/activate # Windows: .\.venv\Scripts\activate
|
||
|
||
# Install dependencies
|
||
pip install rich
|
||
```
|
||
|
||
> **Tip:** If you prefer `pipx` or Docker, feel free to adapt the instructions accordingly.
|
||
|
||
---
|
||
|
||
## 📄 Usage
|
||
|
||
1. **Create a user profile** – a JSON file that describes your background and interests.
|
||
|
||
```json
|
||
{
|
||
"name": "Иван",
|
||
"experience_level": "beginner", // beginner | intermediate | advanced
|
||
"interests": ["machine learning", "NLP"]
|
||
}
|
||
```
|
||
|
||
2. **Run the script** – it will load the profile, generate a plan, and display it in a nicely formatted table.
|
||
|
||
```bash
|
||
python solution.py path/to/profile.json
|
||
```
|
||
|
||
3. **Result**
|
||
|
||
```
|
||
✅ Профиль пользователя загружен: Иван
|
||
|
||
┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
|
||
│ Этап │ Описание │
|
||
┠────────────────╪───────────────────────────────┨
|
||
│ 1. Основы Python│ Изучить синтаксис, типы данных│
|
||
│ 2. ML Intro │ Курс по машинному обучению │
|
||
│ … │ … │
|
||
┗━━━━━━━━━━━━━━━┻━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
|
||
```
|
||
|
||
> The table will contain as many stages as the generator decides based on your level and interests.
|
||
|
||
---
|
||
|
||
## 🔧 Extending the Generator
|
||
|
||
The core logic lives in `solution.py`.
|
||
Feel free to:
|
||
|
||
- Add more experience levels.
|
||
- Expand the mapping of interests → resources.
|
||
- Hook up a real database or API for dynamic content.
|
||
|
||
Just modify the `generate_plan` function – it returns a list of dictionaries that are rendered by `rich`.
|
||
|
||
---
|
||
|
||
## 📄 License
|
||
|
||
MIT © 2026 AI‑Fluency Project
|
||
|
||
--- |