# 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

---