open-source · self-hosted · audit-ready

Stroj vykonává.
Člověk rozhoduje.

janAGI je architektura pro AI workflow nad reálnými firemními procesy. Definuje čtyři věci — tvar události, politiku nástrojů, audit záznam a schvalovací bránu. Komponenty, které je plní, jsou tvoje volba a jdou vyměnit bez přepsání zbytku.

4 kontrakty, ne 4 produktyaudit na každé hranědefault denyMIT + self-hosted

Domluvit pilot→Projít rychlý start→Repo na GitHubu↗

Referenční implementace běží na n8n + OpenClaw + MindsDB + Postgres. Kterýkoli z nich vyměníš za jiný — Hermes Agent, Windmill, Temporal — pokud dodrží kontrakt.

Chceš začít sám? Vezmi open-source repo. Chceš pilot nebo produkční rollout? Pokračuj na kontakt nebo hezina.cz.

Ukázka provozního patternu

request → decision → action

01 · TRIGGER

Email / webhook / cron

Jeden vstup, jednotné event schema a první zápis do audit logu.

02 · AGENT

Agent runtime + tool policy

Agent klasifikuje a navrhuje akci, ale nic citlivého nepustí bez pravidel.

03 · APPROVAL

Člověk před akcí

n8n vrátí návrh ke schválení a až potom volá SMTP, API nebo databázi.

krokvrstvaudálost

01n8nInbound payload přijat a normalizován

02OpenClawIntent klasifikován, tools zkontrolovány

03HITLČeká na schválení člověka v Telegramu

04n8nAkce potvrzena, zápis proveden a audit uložen

STACK

n8n + OpenClaw + MindsDB + Postgres

GUARDRAILS

audit log, retries, approval gate a whitelist nástrojů

DELIVERY

self-hosted repo pro build, pilot a rollout přes hezina.cz

STACK

n8n + OpenClaw
+ MindsDB + Postgres

KONTROLA

audit log + schválení
citlivých akcí

MODELY

Claude / GPT / local
model = konfigurace

PROVOZ

docker compose
lokálně nebo na VPS

01 · Co to je

Framework, ne platforma.

janAGI je framework pro stavbu AI workflow nad reálnými firemními procesy. Tři samostatné vrstvy, audit jako standard a model jako konfigurace. Každou vrstvu vyměníš bez rozbití zbytku.

orchestracetriggery, směrování, retry, audit log · ref: n8n
agent runtimeúsudek, klasifikace, návrh akce · ref: OpenClaw
modelyvýběr per agent, ne per projekt · ref: Claude + lokální
datafederace, dotazy, predikce · ref: MindsDB + PostgreSQL
runtimeDocker Compose — VPS, VM, managed Docker host
rozhraníTelegram, REST, webhook, n8n UI
licenceMIT — fork, kontrola, nasazení

02 · Architektura

Tři vrstvy. Jasné rozhraní.

klikni pro detail

Orchestrace

ref: n8n

L1 · ORCHESTRATION SLOT

triggersroutingapprovalretryaudit log

Agent runtime

ref: OpenClaw

L2 · AI AGENTS SLOT

reasoningclassificationaction proposaltool policy

Data

ref: MindsDB + PostgreSQL

L3 · DATA SLOT

federationpredictionscompany systems

AUDIT + POLICY + HITL — prochází všemi vrstvami, nevyměňuje se

L1 · Orchestrace / n8n

n8n je dirigent. Drží workflow, triggery, retries, audit log a schvalovací kroky. Když přijde request — IMAP, webhook, cron — rozhodne, kterého agenta zavolat a co s výsledkem udělat.

rozhraní: vizuální editor + REST
rozsah: triggery, směrování, retry
běh: Docker

04 · Rychlý start

Spustíš to přes Docker Compose.

4 služby · Docker Compose

git clone
Naklonuj repo. Vše běží v Dockeru — nic se na hostu nestaví.
docker compose up -d
4 služby: n8n, OpenClaw, MindsDB, PostgreSQL. Doba prvního startu závisí na image cache a síti.
Import workflowu
V n8n UI naimportuj workflow JSON. Triggery, routing a retry logiku drž v samostatných nodech.
Nastavení agenta
Uprav definici agenta. Nastav tool policy, model a systémový prompt.
Připojení dat
Připoj firemní data přes MindsDB — CRM, ERP, soubory, API. Federace nad více zdroji.

shell

# 1. Clone & boot
 git clone https://github.com/HonzaHezina/janAGI.git
cd janAGI
docker compose up -d

# 2. Service URLs
# n8n       http://localhost:5678
# OpenClaw  http://localhost:7000
# MindsDB   http://localhost:47334

agents/main.yaml

name: main
model: claude-sonnet-4-6
role: dispatcher
routes:
  - email     → email_agent
  - research  → reality_browser
  - analytics → analytics_agent
tools:
  - n8n.webhook
  - mindsdb.query
  - postgres.read

05 · Příklady použití

Co na tom postavíš v praxi.

Příchozí email → navržená odpověď

IMAP listener v n8n vyzvedne zprávu, OpenClaw klasifikuje intent (nabídka / dotaz / stížnost), dotáhne kontext z Postgres a navrhne odpověď. Člověk ji schválí v Telegramu, n8n odešle výsledek přes SMTP.

TRIGGERIMAP listener v n8n

AIOpenClaw email agent — klasifikace, draft

HITLschválení v Telegramu před odesláním

ACTIONSMTP odeslání + log do Postgres

DATAkontext zákazníka, hist. komunikace

workflows/email-assistant.json

# n8n nodes (excerpt)
trigger:  IMAP → INBOX
classify: agent.email
enrich:   postgres.SELECT customer_ctx
draft:    agent.tools.compose
approve:  telegram.sendMessage
           waitForResponse('✓ / ✘')
act:      smtp.send
audit:    postgres.INSERT audit_log
runtime:  openclaw    # ← vyměnitelné: hermes | nemoclaw | mastra

Cron → webová rešerše → souhrn do DB

Pravidelný cron nebo manuální trigger spustí reality_browser. Agent prohledá zdroje, sumarizuje, MindsDB skoruje relevanci. Výsledek do Postgres, notifikace na Telegram.

TRIGGERmanuální nebo cron v n8n

AIreality_browser → analytics

ACTIONzápis do DB, notifikace přes Telegram

DATAMindsDB predikce relevance

workflows/research.json

# schedule: 08:00 daily
trigger:  cron('0 8 * * *')
fetch:    reality_browser.scrape
           sources: [hn, rss, custom_urls]
score:    mindsdb.predict relevance
filter:   relevance > 0.65
store:    postgres.INSERT findings
notify:   telegram.send digest
runtime:  openclaw    # ← vyměnitelné: hermes | nemoclaw | mastra

Webhook → validační agent → zápis do CRM

Externí systém pošle webhook, n8n předá OpenClawu k validaci. Agent zkontroluje konzistenci přes reality_calibrator, navrhne akci, n8n zavolá CRM/ERP API.

TRIGGERwebhook z externího systému

AIreality_calibrator — validace & akce

ACTIONREST call do CRM/ERP

DATAMindsDB federace nad více zdroji

workflows/crm-bridge.json

# inbound from any system
trigger:  webhook POST /hooks/event
validate: agent.validator.check
           against: postgres + mindsdb
propose:  openclaw.tool_policy.allow
act:      http.request CRM /api/v2
retry:    3x exp-backoff
audit:    postgres.INSERT audit_log
runtime:  openclaw    # ← vyměnitelné: hermes | nemoclaw | mastra

Dotaz → analytický agent → report

Uživatel pošle do Telegramu dotaz v přirozeném jazyce. analytics agent použije MindsDB nad firemními daty, vrátí tabulku + komentář. SQL, které se spustilo, je vždy v auditu.

TRIGGERTelegram message v přirozeném jazyce

AIanalytics — NL2SQL přes MindsDB

ACTIONTelegram odpověď + CSV link

DATAMindsDB → Postgres + ERP federace

workflows/analytics.json

# conversational analytics
trigger:  telegram.onMessage
parse:    agent.analytics.nl2sql
explain:  preview SQL to user
execute:  mindsdb.query
format:   render table + chart
reply:    telegram.send + csv
audit:    postgres.INSERT audit_log
runtime:  openclaw    # ← vyměnitelné: hermes | nemoclaw | mastra

06 · Agenti

Specializovaní agenti místo jednoho univerzálního.

název

role

model

popis

main

dispatcher

malý / lokální

směruje požadavky na specializované agenty

reality_calibrator

validator

střední

ověřuje konzistenci výstupů

reality_browser

research

střední + CPU parsing

web scraping a rešerše

analytics

data

velký

datová analýza přes MindsDB

comms

velký

zpracování emailové komunikace

reality_dom_analyzer

malý

analýza DOM/UI stavu

Velký model jen tam, kde je potřeba úsudek. Klasifikace a rutina jede na malém nebo lokálním modelu, výpočet na CPU. Není to optimalizace nákladů — je to podmínka toho, aby systém dával v provozu smysl.

07 · Audit & HITL

Každý krok je dohledatelný. Každou citlivou akci schvaluje člověk.

bezpečné výchozí nastavení

postgres > audit_log · tail -fukázkový stream

01audit_logkaždá hrana toku zápis do Postgres — trigger, agent, tool, výsledek, latence
02tool policyYAML whitelist, co agent smí volat. Bez explicitního povolení ne.
03HITL gatevše citlivé (odeslání emailu, zápis do CRM, platby) před akcí jde na schválení člověka v Telegramu
04replayz auditu lze každý běh přehrát krok po kroku v n8n — debug i compliance
05component swapvyměníš agent runtime, orchestrátor i datovou vrstvu, dokud nová komponenta dodrží kontrakt. Model je konfigurace. Komponenta je adaptér. Kontrakt je jediné, co se nemění.
06default denykdyž schválení nepřijde do timeoutu, akce se neprovede. Ne naopak.

08 · Infrastruktura

Běží tam, kde máš Docker.

01hostHetzner VPS, AWS EC2, vlastní server — kdekoli máš Docker
02deployplain docker compose nebo managed Docker host
03ci/cdexterní pipeline — build, test, deploy hooks
04contextrepo docs, DB stav a audit log
05interfaceuživatel komunikuje přes Telegram, REST API nebo n8n UI
06backupPostgres dump cron + S3-compatible bucket

náklady · orientační minimum

~ 15 €/mo

Provozní náklady — infrastruktura pro pilot na jednom VPS startuje kolem 15 €/měsíc. Dominantní nákladovou položkou v ostrém provozu jsou tokeny, a právě proto je výběr modelu per agent součástí návrhu, ne pozdější optimalizace.

VPS · Hetzner CX22~ 4.50 €
Backups · S3~ 1 €
LLM tokens · light usage~ 9.50 €

11 · Kontakt

Jedna cesta pro dotazy. GitHub pro contribuce.

1 formulář · GitHub · hezina.cz

KAM DÁL

Přispět, zeptat se, nebo nasadit komerčně.

Kód, issues a pull requesty patří na GitHub. Technický dotaz, use case nebo feedback pošli přes jeden formulář níže. Pokud chceš komerční rollout, pokračuj na hezina.cz.

GitHubHonzaHezina/janAGI
kontakttechnický dotaz, use case, feedback
commercialhezina.cz

WEBHOOK · CONTACT

Dotaz / spolupráce

Napiš technický dotaz, use case nebo návrh spolupráce. Jeden formulář, stejný webhook, ruční follow-up.

Stroj vykonává.
Člověk rozhoduje.

Email / webhook / cron

Agent runtime + tool policy

Člověk před akcí

Framework, ne platforma.

Tři vrstvy. Jasné rozhraní.

L1 · Orchestrace / n8n

Jak vypadá cesta od požadavku k odpovědi.

Příjem · IMAP / webhook

Spustíš to přes Docker Compose.

Co na tom postavíš v praxi.

Příchozí email → navržená odpověď

Cron → webová rešerše → souhrn do DB

Webhook → validační agent → zápis do CRM

Dotaz → analytický agent → report

Specializovaní agenti místo jednoho univerzálního.

Každý krok je dohledatelný. Každou citlivou akci schvaluje člověk.

Běží tam, kde máš Docker.

náklady · orientační minimum

Otevřený kód pro týmy, které chtějí rozumět provozu.

hezina.cz nasadí janAGI do reálného provozu.

Jedna cesta pro dotazy. GitHub pro contribuce.

Přispět, zeptat se, nebo nasadit komerčně.

Dotaz / spolupráce

Stroj vykonává.Člověk rozhoduje.

Email / webhook / cron

Agent runtime + tool policy

Člověk před akcí

Framework, ne platforma.

Tři vrstvy. Jasné rozhraní.

L1 · Orchestrace / n8n

Jak vypadá cesta od požadavku k odpovědi.

Příjem · IMAP / webhook

Spustíš to přes Docker Compose.

Co na tom postavíš v praxi.

Příchozí email → navržená odpověď

Cron → webová rešerše → souhrn do DB

Webhook → validační agent → zápis do CRM

Dotaz → analytický agent → report

Specializovaní agenti místo jednoho univerzálního.

Každý krok je dohledatelný. Každou citlivou akci schvaluje člověk.

Běží tam, kde máš Docker.

náklady · orientační minimum

Otevřený kód pro týmy, které chtějí rozumět provozu.

hezina.cz nasadí janAGI do reálného provozu.

Jedna cesta pro dotazy. GitHub pro contribuce.

Přispět, zeptat se, nebo nasadit komerčně.

Dotaz / spolupráce

Stroj vykonává.
Člověk rozhoduje.