# Grizabella
A tri-layer memory framework for LLM solutions.
[](https://pwilkin.github.io/grizabella/)
[](LICENSE)
## Overview
Grizabella is a sophisticated memory layer designed for Large Language Model (LLM) solutions. It provides a unified interface to manage and query data across relational, vector, and graph databases, enabling complex memory and knowledge retrieval for AI applications.
## Key Features
* **Tri-layer Storage:** Integrates SQLite (relational), LanceDB (vector), and Kuzu (graph) for comprehensive data management.
* **Unified Python API:** Offers a simple and consistent Python interface to interact with all three database layers.
* **Complex Query Engine:** Allows for sophisticated queries that can span across the different data storage paradigms.
* **PySide6 UI:** Includes an optional desktop application for visualizing and managing data.
* **MCP Server:** Can operate as a Model Context Protocol (MCP) server, allowing other tools to leverage its memory capabilities.
## Quick Links
* [User Guide](./docs/user_guide/)
* [API Reference](./docs/api_reference/build/html/)
* [Examples](./examples/)
* [MCP Server Startup](./scripts/README.md)
## Quick Installation
For production use (once published):
```bash
pip install grizabella
```
For development:
```bash
git clone https://github.com/pwilkin/grizabella.git
cd grizabella
poetry install
```
## Basic Usage Snippet
```python
from grizabella import Grizabella
# Initialize Grizabella (connects to default in-memory databases)
gz = Grizabella()
# Define an object type (implicitly creates a table/node type)
gz.create_object_type("document", {"text": str, "source": str})
# Add an object
doc1 = gz.add_object(
object_type="document",
data={"text": "This is the first document.", "source": "manual"},
vector_data={"text": "This is the first document."} # Data for embedding
)
print(f"Added document with ID: {doc1.id}")
# Further operations (querying, adding relations, etc.) would go here.
```
## Contributing
Contributions are welcome! Please see `CONTRIBUTING.md` (to be added) for guidelines on how to contribute to Grizabella.
## License
Grizabella is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
Raw data
{
"_id": null,
"home_page": "https://github.com/pwilkin/grizabella",
"name": "grizabella",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.14,>=3.12",
"maintainer_email": null,
"keywords": "python, llm, memory, vector-database, graph-database, sqlite, lancedb, kuzu, pyside6, sentence-transformers, fastmcp, ai, multi-modal",
"author": "Grizabella Project Contributors",
"author_email": "contributors@example.com",
"download_url": "https://files.pythonhosted.org/packages/de/7d/29ed6c43c99e4596480d75d24fdd546b459561e81a64c349d2c4d7816936/grizabella-0.2.6.tar.gz",
"platform": null,
"description": "# Grizabella\n\nA tri-layer memory framework for LLM solutions.\n\n[](https://pwilkin.github.io/grizabella/)\n[](LICENSE)\n\n## Overview\n\nGrizabella is a sophisticated memory layer designed for Large Language Model (LLM) solutions. It provides a unified interface to manage and query data across relational, vector, and graph databases, enabling complex memory and knowledge retrieval for AI applications.\n\n## Key Features\n\n* **Tri-layer Storage:** Integrates SQLite (relational), LanceDB (vector), and Kuzu (graph) for comprehensive data management.\n* **Unified Python API:** Offers a simple and consistent Python interface to interact with all three database layers.\n* **Complex Query Engine:** Allows for sophisticated queries that can span across the different data storage paradigms.\n* **PySide6 UI:** Includes an optional desktop application for visualizing and managing data.\n* **MCP Server:** Can operate as a Model Context Protocol (MCP) server, allowing other tools to leverage its memory capabilities.\n\n## Quick Links\n\n* [User Guide](./docs/user_guide/)\n* [API Reference](./docs/api_reference/build/html/)\n* [Examples](./examples/)\n* [MCP Server Startup](./scripts/README.md)\n\n## Quick Installation\n\nFor production use (once published):\n\n```bash\npip install grizabella\n```\n\nFor development:\n\n```bash\ngit clone https://github.com/pwilkin/grizabella.git\ncd grizabella\npoetry install\n```\n\n## Basic Usage Snippet\n\n```python\nfrom grizabella import Grizabella\n\n# Initialize Grizabella (connects to default in-memory databases)\ngz = Grizabella()\n\n# Define an object type (implicitly creates a table/node type)\ngz.create_object_type(\"document\", {\"text\": str, \"source\": str})\n\n# Add an object\ndoc1 = gz.add_object(\n object_type=\"document\",\n data={\"text\": \"This is the first document.\", \"source\": \"manual\"},\n vector_data={\"text\": \"This is the first document.\"} # Data for embedding\n)\n\nprint(f\"Added document with ID: {doc1.id}\")\n\n# Further operations (querying, adding relations, etc.) would go here.\n```\n\n## Contributing\n\nContributions are welcome! Please see `CONTRIBUTING.md` (to be added) for guidelines on how to contribute to Grizabella.\n\n## License\n\nGrizabella is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A tri-layer memory framework for LLM solutions.",
"version": "0.2.6",
"project_urls": {
"Documentation": "https://pwilkin.github.io/grizabella",
"Homepage": "https://github.com/pwilkin/grizabella",
"Repository": "https://github.com/pwilkin/grizabella"
},
"split_keywords": [
"python",
" llm",
" memory",
" vector-database",
" graph-database",
" sqlite",
" lancedb",
" kuzu",
" pyside6",
" sentence-transformers",
" fastmcp",
" ai",
" multi-modal"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "18b2f5c251102df64c1485e7cf6fe521d89d9abe05cbf275251a6c1532713eb6",
"md5": "6cc6c1b8dbcd9f5177a8d5b570d805c8",
"sha256": "7bb5fe30f6f820921457f4d3d2b38bd7206c595377f99cbfb42ffbaebe48c911"
},
"downloads": -1,
"filename": "grizabella-0.2.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6cc6c1b8dbcd9f5177a8d5b570d805c8",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.14,>=3.12",
"size": 163421,
"upload_time": "2025-07-26T21:44:11",
"upload_time_iso_8601": "2025-07-26T21:44:11.706201Z",
"url": "https://files.pythonhosted.org/packages/18/b2/f5c251102df64c1485e7cf6fe521d89d9abe05cbf275251a6c1532713eb6/grizabella-0.2.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "de7d29ed6c43c99e4596480d75d24fdd546b459561e81a64c349d2c4d7816936",
"md5": "c37f65b22f7a10b6d91af0d9bddce0f1",
"sha256": "6a87cb62e6fffc5e7556bb8bdc2257fb52ab74fe29fcc9b1891074eda4112906"
},
"downloads": -1,
"filename": "grizabella-0.2.6.tar.gz",
"has_sig": false,
"md5_digest": "c37f65b22f7a10b6d91af0d9bddce0f1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.14,>=3.12",
"size": 133377,
"upload_time": "2025-07-26T21:44:13",
"upload_time_iso_8601": "2025-07-26T21:44:13.551222Z",
"url": "https://files.pythonhosted.org/packages/de/7d/29ed6c43c99e4596480d75d24fdd546b459561e81a64c349d2c4d7816936/grizabella-0.2.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-26 21:44:13",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "pwilkin",
"github_project": "grizabella",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "grizabella"
}
JSON
