Awesome SurrealDB

A curated list of SurrealDB resources, tools, utilities, and applications.

Contents

• Applications
• Official SDKs
• Management interfaces
• Client libraries
• Development tools
• Deployment tools
• Docker images
• Integrations
• Libraries
• GitHub Actions
• Starter Kits
• Tutorials
• Videos
• Projects
• LangChain AI Agents

Applications

• SurrealDB - is a scalable, distributed, collaborative, document-graph database, for the realtime web.

Official SDKs

• surrealdb.c - official driver for C.
• surrealdb.go - official driver for Golang.
• surrealdb.java - official driver for Java.
• surrealdb.js - official driver for JavaScript.
• surrealdb.net - official driver for .NET.
• surrealdb.php - official driver for PHP.
• surrealdb.py - official driver for Python.
• surrealdb - official driver for Rust.

Management interfaces

• Surrealist - official dashboard, query playground and database explorer for SurrealDB.

Client libraries

• surrealdb-flutter - Client library for Dart and Flutter.

Development tools

• surreal-codegen - SurrealDB TypeScript type-safe client generator which extends the official SurrealDB package. Matches your raw .surql queries against your schema to generate strongly typed queries & parameters.
• surrealdb-client-generator - A handy tool that simplifies the process of generating zod schemas and TypeScript clients.

Deployment tools

• Dokku Surrealdb - A plugin to deploy SurrealDB as a Dokku plugin.
• GKE using Terraform - Multicluster Cross-Regional Deployment using GKE Autopilot and Terraform

Docker images

surrealdb/surrealdb - official Docker image.

Integrations

• SurrealDB Document Loader for LangChain - A simple document loader implementation around SurrealDB for LangChain.
• SurrealDB Vector Store for LangChain - Use SurrealDB as a vector store backed retriever within LangChain to build rich Generative AI applications with Large Language Models.
• SurrealDB Grafana datasource - The SurrealDB datasource plugin enables you to query and visualise SurrealDB data directly within Grafana, offering seamless integration and exploration of SurrealDB datasets.
• SurrealDB MCP Server - A Model Context Protocol (MCP) server that provides a standardized interface for AI assistants to interact with a SurrealDB database. This server enables AI systems to query and manipulate data within a configured SurrealDB instance.

Libraries

• allographer - A query builder and schema builder for Nim that also supports SurrealDB.
• AspNetCore.HealthChecks.SurrealDb - ASP.NET Core Health Check that verifies the ability to communicate with SurrealDb.
• CommunityToolkit.Aspire.Hosting.SurrealDb - Provides extension methods and resource definitions for the .NET Aspire AppHost to support running SurrealDB containers.
• surrealdb_extra - (Rust) - Query builder and orm.
• surrealdb-extras - (Rust) Creates namespace, database, tables and defines attributes automatically and generates/adds functions like add/delete/update to the struct.
• surrealdb-valibot - Re-usable valibot schema's for use with the JavaScript SDK.
• surrealdb-zod - Re-usable zod schema's for use with the JavaScript SDK.
• surrealist - Python synchronous client with support for HTTP and WebSocket connections, and all SurrealDB features (live queries, QL, Changes Feed).

GitHub Actions

• SurrealDB GitHub Action - official GitHub Action to use SurrealDB in GitHub Continuous Integration pipelines.

Starter Kits

• SurrealDB + Go Driver Starter - Salman Shah.
• SurrealDB + SvelteKit Auth Example - A JWT-based authentication example with globally available, universal request-isolated database example implementation - Albert Marashi.
• SurrealDB + Vue Blog Starter - SrWither.

Tutorials

• Aeon's Surreal Renaissance - official book for in-depth learning through storytelling.
• Build an AI RAG Agent with LangGraph, Ollama, Llama2, and SurrealDB - By Karim Lalani for Austin LangChain Group.
• CLI phone book in Python using SurrealDB as database - By Gabor Szabo.
• Getting started with SurrealDB using Python and Docker - By Gabor Szabo.
• Getting started with SurrealDB - By SurrealDB team.
• Hosting Surreal DB in Rust in Less Than 3 Minutes - Gui Bibeau.
• How to Use SurrealDb with the Fresh Framework and Deno - By Rajdeep Singh, FreeCodeCamp.
• Improve database management with SurrealDB - By Alexander Nnakwue, LogRocket.
• Simple API with Gin/Gonic and SurrealDB (GO) - By Atharva Deshpande.
• SurrealDB - Rust Embedded Database - Quick Tutorial - Jeremy Chone.
• SurrealDB Fundamentals Course - official course to efficiently learn SurrealDB in 3 hours.
• Unlocking SurrealDB: Building a Real-World Multi-Tenant RBAC System Made Easy (4 Part Series) - Sebastian Wessel

Videos

• Beyond Surreal? A closer look at NewSQL Relational Data - Beyond Fireship.
• Getting started with SurrealDB! Future of cloud databases (maybe)? - Chris Hay.
• Livestream series documenting learning SurrealDB - By Xkonti.
• Rust Powered Database SurrealDB (It's Pretty Ambitious) - Code to the Moon.
• SurrealDB in 100 seconds - Fireship.
• SurrealDB. The Kitchen Sink Document Store that might dethrone Firebase - Ray Villalobos.
• Using SurrealDB to prove football statistics - By Joseph McCarthy, Irish Abroad.

Projects

• open-notebook - An Open Source implementation of Notebook LM with more flexibility and features.
• Podcasts to Knowledge - Converts YouTube podcast/interview sessions into a structured knowledge graph with CocoIndex.

LangChain AI Agents

• taro - Agentic Search Harness. LangGraph ReAct agent with 8 search tools (vector, BM25, graph, hybrid RRF).
• dead-reckoning - Navigate any Python codebase via knowledge graph + resumable LangGraph agents, powered by SurrealDB.
• synapse - Turns unstructured reflections into a persistent knowledge graph, then answers questions from that evolving graph context.