# surrealdb/surrealdb

A scalable, distributed, collaborative, document-graph database, for the realtime web

Repository: https://github.com/surrealdb/surrealdb
Canonical: https://ross.abutalabs.com/products/surrealdb
Homepage: https://surrealdb.com
Language: Rust
License: NOASSERTION
License Family: other
Topics: database, distributed, distributed-database, document-database, realtime-database, cloud-database, backend-as-a-service, database-as-a-service, serverless, web, developer-tools, devtools, sql, nosql, graph-database, surreal, surrealdb, iot-database
Last push: 2026-08-21T19:08:17+00:00

## Health v2 (maintenance only)
Score: 94/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 98, release rhythm 86, longevity 100
- inputs: {"age_days": 1728, "days_push": 12, "days_rel": 16, "gap_med": 4, "n_releases_24m": 64}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 32944, forks 1350 (observed 2026-08-28T04:11:57.927197+00:00)

## What it is
SurrealDB is a multi-model database written in Rust that combines document, graph, vector, and relational data models in a single ACID engine, queryable via SurrealQL, SDKs, or GraphQL. It runs embedded, single-node, or distributed, and offers real-time live queries, built-in authentication, and an Agent Memory layer for AI applications.

## Use cases
- store documents and graph relationships in one database
- run vector search for AI agent memory
- build realtime apps with live queries and changefeeds
- embed a database directly in a Python or JavaScript app
- self-host a scalable distributed database with horizontal scaling
- replace separate vector, graph, and document stores with one engine
- add authentication and row-level permissions to app data

## When to choose
- you need multiple data models (document, graph, vector, relational) without running separate systems
- you want realtime subscriptions and live queries out of the box
- you need an embeddable database that also scales to distributed multi-region deployments
- you are building AI agents that need durable memory and context retrieval

## When to avoid
- you need a battle-tested traditional RDBMS with mature SQL tooling and ecosystem
- your project requires a permissive open-source license (SurrealDB uses BSL 1.1)
- you depend on a wide ecosystem of third-party extensions and mature operational tooling
- you need strict relational integrity with complex joins as the primary access pattern

## Facets
- artifact type: service
- maturity: stable
- function: database, vector-database, search-engine, auth, websocket, cli, sdk
- domain: databases, backend, web-development, large-language-models, microservices
- platform: windows, cloud, self-hosted, rust, python, wasm, browser
- tags: multi-model-database, document-database, graph-database, surrealql, backend-as-a-service, live-queries, agent-memory, bsl-license, embedded-database, ai-agents, real-time, linux, macos, docker, kubernetes, nodejs

## Member repositories
- surrealdb/surrealdb (main) score 94

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:57.927197+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T16:51:53.917076+00:00, confidence not recorded.
  - readme: https://github.com/surrealdb/surrealdb (fetched 2026-08-28T04:11:57.927197+00:00, sha b05ed08f79c6)
  - homepage: https://surrealdb.com (fetched 2026-08-29T07:48:57.267756+00:00, sha 57a0cb159a6e)
  - site_page: https://surrealdb.com/docs (fetched 2026-08-29T07:48:57.298615+00:00, sha 51c1726b63e7)
  - site_page: https://surrealdb.com/surrealdb/features (fetched 2026-08-29T07:48:57.319798+00:00, sha eef81b5e4351)
  - site_page: https://surrealdb.com/surrealdb/install (fetched 2026-08-29T07:48:57.323251+00:00, sha 6d7419e83c9c)
  - site_page: https://surrealdb.com/docs/labs (fetched 2026-08-29T07:48:57.326816+00:00, sha e612d8cf4962)
  - registry_crates: https://crates.io/api/v1/crates/surrealdb (fetched 2026-08-29T07:48:57.328569+00:00, sha 2ca627f60e27)
  - site_page: https://surrealdb.com/pricing (fetched 2026-08-29T07:48:57.312722+00:00, sha 7a30ee7587d7)
  - site_page: https://surrealdb.com/agent-memory (fetched 2026-08-29T07:48:57.315126+00:00, sha 6bb049c48004)
  - site_page: https://surrealdb.com/customer/verizon (fetched 2026-08-29T07:48:57.317630+00:00, sha 932bd4715ddb)
- Data as of 2026-08-30T08:39:29.467469+00:00.