Skip to main content

Lightweight local NoSQL, SQL, and Graph embedded database engine

Project description

Coffy: Local-First Embedded Database Engine for Python

PyPI

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.

coffydb.org

Installation

pip install coffy

preview

Features

  • Local persistence (JSON, SQLite)
  • In-memory mode (:memory: or None)
  • No server needed
  • Logical and comparison operators
  • Unified query interface

Engines

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


License

MIT License © 2025 Neel Sarathy

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

coffy-0.2.1.tar.gz (89.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

coffy-0.2.1-py3-none-any.whl (97.8 kB view details)

Uploaded Python 3

File details

Details for the file coffy-0.2.1.tar.gz.

File metadata

  • Download URL: coffy-0.2.1.tar.gz
  • Upload date:
  • Size: 89.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.8

File hashes

Hashes for coffy-0.2.1.tar.gz
Algorithm Hash digest
SHA256 ee76638f38ed236867d239df2ee707c223a4c8c0758943eafb2e727118b735f8
MD5 3d463699bc8291458851cdda9994af1e
BLAKE2b-256 2ffe9396ce127ac5dc49144fde973ee12bd60c2e3c4797ffb54e5c6d576bf426

See more details on using hashes here.

File details

Details for the file coffy-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: coffy-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 97.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.8

File hashes

Hashes for coffy-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 557ff1e67e2f6b50940c6cdd60a69fe5a0418318a33baf30386286a085a5598f
MD5 4056593bc7264e73737fcc36684c3885
BLAKE2b-256 4f5c7fa30c0c5b3c6f0f07bc4d04deb3859fa31f586e41255328e70233776aca

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page