gdb

GenosDB (GDB) – Decentralized P2P Graph Database

A lightweight, decentralized graph database designed for modern web applications, offering real-time peer-to-peer synchronization, SM (Security Manager) Provides WebAuthn-based authentication, role-based access control (RBAC), Access Control Lists (ACLs), and efficient local storage utilizing OPFS.

GenosDB

NPM Version License-SourceCode-Proprietary

Production Build

Downloads on NPM Tests

Project Status

NPM Unpacked Size (with version)

npm package minimized gzipped size

Table of Contents

Main Features

✅ GenosDB Core

Project Status

🧪 API Status: Stable Beta

The GenosDB API is currently in a stable beta. We are actively adding features and improving stability. We recommend checking the CHANGELOG as we continue to refine the API for its first stable release.

✅ Role Based Access Control (RBAC)

✅ Security

A Note on P2P System Reliability

GenosDB operates in a real-world P2P environment, which exposes the system to network uncertainties by design. Our engineering focus is on mitigating these uncertainties within our software through robust conflict resolution (CRDTs) and synchronization logic. While we cannot control external network conditions, our commitment is to the continuous research and development required to ensure the highest possible resilience of the GenosDB engine.

Installation

1. Via NPM

npm install genosdb

import { gdb } from "genosdb"

2. Direct use in browser from a CDN

<script type="module">
  import { gdb } from "https://cdn.jsdelivr.net/npm/genosdb@latest/dist/index.min.js"
</script>

Documentation

For interactive, AI-assisted GenosDB documentation:

Ask DeepWiki

Examples

We’ve created a collection of interactive examples to help you understand how GDB works in real-world scenarios. These examples cover everything from basic setup to advanced features like RBAC and P2P synchronization.

👉 Explore /docs/Examples

Project Documentation

Internal Dependencies

Below is a list of internal dependencies and their purposes within the project:

Dependency Usage
@msgpack/msgpack Data serialization/deserialization in MessagePack format.
pako Data compression/decompression using gzip.
genosrtc New Internal Module for P2P synchronization for sharing changes in real-time between tabs/devices.
BroadcastChannel Communication between browser tabs to notify local changes.

Additional Information

General Note: These dependencies are integral to the project’s performance and functionality, ensuring efficient data handling and real-time synchronization while leveraging decentralized technologies like Nostr.

Repository Diagram

The project includes an interactive visualization of the repository’s history and structure, which you can explore here:

gdb repository diagram

This graphical view is especially useful for new contributors or anyone looking to gain deeper insight into the project’s evolution and structure, providing a clear and visual understanding of the workflow.

Presentation Video

GenosDB Presentation

Contributing

We value community contributions and welcome your help in improving GenosDB! Currently, contributions are focused on:

Please read our Contribution Guidelines for more details. We do not accept pull requests for the core source code at this time.

Community

We value community contributions — get involved through:

See the discussion on Product Hunt:

GenosDB - GenosDB (GDB) – Distributed P2P Graph Database | Product Hunt

GenosDB badge

Feel free to ask questions, share ideas, or just say hello! 👋

For more details on contributing, check out our Contributing Guidelines.

Special Thanks

Being part of the GunDB community has given me the opportunity to contribute to and take part in incredible projects. GunDB and GenosDB belong to the same research effort in distributed systems. My sincerest gratitude to Mark Nadal, Founder of GunDB, for his friendship and unconditional support.

A special mention to William Blankenship, Network Fellow at WebAI, for his initial support and kind words about the vision for GenosDB.

License

Project License

The production builds of GenosDB (GDB) are free to use for both personal and commercial projects. You can integrate them into your applications without any licensing fees.

However, the source code for GenosDB is proprietary and is not available under an open-source license. You do not have the right to decompile, reverse-engineer, or modify the core source code.

Third-Party Licenses

This project includes third-party dependencies with their own respective licenses. For detailed information, see the Third-Party Licenses page.

Maintenance

This repository provides production builds of GenosDB (GDB), a decentralized P2P graph database designed for modern web applications. These builds are freely available for anyone to use and integrate into their projects. Please note that the source code is not publicly available at this time; only the production builds versions are provided. The project is actively maintained by Esteban Fuster Pozzi (@estebanrfp)

Author

Esteban Fuster Pozzi (@estebanrfp) — Full Stack JavaScript Developer and creator of GenosDB (GDB), a free-to-use real-time graph database built entirely with modern vanilla JavaScript.

FOSSA Status

FOSSA Status

Business Inquiries & Collaboration

GenosDB is an independently developed project with a long-term vision to power the next generation of secure, decentralized, and real-time applications.

For strategic partnerships, enterprise support inquiries, or discussions regarding the project’s roadmap and future, please feel free to reach out directly.

Contact: estebanrfp@gmail.com or start a conversation in GitHub Discussions.

This site is open source. Improve this page.