@epistemicdb/server

HTTP + WebSocket API server for EpistemicDB — the epistemic database that models knowledge with decay, confidence, and gaps.

Quick start with Docker

docker pull epistemicdb/server:latest

docker run -d \
  -p 5433:5433 \
  -e DATABASE_URL=postgresql://postgres:[email protected]:5432/epistemicdb \
  -e EDB_ADMIN_KEY=your-admin-key \
  epistemicdb/server:latest

Or use Docker Compose:

services:
  epistemicdb:
    image: epistemicdb/server:latest
    ports:
      - "5433:5433"
    environment:
      - DATABASE_URL=postgresql://postgres:postgres@postgres:5432/epistemicdb
      - EDB_ADMIN_KEY=${EDB_ADMIN_KEY}
    depends_on:
      postgres:
        condition: service_healthy
  postgres:
    image: pgvector/pgvector:pg16
    environment:
      POSTGRES_DB: epistemicdb
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: postgres
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres"]
      interval: 5s
      retries: 5

API endpoints

| Method | Path | Description | |--------|--------------------|-----------------------------| | POST | /query | Execute an EQL query | | POST | /query/validate | Validate EQL without running | | GET | /schema | Introspect available fields | | GET | /health | Health check | | GET | /metrics | Prometheus metrics | | WS | /watch/ws | WebSocket WATCH subscriptions |

Environment variables

| Variable | Required | Description | |-------------------|----------|--------------------------------------| | DATABASE_URL | Yes | PostgreSQL connection string | | EDB_ADMIN_KEY | Yes | Admin API key (bootstraps project) | | EDB_PORT | No | Server port (default: 5433) | | OPENAI_API_KEY | No | For embedding generation |

Documentation

Full docs at epistemicdb.com/docs