Lightweight local NoSQL, SQL, and Graph embedded database engine
Project description
Coffy: Local-First Embedded Database Engine for Python
Coffy is a lightweight, local-first embedded database engine supporting NoSQL, SQL, and Graph models — all in pure Python. Designed for fast prototyping, scripting, and local apps.
Installation
pip install coffy
Features
- Local persistence (JSON, SQLite)
- In-memory mode (
:memory:orNone) - No server needed
- Logical and comparison operators
- Unified query interface
Engines
If you are viewing this from coffydb.org, you can find the documentation for each engine in the NoSQL, Graph, and SQL sections.
| Engine | Description | Docs |
|---|---|---|
coffy.graph |
Local graph database (NetworkX-based) | Graph Docs |
coffy.nosql |
Document store with chainable queries | NoSQL Docs |
coffy.sql |
Thin SQLite wrapper | SQL Docs |
What sets Coffy apart?
Only embedded Python graph DB with:
- ✅ Declarative traversal syntax (match_node_path(...))
- ✅ Label/type filtering, limit/offset, result projection
- ✅ Unified API for both nodes and relationships
Only pure-Python embedded document store with:
- ✅ Auto-indexing on all top-level fields
- ✅ Chainable logical queries (.where(...).eq(...).or_().in_())
- ✅ Merge/lookups across collections (like mini $lookup)
- ✅ JSON persistence or in-memory fallback
🔗 Links
- coffydb.org
- PyPI: coffy
- Source: GitHub
License
MIT License © 2025 Neel Sarathy
Disclaimer: Number of downloads includes mirrors.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file coffy-0.2.4.tar.gz.
File metadata
- Download URL: coffy-0.2.4.tar.gz
- Upload date:
- Size: 38.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.11.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
196b63829ea912847e9b4d68612a1fe939ddbc120d2f1cd14ae8981695b2fa71
|
|
| MD5 |
b57ea9f1b613a94b95f194e79396881e
|
|
| BLAKE2b-256 |
ff669871c3bf7732a343dcfc6c225266960550315c1f1fcbad06a17e3f50ad8a
|
File details
Details for the file coffy-0.2.4-py3-none-any.whl.
File metadata
- Download URL: coffy-0.2.4-py3-none-any.whl
- Upload date:
- Size: 33.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.11.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7848355009db48b2d3f360f9990d128e7b6cf4d97206b2c2c05b81cac50dba57
|
|
| MD5 |
e101674678c40eba72d1933613aeb121
|
|
| BLAKE2b-256 |
88c0c70e2753a5cc0a7cedc0a62d5a42bab0b6dc48913d7d97e3461102595e87
|