Zervanor — Architettura

Un unico backbone di eventi. Zero fornitori hardcoded.

Qualsiasi origine di eventi. Qualsiasi risultato aziendale. Un'unica piattaforma. Ecco la pila multi-tenant completa, nativa di Kubernetes, sotto ogni modello di soluzione.

Connettori

  • Chiamate HTTP senza stato
  • Leggeri, senza avvio a freddo
  • REST / GraphQL / Webhooks
Stripe · Slack · Gmail · GitHub · Notion
Instradatore di EventiCloudEvents

Agenti

  • Pod K8s isolati
  • A lungo termine, con stato
  • IA / LLM / Messaggistica
WhatsApp · Agente di IA · Pianificatore · Approvazione / HITL

La pila completa della piattaforma

Otto strati, un unico contratto. Ciascun livello è distribuibile e osservabile in modo indipendente — e ciascuna richiesta viene infine convogliata tramite il backbone CloudEvents.

Interfacce
Pannello di controllo Next.jsBuilder VisivoSDK TypeScript + CLI

Visivo per gli operatori, codice per gli sviluppatori.

Control Plane
FastAPIControllori → Servizi → RepositoryJWT + RBAC (4 ruoli)WebSocket in tempo reale

Autenticazione, scope organizzativo e l'API con cui ogni interfaccia comunica.

Motore di Flussi
Prefect42 tipi di nodiMonitoraggio dell'esecuzione in tempo reale

Associa gli eventi per modello, cron o webhook ed esegue il grafo.

Backbone degli Eventi
CloudEvents 1.0Apache Kafka (Redpanda)24h di deduplicazione

L'unico contratto parlato da ogni integrazione. Evidenziato perché tutto transita da qui.

Runtime degli Agenti
Generic Agentic Runtime (ADR-038)Pacchetti di connettoriProiezione degli strumenti (AG-02)

I connettori chiamano le API; gli agenti ragionano in pod isolati. Gli stessi pacchetti alimentano entrambi.

Orchestratore
Deploy WorkerCiclo di vita degli agenti K8sNamespace per tenant

Conteneurise e distribuisce gli agenti in namespace di locatari isolati.

Dati & Stato
PostgreSQLTimescaleDB (storico degli eventi)RedisQdrant (memoria vettoriale)

Stato relazionale, storico degli eventi sotto forma di serie temporali, cache e memoria dell'agente.

Infrastruttura
Kubernetes / GKETLS 1.3OpenTelemetry · Prometheus · Grafana

Cluster multi-tenant con crittografia, politiche di rete e osservabilità completa.

Cosa ti offre la pila

Gateway CloudEvents

Tutte le origini degli eventi (webhook, pianificazioni, database, messaggistica, API) sono normalizzate sotto il contratto CloudEvents 1.0 su un backbone Kafka, permettendo ai modelli di orchestrare senza codice di collegamento personalizzato.

SDK & CLI di Agenti in TypeScript

Costruisci e distribuisci agenti in TypeScript. Inizializza con init, esegui localmente e distribuisci con push (HTTP puro, senza Docker locale richiesto).

Builder di Flussi di Lavoro

Un builder visivo di trascinamento basato sul motore Prefect — 42 tipi di nodi (condizione, filtro, ciclo, trasformazione, HTTP, esecuzione agente, azione connettore, attività umana) e storico delle esecuzioni in tempo reale.

Connettori basati su Schema come Contratto

Le integrazioni sono dati, non codice. Ciascun connettore è un pacchetto versionato validato rispetto a uno schema canonico servito dall'API prima di essere pubblicato — il catalogo cresce senza toccare il nucleo.

In Tempo Reale & Osservabile

Aggiornamenti WebSocket in tempo reale con riconnessione automatica, oltre a OpenTelemetry, metriche Prometheus, pannelli di controllo Grafana e una pagina di stato pubblica senza token.

Sicurezza Multi-Tenant

JWT + RBAC (4 ruoli), namespace Kubernetes per tenant, query limitate per organizzazione, TLS 1.3 e mascheramento delle informazioni personali (PII) — validato da 47/47 controlli di sicurezza.

Costruito su una pila moderna e aperta

FastAPINext.jsNode.js / TypeScriptKubernetes / GKEPostgreSQLTimescaleDBRedisKafka / RedpandaPrefectQdrantNovuOpenTelemetryPrometheusGrafana

Perché questa architettura è vincente

Indipendente dai fornitori per natura

Non c'è alcuna logica di fornitore preprogrammata nel nucleo. Lo stesso motore esegue WhatsApp, Stripe e Salesforce — e i cento successivi — tramite il contratto comune. Un connettore non è considerato «completato» se non include il suo pacchetto fornitore, pacchetto connettore, documentazione di 7 file e test unitari funzionanti : nessun lavoro incomple.

Esecuzione guidata dagli eventi

A differenza delle piattaforme basate sul polling (interrogazione), Zervanor è interamente pilotato dagli eventi. I workflow e gli agenti si attivano solo quando un evento a cui sono abbonati (come stripe.payment.succeeded o github.issue.opened) transita dal Instradatore di Eventi.

Runtime nativo di Kubernetes

Zervanor non si limita a chiamare le tue API, ospita i tuoi agenti. Ciascun agente è containerizzato e distribuito in un cluster multi-tenant su GKE, con isolamento a livello di pod e namespace per organizzazione. Lo storico degli eventi risiede su TimescaleDB e l'osservabilità funziona su OpenTelemetry e Prometheus.

Novità — runtime e modelli

Esegui sulla piattaforma — o sul tuo dispositivo.

Lo stesso agente viene eseguito nel cloud gestito o sulla tua macchina, attinge a un mix instradato di modelli cloud e on-device ed è raggiungibile tramite un’interfaccia di chat.

Il cloud o il tuo dispositivo

Lo stesso agente — un manifest, un SDK — viene eseguito in un pod cloud gestito o sulla tua macchina tramite l’app Zervanor Desktop. Si connette in uscita, quindi funziona dietro un firewall.

Instradamento intelligente dei modelli

Un unico catalogo di modelli cloud, di piattaforma e on-device dietro router con nome e fallback automatico. Scegli un modello per agente; esegui l’inferenza in locale quando vuoi.

Conversazioni

Una chat persistente e instradata per modello che può usare i tuoi connettori e agenti come strumenti — con un passaggio di conferma prima di ogni modifica.

Oggi host di runtime su desktop; un host mobile è nella roadmap.

Guarda le fondamenta all'opera