Metadata-Version: 2.4
Name: citadeldb
Version: 1.7.0
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Topic :: Database
Classifier: Topic :: Database :: Database Engines/Servers
Classifier: Topic :: Security :: Cryptography
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Rust
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Typing :: Typed
Requires-Dist: numpy>=1.16
License-File: LICENSE-MIT
License-File: LICENSE-APACHE
Summary: Encrypted-first embedded database, memory engine, and agent runtime for Python
Keywords: database,encryption,sql,vector-search,ann,embedded-database,memory,agent,llm,cryptography
Home-Page: https://citadeldb.dev
Author: Yuriy Peysakhov
License-Expression: MIT OR Apache-2.0
Requires-Python: >=3.10
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Changelog, https://github.com/yp3y5akh0v/citadel/releases
Project-URL: Documentation, https://citadeldb.dev
Project-URL: Homepage, https://citadeldb.dev
Project-URL: Issues, https://github.com/yp3y5akh0v/citadel/issues
Project-URL: Repository, https://github.com/yp3y5akh0v/citadel

# citadeldb

Encrypted-first embedded database for Python: SQL (with JSON and full-text
search), filtered vector search, a memory engine, and an agent runtime, all over a
single-file store encrypted with AES-256-CTR + HMAC-SHA256.

## Install

```
pip install citadeldb
```

The only runtime dependency is NumPy; embeddings are bring-your-own.

```python
import citadeldb

db = citadeldb.connect("app.cdl", key="passphrase", create=True)
db.execute("CREATE TABLE notes(id INTEGER PRIMARY KEY, body TEXT)")
db.execute("INSERT INTO notes VALUES (1, $1)", ["hello"])
print(db.query("SELECT body FROM notes").to_dicts())  # [{'body': 'hello'}]
```

The Python distribution of [Citadel](https://github.com/yp3y5akh0v/citadel). Full
documentation and the SQL / vector / memory / agent APIs are at
[citadeldb.dev](https://citadeldb.dev) and in the main repository.

## License

MIT OR Apache-2.0

