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.
Self-hosted and open-core
Section titled “Self-hosted and open-core”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.
Architecture decisions
Section titled “Architecture decisions”Regulation, positioning & fit
Section titled “Regulation, positioning & fit”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.