A new universe for your graph data.Meet Galactus DB
APPLICATION DEVELOPMENT

Galactus DB drivers

Connect from C#, Rust, Java, Go, Node.js, C++ or Python. Run parameterised Cypher, manage transactions and map database values to native language types.

0.1 early access · Source available on GitHub

Execute a parameterised queryPYTHON
import os
from galactus import Driver

with Driver(
    "bolt://127.0.0.1:7687",
    "gdb", os.environ["GDB_PASSWORD"]
) as driver:
    result = driver.execute_query(
        "RETURN $name AS name",
        {"name": "Ada"},
    )
    print(result.records[0]["name"])
RESULTAda
Python setup & Quickstart
7Native language drivers
0Third-party runtime packages
Bolt 4.4Direct database connections
DRIVER REPOSITORIES

Choose a language

Every repository includes a Quickstart, connection settings, query and transaction examples, spatial guidance and tests.

NATIVE DRIVER

C#

.NET 6+ API surface

Parameterised queries, explicit transactions and native .NET type mapping. Implements IDisposable.

View install command
dotnet add reference ./galactus-db-csharp-driver/Galactus.Driver.csproj

Clone the repository first, then reference it from your application.

NATIVE DRIVER

Rust

Rust 1.70+

Typed values and checked conversions with no external crates. Drop closes the connection.

View install command
cargo add galactus-db-rust-driver --git https://github.com/galactusdb/galactus-db-rust-driver --branch main

Install from source on main. Pin a reviewed commit for reproducible builds.

NATIVE DRIVER

Java

Java 11+

Maps database values to Java collections and java.time types. Supports try-with-resources.

View install command
git clone https://github.com/galactusdb/galactus-db-java-driver.git

Inside the checkout, run mvn install, then add the artifact to your application.

NATIVE DRIVER

Go

Go 1.21+

Native maps and slices, error return values and operation deadlines. Uses the standard library.

View install command
go get github.com/galactusdb/galactus-db-go-driver@main

Install from source on main. Pin a reviewed commit for reproducible builds.

NATIVE DRIVER

Node / TypeScript

Node 18+ · ESM

Async API with TypeScript declarations. Uses bigint for integers and Buffer for binary values.

View install command
npm install github:galactusdb/galactus-db-node-driver#main

Install from source on main. Pin a reviewed commit for reproducible builds.

NATIVE DRIVER

C++

C++17 · CMake

Header-only C++17 API with typed values, standard containers and RAII connection cleanup.

View install command
git clone https://github.com/galactusdb/galactus-db-cpp-driver.git

Add the checkout to CMake and link Galactus::Driver. See the Quickstart for the complete setup.

NATIVE DRIVER

Python

Python 3.10+

Synchronous API with native Python values, spatial types and a context manager for connections.

View install command
python -m pip install git+https://github.com/galactusdb/galactus-db-python-driver.git@main

Install from source on main. Pin a reviewed commit for reproducible builds.

PREREQUISITE

Run Galactus DB locally

Each driver needs a reachable Bolt endpoint and database credentials. The setup guide covers starting the database and Explorer on your infrastructure.

Set up Galactus DB →
TYPE MAPPING

Native and spatial types

Use native strings, numbers, byte arrays, lists and maps as query parameters. Results include typed nodes, relationships, paths and temporal values. Dedicated types preserve values that exceed the runtime's native precision.

Geometry and geography support includes points, lines, polygons, multipart shapes and collections. Spatial objects preserve WKB bytes, SRID, XY/XYZ dimensions and domain when read from or written to the database.

Explore spatial types →

Every supported shape family

  • Point, LineString and Polygon with holes
  • MultiPoint, MultiLineString and MultiPolygon
  • GeometryCollection and nested collections
  • XY, XYZ and typed empty shapes

Legacy 2D and 3D points are supported too. M/ZM coordinates, curves and surfaces are outside the current database scope.

Release details

What is available in this release?

Version 0.1 supports direct connections, authentication, parameterised queries, eager results, explicit transactions and native type mapping. Each driver owns one connection. Pooling, routing discovery, cancellation and managed retries are future work.

The seven drivers have been tested against a local Galactus database, including 57 spatial cases per language. Windows builds have been validated; broader platform, TLS and production load testing are still ahead.

Where do I install the packages?

Start from the public GitHub repositories. Each Quickstart shows the source installation for its language. Package-registry releases are not available yet; the repository is the place to read the code, run the tests and follow changes.

How do connections and encryption work?

The drivers connect directly over Bolt 4.4. An omitted database uses the server’s configured default. Python, Node, Go, Java and C# support verified TLS connections through the runtime. Rust and C++ require an external TLS tunnel in this dependency-free release.

How do I report an issue?

Open an issue in the language repository with a feature request or a small reproduction. Include the driver commit, runtime and operating system, and leave out credentials and sensitive data.

DOCUMENTATION

Query syntax and driver setup

Use the language Quickstarts for connection and API examples, and the Cypher guide for query syntax.