Jak to funguje?
ObčanGPT je AI asistent, který umí vyhledat a vysvětlit paragrafy občanského zákoníku. Tady je přehled toho, co se děje pod kapotou.
1. Vyhledávání v zákoníku (grep)
Celý občanský zákoník (zákon č. 89/2012 Sb.) je uložen jako textový soubor na serveru. Místo klasické databáze používáme simulaci linuxového příkazu grep — stejný nástroj, jaký programátoři používají k prohledávání textů. AI si sama rozhodne, co hledat, a pošle dotaz do tohoto nástroje.
2. AI model přes Macaly
Jako AI mozek slouží velký jazykový model (LLM) dostupný přes platformu Macaly. Macaly zajišťuje přístup k modelům jako Claude (Anthropic) prostřednictvím svého API — není potřeba vlastní klíče od OpenAI ani jiných poskytovatelů. Používáme preset FAST pro rychlé a levné odpovědi.
3. Agentická smyčka
AI nejdříve prohledá zákoník (klidně i více hledání najednou), přečte si nalezené paragrafy a teprve pak napíše odpověď. Tento cyklus "hledej → přečti → odpověz" se opakuje až 5krát, dokud AI nemá dost informací. Proto jsou odpovědi přesné a citují konkrétní paragrafy.
4. Databáze konverzací (Convex)
Historie vašich konverzací je uložena v databázi Convex — moderní real-time databáze pro webové aplikace. Vaše konverzace jsou identifikovány anonymním ID uloženým v prohlížeči (localStorage), nikoli přihlašovacím účtem.
5. Denní limit zpráv
Každý anonymní uživatel může za den odeslat maximálně 10 zpráv. Limit se obnovuje každý den o půlnoci. Slouží k ochraně před zneužitím a udržení provozu v rozumných nákladech. Stav limitu vidíte v levém panelu.
Technický stack
| Framework | Next.js 15 (React) |
| AI platforma | Macaly LLM API |
| AI model | Claude (preset FAST) |
| Databáze | Convex |
| Hosting | Macaly |
| Zákon | OZ č. 89/2012 Sb. (~750 000 znaků) |
| Vyhledávání | grep simulace v Node.js |
| Streaming | AI SDK data stream (SSE) |
Postaveno na Macaly
ObčanGPT běží na platformě Macaly, která umožňuje rychlé vytváření webových aplikací s AI bez nutnosti spravovat vlastní servery, databáze nebo API klíče.
- ›Hosting & deployment — aplikace je hostována a automaticky nasazována přes Macaly
- ›LLM API — přístup k AI modelům přes Macaly LLM Usage API (žádné vlastní OpenAI klíče)
- ›Convex databáze — real-time databáze pro ukládání konverzací, automaticky propojená s aplikací
⚠️ ObčanGPT není právní poradna a může dělat chyby. Pro závažné právní záležitosti se vždy poraďte s advokátem.