🧠 BrainStorm v2.0 — Osobní AI Mentor & Druhý Mozek

Osobní AI mentor a interaktivní "druhý mozek" pro hluboké učení. Postavený na Gemini API, Obsidianu a Pythonu.

Systém tě interaktivně provede strukturovaným učením jakéhokoli tématu — od upřesnění cíle, přes vytvoření detailní roadmapy s kvízy, až po automatické odškrtávání po splnění.

---

🚀 Rychlý start

1. Nainstaluj závislosti

py -m pip install -r requirements.txt

2. Nastav API klíč

Otevři soubor .env a vlož svůj Gemini API klíč:

GEMINI_API_KEY=tvůj_skutečný_api_klíč

3. Inicializuj vault

py run.py init

4. Otevři vault v Obsidianu

Otevři složku vault/ jako nový vault v Obsidianu.

Doporučené pluginy:

• Dataview — dynamické dotazy nad poznámkami (frontmatter)
• Templater — pokročilé šablony a automatizace

5. Začni se učit! (Generování kostry)

python run.py learn "Chci znát základy marketingu"

Systém se tě interaktivně zeptá (šipkami vybíráš odpovědi):

1. Úroveň znalostí — začátečník → pokročilý
2. Čas na studium — kolik hodin týdně
3. Styl učení — videa, čtení, praxe...
4. Hloubka — přehled → expert
5. + dynamické otázky specifické pro tvoje téma

Pak AI vygeneruje kompletní roadmapu úkolů a v reálném čase (s progress barem) vytvoří i veškerý výukový obsah a kvízy.

6. Testování znalostí (Kvíz)

Až dokončíš úkol z roadmapy, ověř si znalosti:

python run.py quiz

Vyber si připravený úkol, zodpověz 4 rychlé otázky + 1 otevřenou. Po úspěchu se task automaticky odškrtne ✅.

---

📋 CLI příkazy

Příkaz	Popis
python run.py init	🏗️ Inicializace vault struktury
python run.py learn "cíl"	📚 Spuštění nového učebního cyklu (kostra)
python run.py prepare	⚡ Lazy Loading: vygenerování obsahu pro úkol
python run.py quiz	🎮 Interaktivní kvíz s automatickým odškrtáváním
python run.py status	📊 Přehled progressu a statistik

---

📖 Jak to funguje

1. python run.py learn "cíl" ← zadáš učební cíl
2. AI se zeptá (šipkami)    ← upřesňující otázky
3. Vygeneruje roadmapu      ← struktura kroků a úkolů
4. Uloží do Obsidianu       ← prázdné úkoly čekající na přípravu

5. python run.py prepare     ← vybereš si úkol ke studiu
6. Generuje detaily          ← AI naplní soubor videi, texty a kvízem

7. python run.py quiz        ← splň kvíz
8. Automatické odškrtnutí    ← task se sám odškrtne ✅

Co každý sub-task soubor obsahuje:

• 📖 Co se naučíš — detailní postup krok za krokem
• 🔍 Co hledat — konkrétní YouTube videa, knihy, články
• 📝 Klíčové pojmy — tabulka s definicemi
• 📓 NotebookLM — instrukce pro poloautomatické učení
• ❓ Kvíz — 4 rychlé + 1 otevřená otázka (odpovědi ve spoileru)
• 🔗 Navigace — odkazy na předchozí/další krok (chaining)

---

🏗️ Architektura

Python CLI (questionary + rich)
    → Orchestrátor
        → PlannerAgent (Gemini API)
            1. generate_questions()    → interaktivní otázky
            2. generate_roadmap()      → struktura kroků
            3. generate_subtask_detail() → detaily + kvízy
        → FileManager
            → Templates → Obsidian Vault (.md soubory)
            → _quizzes.json (data pro interaktivní kvíz)
            → mark_task_complete() (auto-odškrtnutí)

---

📁 Struktura vygenerované roadmapy

vault/01_Roadmaps/Marketing/
├── _roadmap.md                    ← hlavní rozcestník + manuál
├── 01_zaklady_marketingu/
│   ├── metabox.md                 ← kontext kroku (co/proč/jak)
│   ├── tasks.md                   ← přehled úkolů s checkboxy
│   ├── 01_co_je_marketing.md      ← detailní sub-task + kvíz
│   ├── 02_cilove_skupiny.md       ← detailní sub-task + kvíz
│   ├── 03_analyza_trhu.md         ← detailní sub-task + kvíz
│   ├── _quizzes.json              ← kvíz data pro CLI
│   └── notes/                     ← tvoje vlastní poznámky
├── 02_digitalni_marketing/
│   ├── ...

---

📁 Struktura projektu

BrainStorm/
├── .env                    # API klíč
├── run.py                  # CLI vstupní bod
├── requirements.txt        # Závislosti
├── src/                    # Zdrojový kód
│   ├── main.py             # CLI příkazy (learn, quiz, status)
│   ├── config.py           # Konfigurace
│   ├── agents/             # AI agenti
│   │   ├── base_agent.py   # Základ — Gemini API wrapper
│   │   └── planner_agent.py # Plánovač — otázky, roadmapa, detaily
│   ├── core/               # Jádro systému
│   │   └── orchestrator.py # Koordinátor celého pipeline
│   └── vault/              # Správa Obsidian vaultu
│       ├── file_manager.py # Vytváření souborů + odškrtávání
│       └── templates.py    # Markdown šablony
├── vault/                  # Obsidian Vault (data)
│   ├── 00_Inbox/
│   ├── 01_Roadmaps/
│   ├── 02_Knowledge/
│   ├── 03_Reviews/
│   ├── 04_Debates/
│   └── _system/            # Systémové JSON soubory
└── materials/              # Studijní materiály (pro RAG)

---

⚙️ Tech Stack

• Python 3.12+
• Gemini 2.5 Flash — AI mozek
• Typer + Rich — CLI framework
• Questionary — Interaktivní prompty (šipky, select, checkboxy)
• Obsidian — Frontend & znalostní databáze
• ChromaDB — Vektorová DB pro RAG (plánováno)