Skip to content

nikdotcodes/Coffy

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

86 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

☕ 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.


📦 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

About

Open source lightweight embedded database engine for Python that supports NoSQL, SQL, and Graph data models.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • Python 100.0%