monadb 0.1.0

MonaDB — an embedded, dict-like SQL engine with a Python API.

MonaDB

An embedded document database with a small SQL dialect. Use it from Python, Rust, or the interactive monadb shell.

Install

Python (PyPI)

pip install monadb

import monadb

con = monadb.connect()          # in-memory
con = monadb.connect("app.db")  # file-backed
con.execute("create table todos (id int);")

CLI shell (monadb)

Homebrew

brew tap rchowell/tap
brew install monadb
monadb

cargo

cargo install monadb --features cli
monadb

GitHub Releases — download a prebuilt monadb binary for your platform from Releases.

Rust (crates.io)

cargo add monadb

use monadb::MonaDB;

let mut db = MonaDB::open("app.db")?;
db.execute("create table t (id int);")?;

monadb REPL

monadb              # in-memory database
monadb ./data.db    # open or create a file

Dot-commands inside the shell:

Command	Action
.info	List catalog tables
.debug	Toggle bytecode trace
.exit	Quit

SQL statements end with ;. The prompt supports syntax highlighting and multiline input.

Requirements

• Python: 3.9+
• Rust (from source): 1.85+ (edition 2024)
• CLI: terminal with readline support

Documentation

• Installation
• Language reference
• Examples

License

Apache-2.0 — see LICENSE.