# Vellis Engine

Canonical URL: https://volantlabs.ai/engine.html
HTML path: /engine.html
Primary audience: engineers and technical evaluators.

## Summary

Vellis is an open-source context graph engine for humans and AI agents — typed, locally owned agent memory built as a reified typed graph. It separates stable anchors, typed fact records, and explicit link records; validates change against schemas and constraints; and supports deterministic query, replay, and recovery without tying knowledge to one model or agent surface.

## Use This Page For

- Explaining what Vellis is and what it does.
- Routing users through either the copyable Agent Quick Start or the staged manual setup, doctor check, MCP validation, state-check, and first-use path.
- Distinguishing typed context graph infrastructure from generic document storage, extract-and-embed memory layers, or chat memory.
- Explaining why Vellis is more than a graph server: explicit semantics, controlled change, an agent-facing MCP surface, and verifiable recovery.

## Key Claims

- The hero positions Vellis as the knowledge system agents can share, change, and recover.
- The flat capability baseline groups the engine into explicit knowledge, an agent operating surface, and recoverable state.
- The page differentiates Vellis through three coherence claims: explicit semantics, controlled change, and verifiable recovery.
- The compact RTG diagram places schema and constraints above, ledger and snapshots below, and connects link records, anchors, and fact records through the center as one five-part explicit knowledge contract.
- Human-owned textual SysML v2 models define reusable component contracts and Vellis application composition; generated references and validation keep that engineering authority inspectable as implementations evolve.
- Fact records are typed data objects associated with anchors; the raw graph allows zero, one, or many fact records.
- Vellis uses UUID link identity with source and target UUIDs.
- MCP-capable agents can operate against the same structured knowledge instead of each rebuilding private context.
- The hero visual shows proposed facts entering Vellis, becoming typed graph records, and returning as reusable structured context to another work surface.
- The compact open-source promise states that Vellis is Apache 2.0 licensed, links directly to the repository's LICENSE file, and remains a standalone local path that can be run, snapshotted, restored, and replayed.
- The hero CTA links to the quickstart anchor, but the quickstart module appears after the engine explanation and open-source promise so readers can understand Vellis before setup.
- The public quickstart offers copyable Agent Quick Start and manual command paths. Both emphasize safe local setup, preserving existing state, explicit approval before environment changes, MCP validation, and a non-destructive doctor path.
- Current operation is local. Filesystem and SQLite-backed state, snapshots, restore, and ledger replay provide the documented portability and recovery path.

## Related Pages

- Home: https://volantlabs.ai/
- Thesis: https://volantlabs.ai/thesis.html
- Perspectives: https://volantlabs.ai/perspectives.html
- Platform: https://volantlabs.ai/platform.html