Skip to main content

Lightweight local NoSQL, SQL, and Graph embedded database engine

Project description

Coffy: Local-First Embedded Database Engine for Python

PyPI PyPI Downloads

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
  • Command Line Interface (CLI)

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
  • ✅ Robust CLI

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 Neelesh Sarathy


Disclaimer: Number of downloads includes mirrors.

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.5.tar.gz (50.4 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.5-py3-none-any.whl (42.0 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for coffy-0.2.5.tar.gz
Algorithm Hash digest
SHA256 f0ef0ae20e0849c1f8e082c191c7ace30d7a62b244feb6614a6ad675f09b038a
MD5 8e81fca5fb0963b08937d135a9ff539e
BLAKE2b-256 8fbe3a2f8b69f7c0e3232581609a0b7331a7d28df2c1d68ad120367e7217e712

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for coffy-0.2.5-py3-none-any.whl
Algorithm Hash digest
SHA256 c4a12d30c38f240d41c244dae57b5dc2108de7305cf18832abff5ea075f08680
MD5 8fec8389a7706e43acc97912b0f5fe11
BLAKE2b-256 808dafec3bfa4f08d1d8fa01121aabd9088bca400a33986f9dbb23b9fcd1ac82

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