database EvolutionDB
code
v3.0 · Open Source

What's In the Box?

EvolutionDB is a single C binary purpose-built to be long-term memory for AI agents — with in-engine memory primitives, native vectors, and time-travel queries, all behind the PostgreSQL wire protocol.

psychology

Agent-Memory Primitives

First-class SQL primitives for agent long-term memory. Storing what an agent knows is a core feature of the storage engine, not a bolt-on layer or a sidecar service.

MEMORY STORE
ENTITY STORE
VECTOR(N)
AS OF
READ THE DOCS arrow_forward
polyline

Native Vectors & HNSW

A built-in VECTOR(N) type with an HNSW index in the core — semantic and lexical hybrid search without a separate vector service.

history

Time-travel Queries

An MVCC engine keeps prior versions, so you can run historical queries with AS OF. Ask what an agent knew at any point in the past.

hub

One Binary, Dual Protocol

A single server speaks the PostgreSQL wire protocol on port 5433 and a native EVO text protocol on port 9967. Connect with psql or DBeaver — or run the zero-Docker embedded mode.

PG WIRE :5433 EVO :9967 EMBEDDED MODE
Server up · dual protocol
$ psql -h 127.0.0.1 -p 5433 -U admin -d testdb
$ evosql-cli # native EVO on :9967

A Single C Binary

Replace a complex side-stack with one application. Unified page storage — 4KB pages, slotted pages, B+ tree indexes, a Clock-Sweep buffer pool, and a write-ahead log with crash recovery — all in the engine.

terminal ./evosql-server

Built for Production

groups

Multi-tenant Isolation

Per-tenant DATABASE, USER, and GRANT, enforced by the engine with a waterfall privilege check: table, then schema, then database.

lock

Security Built In

Transparent data encryption (AES-256) for pages and PBKDF2-SHA256 password authentication — security as a storage-layer property.

smart_toy

Agent-native

Ships an MCP server and a standalone agent. Actions stay human-approved: drafts queue first, and a human approves before anything is sent.

A Complete Toolchain

data_object

SQL Parser

A Flex/Bison parser for the SQL grammar.

terminal

CLI Client

A native command-line client for the EVO protocol.

cable

Python Connectors

Connectors for GitHub, Azure DevOps, calendar, and more.

memory

MCP Server

An MCP server so agents can use EvolutionDB as memory.

Clone and Run

# Clone the repo and start the server

git clone https://github.com/alptekin/evolutiondb

cd evolutiondb

docker compose up -d

# Connect with any PostgreSQL client