🧠 Second Brain — Průvodce

Tvůj osobní AI asistent nad Obsidian poznámkami. Tato stránka ti ukáže, jak vše propojit.

Obsah

Krok 1 — Nahrát poznámky na server Krok 2 — Spustit indexaci Krok 3 — Vyzkoušet vyhledávání Krok 4 — Zeptat se AI Krok 5 — Přidat novou poznámku Krok 6 — Automatická synchronizace (volitelné) Přehled všech funkcí
Krok 1

📁 Nahrát své Obsidian poznámky na server

Tvůj vault (složka s Markdown soubory) se musí překopírovat do složky /srv/vault/ na serveru.

Najdi cestu ke svému vaultu v Obsidian:

  1. Otevři Obsidian → klikni na název vaultu vlevo dole → Manage vaults
  2. Uvidíš cestu, např. /Users/martin/Documents/MyVault

Zkopíruj vault na server (příkaz v Terminálu na Macu):

rsync -avz --delete /Users/martin/Documents/MujVault/ root@77.42.81.145:/srv/vault/
✅ Tečka na konci MujVault/ je důležitá — zkopíruje obsah složky, ne složku samotnou.
Příkaz spusť v Terminalu (Finder → Aplikace → Utility → Terminal).
⚠️ Nahraď /Users/martin/Documents/MujVault skutečnou cestou ke svému vaultu.
Krok 2

⚡ Spustit indexaci poznámek

Po nahrání souborů musíš říct systému, aby poznámky zpracoval a připravil pro vyhledávání.

Otevři Swagger dokumentaci (/docs), klikni na Authorize (vpravo nahoře) a zadej token:

APP_API_TOKEN z tvého .env souboru

Pak v Swaggeru najdi sekci adminPOST /v1/admin/reindexTry it out → pošli:

{
  "force": true
}
✅ Indexace běží na pozadí. Může trvat minuty (záleží na počtu poznámek). Stav zjistíš přes GET /v1/admin/status.
Krok 3

🔍 Vyzkoušet vyhledávání

V sekci searchGET /v1/searchTry it out:

Systém vrátí relevantní úryvky z tvých poznámek seřazené podle relevance.

✅ Vyhledávání kombinuje sémantické (pochopení smyslu) i textové porovnávání — funguje i na přibližné dotazy.
Krok 4

💬 Zeptat se AI na cokoliv

V sekci chatPOST /v1/chat/ragTry it out:

{
  "query": "Co vím o produktivitě?",
  "k": 8
}

AI prohledá tvůj vault, sestaví kontext z nejrelevantnějších poznámek a odpoví s citacemi.

✅ Odpověď obsahuje citations — seznam poznámek, ze kterých AI čerpala.
Příklady dotazů: "Jaké mám projekty?", "Co jsem četl o strojovém učení?", "Shrň mé poznámky z konference"
⚠️ AI používá free LLM přes OpenRouter. Pokud dostaneš chybu 429, denní limit byl vyčerpán — zkus znovu po půlnoci UTC (2:00 ráno CZ).
Krok 5

✍️ Přidat novou poznámku nebo zachytit myšlenku

Možnost A — Rychlý text (nejjednodušší):

Sekce ingestPOST /v1/ingest/text:

{
  "text": "Myšlenka, kterou chci uložit...",
  "title": "Volitelný název",
  "tags": ["inbox", "nápad"]
}

Vytvoří Markdown soubor v inboxu a automaticky ho zaindexuje.

Možnost B — Uložit webovou stránku:

Sekce ingestPOST /v1/ingest/url:

{
  "url": "https://example.com/zajimavyclanek",
  "tags": ["web", "čtení"]
}

Možnost C — Nahrát Markdown soubor přímo:

rsync poznamka.md root@77.42.81.145:/srv/vault/00_inbox/poznamka.md

Po nahrání spusť reindex (Krok 2) nebo počkej — vault watcher soubor zaznamená automaticky.

Krok 6 — volitelné

🔄 Automatická synchronizace Obsidianu

Aby se tvůj vault automaticky synchronizoval po každé změně, použij jeden z těchto přístupů:

Možnost A — Obsidian Git plugin (doporučeno):

  1. V Obsidian → Community plugins → nainstaluj Obsidian Git
  2. Inicializuj git repozitář ve vault složce: git init && git add . && git commit -m "init"
  3. Nastav auto-commit a auto-push každých X minut
  4. Na serveru nastav git pull cron job: */5 * * * * cd /srv/vault && git pull

Možnost B — Cron rsync (jednodušší, jen Mac):

Přidej do crontabu (crontab -e):

# Sync každých 15 minut
*/15 * * * * rsync -azq /Users/martin/Documents/MujVault/ root@77.42.81.145:/srv/vault/
✅ Vault watcher na serveru sleduje /srv/vault/ a automaticky zpracovává nové/změněné soubory — reindex spouštět ručně nemusíš.
Přehled funkcí

📋 Co všechno systém umí

GET
/v1/search?q=dotaz
Vyhledej v poznámkách. Vrátí relevantní úryvky.
POST
/v1/chat/rag
Zeptej se AI — prohledá vault a odpoví s citacemi.
GET
/v1/notes
Seznam všech poznámek v databázi.
POST
/v1/ingest/text
Rychlý záchyt myšlenky nebo textu.
POST
/v1/ingest/url
Uložit webovou stránku do vaultu.
GET
/v1/admin/status
Kolik poznámek, chunků a embeddings je v databázi.
POST
/v1/admin/reindex
Přeindexovat vault (po nahrání nových souborů).