Developer Center

Documentation

Deploy, query and integrate the headless fluvioMe engine - from docker compose up to production.

Quickstart

fluvioMe is an open-source, headlessengine that turns your company's data sources into a semantic memory living on your own servers. It ingests PDFs, databases, APIs, docs, code, Notion and GitHub into a SurrealDB knowledge graph, then lets an AI planning agent turn natural language into deployable data pipelines and self-serve BI reports (PowerBI, Tableau, PDF).

💡 Headless by designThere is no built-in auth and no bundled UI. The Apollo Router on :4001 is the public API surface - you pass an x-user-id header from your own identity layer (or run anonymously). Put your own proxy in front in production.

1. Clone & start the full stack

The fastest path is Docker Compose - it boots SurrealDB, Postgres, every service, and the gateway:

$ git clone https://github.com/ldbtech/fluvio-graph.git
$ cd fluvio-graph
$ docker compose up

2. Verify the gateway is live

$ curl -s http://localhost:4001/health
{"status":"ok"}

3. Ask the planner to build a pipeline

The agent-planner on :3007 turns a sentence into a plan you can compile and deploy:

curl -X POST http://localhost:3007/chat \
  -H "content-type: application/json" \
  -H "x-user-id: user-123" \
  -d '{"workspace_id":"ws-1","message":"Build a monthly churn report from the orders table"}'

✓ Free, forever, for non-commercial useStudents, researchers, non-profits and personal projects run the full engine with no token, no time limit, and no feature gates. Only for-profit production use needs an enterprise token (see Enterprise Tokens).

Prerequisites (local dev without Docker)

Rust 1.87+ (services build from the workspace Cargo.toml)
SurrealDB 2.x - graph + vector store
PostgreSQL 16 - relational persistence subgraph
Python 3.13 - connectors, agent-planner, tool-builder
Apollo Rover - composes the federated supergraph
Anthropic API key - agent-planner uses Claude for plan authoring

Then run the dev script which boots every subgraph + the router:

bash scripts/dev.sh