Skip to content

Explanation

Read the architecture, security and licensing explanations here. For instructions, use the tutorial or how-to guides. Interface details are in the reference; page types are explained in How the docs are organized.

A modular platform: engine + modules + connectors

Section titled “A modular platform: engine + modules + connectors”

The olivares Go binary embeds the console, served from the same origin as the API. The engine provides ingestion, an in-process event bus, the connector SDK, module runtime, multi-tenant storage, REST/gRPC APIs, authentication, authorization and the append-only audit ledger. Modules use those services; connectors feed them through the SDK and do not import the core.

SQLite is the default store for single-node and air-gapped use. PostgreSQL adds row-level security for multi-tenant deployments. NATS is an optional event-bus binding. The 32 modules have different levels of readiness; own-model registry and fine-tuning remain planned.

Architecture overview describes the engine, data model and deployment topologies.

The access map: read-first, minimal-data, Permitted-vs-Observed

Section titled “The access map: read-first, minimal-data, Permitted-vs-Observed”

The R/RW access map shows which agent reads or writes each resource:

  • Read-first. The map observes through telemetry, native audit logs, and an eBPF kernel backstop — it sits outside the data path, never in it. It does not proxy, intercept, or gate live traffic.
  • Minimal-data. It stores only the relation (agent → resource, read or write) along with the signal source and a confidence level. It does not store payloads, secrets, or PII.

The Permitted-vs-Observed diff compares declared access with observed activity. The cooperative, high-fidelity path is Claude Code via OpenTelemetry plus MCP introspection, corroborated by native store audit (for example, pgAudit classifying reads and writes, or CloudTrail exposing read-only access on object storage); the non-cooperative backstop is eBPF at the kernel. MCP annotations are treated as untrusted per the MCP specification and are corroborated, never trusted alone.

→ Read the Security model for the posture and the Threat model for the assumptions and limits.

Collectors run on customer infrastructure. Deploy the engine as one binary, with distributed collectors using gRPC and mTLS plus PostgreSQL, or air-gapped with an offline license. A managed option remains future work.

The engine, modules and console are AGPL-3.0-only. The SDK and connectors are Apache-2.0; commercial modules are separate. Open core and licensing explains the boundary.

EU AI Act evidence describes runtime evidence for technical documentation. The positioning pages compare related tools and link their sources.

→ Browse Positioning & fit, starting with the verified market context & sources.