MangaDB

A lightweight, more delicious NoSQL database.

How It Works

Document Storage

MangaDB stores JSON documents in collections, similar to MongoDB. Each document is saved to disk in .dat files for persistence, making it lightweight and easy to deploy.

Custom Wire Protocol

Communication between clients and the server uses a simple binary protocol. Messages include a type byte and a JSON payload, making it efficient and easy to implement.

Multiple Interfaces

Access your data through a RESTful API, a text-based user interface (TUI), or directly via the Python client. Choose the interface that best fits your workflow.

Query Documents

Find documents using simple JSON queries. Specify field names and values to match, or use an empty query to retrieve all documents in a collection.

CRUD Operations

Create, read, update, and delete documents with ease. MangaDB automatically generates document IDs and handles all the serialization for you.

Easy Deployment

Deploy MangaDB locally or on cloud platforms like Render.com. The lightweight nature makes it perfect for small to medium-sized applications.

Get Started

pip install -r requirements.txt
python main.py

Access the API at http://localhost:8000 or use the TUI client with:

python main.py --tui