open-source · self-hosted · audit-ready open-source · self-hosted · audit-ready

Open-source AI orchestrace
pro procesy, které
musíš řídit. Open-source AI orchestration
for processes you
need to control.

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. janAGI composes an open-source stack for workflows you can actually control. n8n handles orchestration, OpenClaw reasoning, and MindsDB the data layer. Audit, approval gates, and model swap stay part of the design from day one.

audit log od začátkuaudit log from day one approval gatesapproval gates model swap bez přepisůmodel swap without rewrites MIT + self-hostedMIT + self-hosted
Domluvit pilot Book a pilot → Projít rychlý start View quick start → Repo na GitHubu View GitHub repo ↗

Chceš začít sám? Vezmi open-source repo. Chceš pilot nebo produkční rollout? Pokračuj na kontakt nebo hezina.cz. Want to start on your own? Use the open-source repo. Need a pilot or production rollout? Continue to contact or hezina.cz.

Ukázka provozního patternu Operational pattern preview
request → decision → action request → decision → action
01 · TRIGGER

Email / webhook / cron Email / webhook / cron

Jeden vstup, jednotné event schema a první zápis do audit logu. One ingress, a normalised event schema, and the first audit-log write.

02 · AGENT

OpenClaw + tool policy OpenClaw + tool policy

Agent klasifikuje a navrhuje akci, ale nic citlivého nepustí bez pravidel. The agent classifies and proposes actions, but nothing sensitive runs without policy.

03 · APPROVAL

Člověk před akcí Human gate before action

n8n vrátí návrh ke schválení a až potom volá SMTP, API nebo databázi. n8n routes the proposal for approval and only then calls SMTP, API, or the database.

krokstep vrstvaowner událostevent
01 n8n Inbound payload přijat a normalizovánInbound payload received and normalised
02 OpenClaw Intent klasifikován, tools zkontroloványIntent classified, tools checked
03 HITL Čeká na schválení člověka v TelegramuWaiting for human approval in Telegram
04 n8n Akce potvrzena, zápis proveden a audit uloženAction confirmed, write committed, audit persisted
STACK
n8n + OpenClaw + MindsDB + Postgres
GUARDRAILSGUARDRAILS
audit log, retries, approval gate a whitelist nástrojůaudit log, retries, approval gate, and tool whitelist
DELIVERYDELIVERY
self-hosted repo pro build, pilot a rollout přes hezina.czself-hosted repo for builders, with pilot and rollout via hezina.cz
STACKSTACK
n8n + OpenClaw
+ MindsDB + Postgres
KONTROLACONTROL
audit log + schválení
citlivých akcíaudit log + approval
for sensitive actions
MODELYMODELS
Claude / GPT / local
model = konfiguraceClaude / GPT / local
model = config
PROVOZRUNTIME
docker compose
lokálně nebo na VPSdocker compose
local or VPS

01 · Co to jeWhat it is

Framework, ne platforma.

A framework, not a platform.

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. janAGI is a framework for building AI workflows over real business processes. Three separate layers, audit by default, and the model treated as configuration. Swap any layer without breaking the rest.

  • orchestraceorchestration n8n — triggery, směrování, retry, audit logn8n — triggers, routing, retries, audit log
  • AI vrstvareasoning OpenClaw — agenti, klasifikace, politika nástrojůOpenClaw — agents, classification, tool policy
  • datadata MindsDB + PostgreSQL — federace, dotazy, predikceMindsDB + PostgreSQL — federation, queries, predictions
  • runtimeruntime Docker Compose — VPS, VM, managed Docker hostDocker Compose — VPS, VM, managed Docker host
  • rozhraníinterfaces Telegram, REST, webhook, n8n UITelegram, REST, webhook, n8n UI
  • licencelicense MIT — fork, kontrola, nasazeníMIT — fork, inspect, deploy

02 · ArchitekturaArchitecture

Tři vrstvy. Jasné rozhraní. Three layers. Clean interfaces.

klikni pro detail click for detail
n8n
L1 · ORCHESTRATION
triggersroutingapprovalretryaudit log
OpenClaw
L2 · AI AGENTS
reasoningclassificationaction proposaltool policy
MindsDB + PostgreSQL
L3 · DATA
federationpredictionscompany systems

03 · Tok požadavkuRequest flow

Jak vypadá cesta od požadavku k odpovědi. How a request becomes a final reply.

klikni na krok click a step
· každý krok je samostatný node v n8n, audit log se zapisuje na každé hraně · each step is a separate n8n node, audit log written on every edge

04 · Rychlý startQuick start

Spustíš to přes Docker Compose. Run it via Docker Compose.

4 služby · Docker Compose4 services · Docker Compose
  1. git clone
    Naklonuj repo. Vše běží v Dockeru — nic se na hostu nestaví. Clone the repo. Everything runs in Docker — nothing builds on the host.
  2. docker compose up -d
    4 služby: n8n, OpenClaw, MindsDB, PostgreSQL. Doba prvního startu závisí na image cache a síti. 4 services: n8n, OpenClaw, MindsDB, PostgreSQL. First start depends on image cache and network throughput.
  3. Import workflowuImport workflow
    V n8n UI naimportuj workflow JSON. Triggery, routing a retry logiku drž v samostatných nodech. In the n8n UI import a workflow JSON. Keep triggers, routing, and retry logic in separate nodes.
  4. Nastavení agentaConfigure agent
    Uprav definici agenta. Nastav tool policy, model a systémový prompt. Edit the agent definition. Set tool policy, model, and system prompt.
  5. Připojení datConnect data
    Připoj firemní data přes MindsDB — CRM, ERP, soubory, API. Federace nad více zdroji. Wire company data through MindsDB — CRM, ERP, files, APIs. Federation over many sources.
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íUse cases

Co na tom postavíš v praxi. What you build with it in practice.

Příchodící email → navržená odpověďInbound email → drafted reply

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. n8n's IMAP listener picks up the message, OpenClaw classifies intent (offer / question / complaint), pulls context from Postgres, and drafts a reply. A human approves it in Telegram, and n8n sends the result via 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 DBCron → web scrape → summary in DB

Pravidelný cron nebo manuální trigger spustí reality_browser. Agent prohledá zdroje, sumarizuje, MindsDB skoruje relevanci. Výsledek do Postgres, notifikace na Telegram. A cron or manual trigger fires reality_browser. The agent fetches sources, summarises, MindsDB scores relevance. Result lands in Postgres, notification on 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 CRMWebhook → validating agent → CRM write

Externí systém pošle webhook, n8n předá OpenClawu k validačci. Agent zkontroluje konzistenci přes reality_calibrator, navrhne akci, n8n zavolá CRM/ERP API. An external system fires a webhook, n8n hands it to OpenClaw for validation. The reality_calibrator checks consistency, an action is proposed, n8n calls the CRM/ERP API.

TRIGGERwebhook z externího systému
AIreality_calibrator — validače & 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 → reportSQL question → analytics 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. User asks in natural language via Telegram. The analytics agent runs MindsDB over company data and returns table + commentary. The exact query that ran is always in the audit log.

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)Agents (OpenClaw)

Specializovaní agenti místo jednoho univerzálního. Specialised agents instead of one do-it-all model.

#
názevname
rolerole
popisdescription
01
main
dispatcher
směruje požadavky na specializované agentyroutes requests to specialised agents
02
reality_calibrator
validator
ověřuje konzistenci výstupůverifies output consistency
03
reality_browser
research
web scraping a rešeršeweb scraping & research
04
analytics
data
datová analýza přes MindsDBdata analysis through MindsDB
05
email
comms
zpracování emailové komunikacehandles email communication
06
reality_dom_analyzer
ui
analýza DOM/UI stavuanalyses DOM/UI state
Vlastní agent?   Custom agent?   → docs/agents/custom.md · WIP

07 · Audit & HITLAudit & HITL

Každý krok je dohledatelný. Každou citlivou akci schvaluje člověk. Every step is traceable. Sensitive actions go through human approval.

bezpečné výchozí nastaveníbuilt-in defaults
postgres > audit_log · tail -f ukázkový streamsample stream
  • 01audit_logkaždá hrana toku zápis do Postgres — trigger, agent, tool, výsledek, latenceevery flow edge writes to Postgres — trigger, agent, tool, result, latency
  • 02tool policyYAML whitelist, co agent smě volat. Bez explicitního povolení ne.YAML whitelist of what an agent may call. No explicit allow = no.
  • 03HITL gatevše citlivé (odeslání emailu, zápis do CRM, platby) před akcí jde na schválení člověka v\u00a0Telegramuanything sensitive (sending email, CRM writes, payments) waits for human approval in Telegram
  • 04replayz auditu lze každý běh přehrát krok po kroku v\u00a0n8n — debug i complianceany run can be replayed step-by-step in n8n — debug and compliance
  • 05model swapproměníte Claude / GPT / lokální model bez změny zbytku — model je konfig, ne kódswap Claude / GPT / local model without changing the rest — model is config, not code

08 · InfrastrukturaInfrastructure

Běží tam, kde máš Docker. Runs anywhere you already have Docker.

  • 01hostHetzner VPS, AWS EC2, vlastní server — jakkoli Docker tam doježdí
  • 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í minimumcost · indicative 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. Indicative budget for a small pilot on one VPS. Actual cost depends on traffic, model choice, and data retention.

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

09 · PřispějContribute

Otevřený kód pro týmy, které chtějí rozumět provozu. Open code for teams that want to understand the runtime.

REPOZITÁŘREPOSITORY HonzaHezina/janAGI hlavní repozitář projektu — zdrojový kód, konfigurace, workflow a kontext k janAGI.primary project repository — janAGI source, configuration, workflows, and project context. → otevřít na GitHubuopen on GitHub
PULL REQUESTPULL REQUEST CONTRIBUTING.md · WIP veřejná pravidla pro přispívání ještě nejsou publikovaná. Workflow zůstává fork → branch → PR.public contribution guidelines are not published yet. The workflow stays fork → branch → PR. → pravidla brzyguidelines soon
DISKUSEDISCUSS GitHub Discussions · soukromá betaGitHub Discussions · Private beta veřejné diskuse ještě nejsou otevřené. Dotazy, návrhy a RFC zatím běží v privátním beta režimu.public discussions are not open yet. Questions, proposals, and RFCs currently run in private beta. → požádat o přístuprequest access

10 · Komerční nasazeníCommercial

11 · KontaktContact

Jedna cesta pro dotazy. GitHub pro contribuce. One path for questions. GitHub for contributions.

1 formulář · GitHub · hezina.cz 1 form · GitHub · hezina.cz
KAM DÁLWHERE NEXT

Přispět, zeptat se, nebo nasadit komerčně. Contribute, ask a question, or deploy commercially.

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. Code, issues, and pull requests belong on GitHub. Send technical questions, use cases, or feedback through the single form below. If you need a commercial rollout, continue to hezina.cz.

  • GitHub HonzaHezina/janAGI
  • kontaktcontact technický dotaz, use case, feedbacktechnical question, use case, feedback
  • commercial hezina.cz
WEBHOOK · CONTACT

Dotaz / spolupráce Question / collaboration

Napiš technický dotaz, use case nebo návrh spolupráce. Jeden formulář, stejný webhook, ruční follow-up. Send a technical question, use case, or collaboration note. One form, same webhook, manual follow-up.

Open-source příspěvky běží na GitHubu. Komerční nasazení řeší hezina.cz. Open-source contributions go through GitHub. Commercial delivery goes through hezina.cz.