PuzzleDB is a high-performance, distributed, cloud‑native, multi‑API, multi‑model database (Technology Preview) implemented in Go.

What is PuzzleDB

PuzzleDB is a multi‑data‑model database capable of handling key‑value, relational, and document models. It is also multi‑interface, speaking existing protocols (PostgreSQL, MySQL, Redis, MongoDB).

PuzzleDB is a distributed framework supporting diverse models and protocols, designed for flexibility, scalability, and efficiency.

By accommodating existing query protocols, developers can adopt PuzzleDB with standard client drivers and minimal learning curve.

Key Features

PuzzleDB provides:

• Extensibility – Modular plugin architecture for queries, models, storage, coordination, tracing, metrics.

• Scalability – Seamless path from local in‑memory to shared‑nothing horizontal distribution via ordered key‑value storage.

• Compatibility – Supports major database protocol plugins (PostgreSQL, Redis, MongoDB, MySQL) easing migration.

• Reliability – ACID‑compliant storage and transaction semantics for correctness.

• Consolidation – Unified internal model representing key‑value, document, and relational data efficiently.

Get Started

Start with the quick start guide:

• Quick Start

Architecture & Concepts

Core architecture and design documents:

• Design Concepts

  • Layer Concept

  • Data Model

  • Storage Concept

  • Consistency Model

  • Coordinator Concept

  • Authentication Concept

  • Plugin Concept

Supported Protocols

PuzzleDB currently supports the following database protocols:

• Compatibility

  • PostgreSQL

  • MySQL

  • MongoDB

  • Redis

Roadmap

PuzzleDB is in a technical preview stage. A distributed plugin stack is under active development. See roadmap:

User Guides

• Get Started

  • Quick Start

    • puzzledb-server

  • Configuring PuzzleDB

• Operation

  • CLI (puzzledb-cli)

  • gRPC API

  • Distributed Tracing

• Benchmarking

  • puzzledb-bench

• Distribution

  • Docker Hub (cybergarage/puzzledb)

Developer Guides

• References

  • go-reference

• Contributing (Planning)

  • Coding Guidelines

• Building and Testing

  • Build on macOS

  • Build on Ubuntu

• Extending PuzzleDB

  • Plugin Concept

  • Plugin Services

    • Building User Plugins

• Specification

  • Coordinator Specification

    • Coordinator Messaging Specification

    • Coordinator Key-Value Store Specification

  • Store Specifications

    • Store Key-Value Specification

  • Transverse Specifications

    • Key-Value Store Specification

Related Projects

PuzzleDB is developed in collaboration with the following Cybergarage projects:

• go-postgresql

• go-mysql

• go-redis

• go-mongo

• go-cbor

• go-logger

• go-safecast

• go-sqlparser

• go-tracing

• go-authenticator

• go-sasl

• go-sqltest

• go-pict