open-source · self-hosted · audit-ready

Open-source AI orchestrace
pro procesy, které musíš řídit.

janAGI skládá open-source stack pro workflow, která opravdu udržíš pod kontrolou. n8n drží orchestrace, OpenClaw rozhodování a MindsDB datovou vrstvu. Audit, approval gates a model swap zůstávají součástí návrhu od prvního dne.

audit log od začátkuapproval gatesmodel swap bez přepisůMIT + self-hosted
Domluvit pilot→Projít rychlý start→Repo na GitHubu↗

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

OpenClaw + 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.

  • orchestracen8n — triggery, směrování, retry, audit log
  • AI vrstvaOpenClaw — agenti, klasifikace, politika nástrojů
  • dataMindsDB + PostgreSQL — federace, dotazy, predikce
  • 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
n8n
L1 · ORCHESTRATION
triggersroutingapprovalretryaudit log
OpenClaw
L2 · AI AGENTS
reasoningclassificationaction proposaltool policy
MindsDB + PostgreSQL
L3 · DATA
federationpredictionscompany systems

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

03 · Tok požadavku

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

klikni na krok

Příjem · IMAP / webhook

n8n trigger zachytí příchozí email, webhook nebo cron událost. Žádná business logika — jen normalizace payloadu a první zápis do audit_log.

uzel
n8n.IMAP
vstup
email / webhook / cron
audit
event.received
· každý krok je samostatný node v n8n, audit log se zapisuje na každé hraně

04 · Rychlý start

Spustíš to přes Docker Compose.

4 služby · Docker Compose
  1. git clone
    Naklonuj repo. Vše běží v Dockeru — nic se na hostu nestaví.
  2. docker compose up -d
    4 služby: n8n, OpenClaw, MindsDB, PostgreSQL. Doba prvního startu závisí na image cache a síti.
  3. Import workflowu
    V n8n UI naimportuj workflow JSON. Triggery, routing a retry logiku drž v samostatných nodech.
  4. Nastavení agenta
    Uprav definici agenta. Nastav tool policy, model a systémový prompt.
  5. 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: openclaw.agents.email
enrich:   postgres.SELECT customer_ctx
draft:    openclaw.tools.compose
approve:  telegram.sendMessage
           waitForResponse('✓ / ✘')
act:      smtp.send
audit:    postgres.INSERT audit_log

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

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: reality_calibrator.check
           against: postgres + mindsdb
propose:  openclaw.tool_policy.allow
act:      http.request CRM /api/v2
retry:    3x exp-backoff
audit:    postgres.INSERT audit_log

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:    openclaw.analytics.nl2sql
explain:  preview SQL to user
execute:  mindsdb.query
format:   render table + chart
reply:    telegram.send + csv
audit:    postgres.INSERT audit_log

06 · Agenti (OpenClaw)

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

#
název
role
popis
01
main
dispatcher
směruje požadavky na specializované agenty
02
reality_calibrator
validator
ověřuje konzistenci výstupů
03
reality_browser
research
web scraping a rešerše
04
analytics
data
datová analýza přes MindsDB
05
email
comms
zpracování emailové komunikace
06
reality_dom_analyzer
ui
analýza DOM/UI stavu
Vlastní agent? → docs/agents/custom.md · WIP

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
  • 05model swapvyměníte Claude / GPT / lokální model bez změny zbytku — model je konfig, ne kód

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

Orientační rozpočet pro menší pilot na jednom VPS. Reálná cena se odvíjí od provozu, zvoleného modelu a retence dat.

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

09 · Přispěj

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

REPOZITÁŘHonzaHezina/janAGIhlavní repozitář projektu — zdrojový kód, konfigurace, workflow a kontext k janAGI.→ otevřít na GitHubu
PULL REQUESTCONTRIBUTING.md · WIPveřejná pravidla pro přispívání ještě nejsou publikovaná. Workflow zůstává fork → branch → PR.→ pravidla brzy
DISKUSEGitHub Discussions · soukromá betaveřejné diskuse ještě nejsou otevřené. Dotazy, návrhy a RFC zatím běží v privátním beta režimu.→ požádat o přístup

10 · Komerční nasazení

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.

WEBHOOK · CONTACT

Dotaz / spolupráce

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

Open-source příspěvky běží na GitHubu. Komerční nasazení řeší hezina.cz.