NyroDB

The Fastest Real-Time Database in the Known Universe

A hyper-performant, zero-copy, real-time database engine designed for extreme throughput and universal versatility.

Features • Installation • Documentation • API Guide • Configuration

---

Overview

NyroDB is a next-generation database engine built from the ground up in Rust. It utilizes Zero-Copy Serialization (Bincode), Asynchronous Batching, and Secondary Indexing to achieve performance that transcends modern understanding. Whether you're building a real-time messaging app, a high-frequency trading platform, or a secure authentication system, NyroDB provides the speed and flexibility you need.

Key Features

• ⚡ Extreme Throughput — Capable of 1,000,000+ operations per second with sub-microsecond latency.
• 🧠 Universal Querying — O(1) secondary indexing on any field. Query by custom metadata instantly.
• 🌐 Real-Time Native — Built-in WebSocket server for instant data streaming and pub/sub notifications.
• 🛡️ Secure by Design — Native API Key authentication and schema validation for production-grade safety.
• 🚀 Zero-Copy Storage — Optimized disk persistence using memory-mapped files and ultra-fast serialization.
• 📊 Real-Time Metrics — Detailed performance monitoring including throughput windows and p99 latency stats.

📦 Installation

From Source

git clone https://github.com/TheRemyyy/nyro-db.git
cd nyro-db
cargo build --release

Running

./target/release/NyroDB

🔧 API Guide

NyroDB exposes a simple yet powerful REST and WebSocket API.

REST Endpoints (Port 8081)

Method	Endpoint	Description
POST	/insert/:model	Insert a new JSON record.
GET	/get/:model/:id	Retrieve a record by its primary ID.
GET	/query/:model	List all records in a model.
GET	/query/:model/:field/:value	O(1) search by secondary index.
GET	/metrics	Retrieve real-time performance statistics.

Real-Time WebSocket

Connect to ws://127.0.0.1:8081/ws to receive instant updates. Format: INSERT:model_name:{"id":123,...}

⚙️ Configuration

NyroDB is configured via nyrodb.toml.

[server]
host = "127.0.0.1"
port = 8081

[security]
enable_auth = true
api_key = "your_secret_key"

[performance]
batch_size = 10000
max_concurrent_ops = 100000

License

This project is licensed under the MIT License - see the LICENSE file for details.

---

_{Built with ❤️ and Rust}