Metadata-Version: 2.4
Name: coordinode-embedded
Version: 0.1.0
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Rust
Classifier: Topic :: Database
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Summary: CoordiNode embedded Python bindings — in-process graph database, no server required
Keywords: graph,database,cypher,embedded,knowledge-graph
License: Apache-2.0
Requires-Python: >=3.11
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Documentation, https://docs.coordinode.dev
Project-URL: Homepage, https://coordinode.dev
Project-URL: Repository, https://github.com/structured-world/coordinode-python

# coordinode-embedded

In-process CoordiNode graph database for Python — no server, no Docker required.

```python
from coordinode_embedded import LocalClient

with LocalClient(":memory:") as db:
    db.cypher("CREATE (n:Person {name: $name})", {"name": "Alice"})
    rows = db.cypher("MATCH (n:Person) RETURN n.name AS name")
    print(rows)  # [{"name": "Alice"}]
```

## Installation

```bash
pip install coordinode-embedded
```

## Usage

`LocalClient` is a drop-in replacement for `CoordinodeClient` for local development,
notebooks (Jupyter, Google Colab), and testing — same `.cypher()` API, zero infrastructure.

```python
from coordinode_embedded import LocalClient

# In-memory (discarded on close)
with LocalClient(":memory:") as db:
    db.cypher("CREATE (n:Person {name: 'Alice'})")
    rows = db.cypher("MATCH (n:Person) RETURN n.name AS name")

# Persistent storage
db = LocalClient("/path/to/db")
db.cypher("CREATE (n:Item {id: 1})")
db.close()
```

## Links

- [CoordiNode](https://github.com/structured-world/coordinode) — the graph database engine
- [coordinode-python](https://github.com/structured-world/coordinode-python) — Python SDK

