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. Every driver is open source under the Apache License 2.0.

Version 0.2 · Open source under Apache-2.0

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 and Quickstart
7Open source drivers, Apache-2.0
0Third-party packages in the default build
Bolt 5.4With Bolt 4.4 fallback

Choose a language

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

APACHE-2.0

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.

APACHE-2.0

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.

APACHE-2.0

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.

APACHE-2.0

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.

APACHE-2.0

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.

APACHE-2.0

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.

APACHE-2.0

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.

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

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.

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.2 speaks Bolt 5.0 to 5.4, and Bolt 4.4 when a server asks for it. Each driver authenticates, runs parameterised queries and explicit transactions, and maps every Galactus type, including spatial values, temporal values with their time zones and element IDs, to the language's own types.

After a database error the driver resets the connection and carries on, so one failed query never costs you the connection. Errors carry their Galactus code and a classification, with a retryable flag for transient failures. Version 0.2 passed the same live test suite in all seven languages over Bolt 5, Bolt 4.4 and TLS, including 57 spatial cases per language.

Where do I install the packages?

Start from the public GitHub repositories. Each Quickstart shows the source installation for its language. The repository is also where you read the code, run the tests and follow changes.

How are the drivers licensed?

Every driver is open source under the Apache License 2.0, so you can read it, change it and ship it inside your own software. Galactus DB itself is licensed separately, and its Community edition is free for any use. See pricing

How do connections and encryption work?

The drivers connect directly to the server. An omitted database uses the server’s configured default. Every driver supports verified TLS with bolt+s://, trusting the platform's certificate store or a certificate file you give it. Python, Node, Go, Java and C# use their runtime's TLS. Rust turns it on with the tls feature and C++ with the GALACTUS_WITH_TLS option, so the default builds stay free of third-party packages.

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.

Query syntax and driver setup

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