| Name | cognee JSON |
| Version |
0.2.0
JSON |
| download |
| home_page | https://www.cognee.ai |
| Summary | Cognee - is a library for enriching LLM context with a semantic layer for better understanding and reasoning. |
| upload_time | 2025-06-30 14:21:04 |
| maintainer | None |
| docs_url | None |
| author | Vasilije Markovic |
| requires_python | <=3.13,>=3.10 |
| license | Apache-2.0 |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
<div align="center">
<a href="https://github.com/topoteretes/cognee">
<img src="https://raw.githubusercontent.com/topoteretes/cognee/refs/heads/dev/assets/cognee-logo-transparent.png" alt="Cognee Logo" height="60">
</a>
<br />
cognee - Memory for AI Agents in 5 lines of code
<p align="center">
<a href="https://www.youtube.com/watch?v=1bezuvLwJmw&t=2s">Demo</a>
.
<a href="https://cognee.ai">Learn more</a>
·
<a href="https://discord.gg/NQPKmU5CCg">Join Discord</a>
·
<a href="https://www.reddit.com/r/AIMemory/">Join r/AIMemory</a>
</p>
[](https://GitHub.com/topoteretes/cognee/network/)
[](https://GitHub.com/topoteretes/cognee/stargazers/)
[](https://GitHub.com/topoteretes/cognee/commit/)
[](https://github.com/topoteretes/cognee/tags/)
[](https://pepy.tech/project/cognee)
[](https://github.com/topoteretes/cognee/blob/main/LICENSE)
[](https://github.com/topoteretes/cognee/graphs/contributors)
<a href="https://github.com/sponsors/topoteretes"><img src="https://img.shields.io/badge/Sponsor-❤️-ff69b4.svg" alt="Sponsor"></a>
<a href="https://www.producthunt.com/posts/cognee?embed=true&utm_source=badge-top-post-badge&utm_medium=badge&utm_souce=badge-cognee" target="_blank"><img src="https://api.producthunt.com/widgets/embed-image/v1/top-post-badge.svg?post_id=946346&theme=light&period=daily&t=1744472480704" alt="cognee - Memory for AI Agents  in 5 lines of code | Product Hunt" style="width: 250px; height: 54px;" width="250" height="54" /></a>
<a href="https://trendshift.io/repositories/13955" target="_blank"><img src="https://trendshift.io/api/badge/repositories/13955" alt="topoteretes%2Fcognee | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
**🚀 We are launching Cognee SaaS: Sign up [here](https://www.cognee.ai/waitlist) for the hosted beta!**
Build dynamic memory for Agents and replace RAG using scalable, modular ECL (Extract, Cognify, Load) pipelines.
More on [use-cases](https://docs.cognee.ai/use-cases) and [evals](https://github.com/topoteretes/cognee/tree/main/evals)
<p align="center">
🌐 Available Languages
:
<!-- Keep these links. Translations will automatically update with the README. -->
<a href="https://www.readme-i18n.com/topoteretes/cognee?lang=de">Deutsch</a> |
<a href="https://www.readme-i18n.com/topoteretes/cognee?lang=es">Español</a> |
<a href="https://www.readme-i18n.com/topoteretes/cognee?lang=fr">français</a> |
<a href="https://www.readme-i18n.com/topoteretes/cognee?lang=ja">日本語</a> |
<a href="https://www.readme-i18n.com/topoteretes/cognee?lang=ko">한국어</a> |
<a href="https://www.readme-i18n.com/topoteretes/cognee?lang=pt">Português</a> |
<a href="https://www.readme-i18n.com/topoteretes/cognee?lang=ru">Русский</a> |
<a href="https://www.readme-i18n.com/topoteretes/cognee?lang=zh">中文</a>
</p>
<div style="text-align: center">
<img src="https://raw.githubusercontent.com/topoteretes/cognee/refs/heads/main/assets/cognee_benefits.png" alt="Why cognee?" width="50%" />
</div>
</div>
## Features
- Interconnect and retrieve your past conversations, documents, images and audio transcriptions
- Replaces RAG systems and reduces developer effort, and cost.
- Load data to graph and vector databases using only Pydantic
- Manipulate your data while ingesting from 30+ data sources
## Get Started
Get started quickly with a Google Colab <a href="https://colab.research.google.com/drive/1jHbWVypDgCLwjE71GSXhRL3YxYhCZzG1?usp=sharing">notebook</a> , <a href="https://deepnote.com/workspace/cognee-382213d0-0444-4c89-8265-13770e333c02/project/cognee-demo-78ffacb9-5832-4611-bb1a-560386068b30/notebook/Notebook-1-75b24cda566d4c24ab348f7150792601?utm_source=share-modal&utm_medium=product-shared-content&utm_campaign=notebook&utm_content=78ffacb9-5832-4611-bb1a-560386068b30">Deepnote notebook</a> or <a href="https://github.com/topoteretes/cognee-starter">starter repo</a>
## Contributing
Your contributions are at the core of making this a true open source project. Any contributions you make are **greatly appreciated**. See [`CONTRIBUTING.md`](CONTRIBUTING.md) for more information.
## 📦 Installation
You can install Cognee using either **pip**, **poetry**, **uv** or any other python package manager.
Cognee supports Python 3.8 to 3.12
### With pip
```bash
pip install cognee
```
## Local Cognee installation
You can install the local Cognee repo using **pip**, **poetry** and **uv**.
For local pip installation please make sure your pip version is above version 21.3.
### with UV with all optional dependencies
```bash
uv sync --all-extras
```
## 💻 Basic Usage
### Setup
```
import os
os.environ["LLM_API_KEY"] = "YOUR OPENAI_API_KEY"
```
You can also set the variables by creating .env file, using our <a href="https://github.com/topoteretes/cognee/blob/main/.env.template">template.</a>
To use different LLM providers, for more info check out our <a href="https://docs.cognee.ai">documentation</a>
### Simple example
This script will run the default pipeline:
```python
import cognee
import asyncio
async def main():
# Add text to cognee
await cognee.add("Natural language processing (NLP) is an interdisciplinary subfield of computer science and information retrieval.")
# Generate the knowledge graph
await cognee.cognify()
# Query the knowledge graph
results = await cognee.search("Tell me about NLP")
# Display the results
for result in results:
print(result)
if __name__ == '__main__':
asyncio.run(main())
```
Example output:
```
Natural Language Processing (NLP) is a cross-disciplinary and interdisciplinary field that involves computer science and information retrieval. It focuses on the interaction between computers and human language, enabling machines to understand and process natural language.
```
## Our paper is out! <a href="https://arxiv.org/abs/2505.24478" target="_blank" rel="noopener noreferrer">Read here</a>
<div style="text-align: center">
<img src="assets/cognee-paper.png" alt="cognee paper" width="100%" />
</div>
</div>
## Cognee UI
You can also cognify your files and query using cognee UI.
<img src="assets/cognee-ui-2.webp" width="100%" alt="Cognee UI 2"></a>
Try cognee UI out locally [here](https://docs.cognee.ai/how-to-guides/cognee-ui).
## Understand our architecture
<div style="text-align: center">
<img src="assets/cognee_diagram.png" alt="cognee concept diagram" width="100%" />
</div>
## Demos
1. What is AI memory:
[Learn about cognee](https://github.com/user-attachments/assets/8b2a0050-5ec4-424c-b417-8269971503f0)
2. Simple GraphRAG demo
[Simple GraphRAG demo](https://github.com/user-attachments/assets/d80b0776-4eb9-4b8e-aa22-3691e2d44b8f)
3. cognee with Ollama
[cognee with local models](https://github.com/user-attachments/assets/8621d3e8-ecb8-4860-afb2-5594f2ee17db)
## Code of Conduct
We are committed to making open source an enjoyable and respectful experience for our community. See <a href="https://github.com/topoteretes/cognee/blob/main/CODE_OF_CONDUCT.md"><code>CODE_OF_CONDUCT</code></a> for more information.
## 💫 Contributors
<a href="https://github.com/topoteretes/cognee/graphs/contributors">
<img alt="contributors" src="https://contrib.rocks/image?repo=topoteretes/cognee"/>
</a>
## Star History
[](https://star-history.com/#topoteretes/cognee&Date)
Raw data
{
"_id": null,
"home_page": "https://www.cognee.ai",
"name": "cognee",
"maintainer": null,
"docs_url": null,
"requires_python": "<=3.13,>=3.10",
"maintainer_email": null,
"keywords": null,
"author": "Vasilije Markovic",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/f7/6a/71ecadc9cfb90a512e3857ad2f02d4c47e69611aabb6bb5b7b20ac13e4ac/cognee-0.2.0.tar.gz",
"platform": null,
"description": "<div align=\"center\">\n <a href=\"https://github.com/topoteretes/cognee\">\n <img src=\"https://raw.githubusercontent.com/topoteretes/cognee/refs/heads/dev/assets/cognee-logo-transparent.png\" alt=\"Cognee Logo\" height=\"60\">\n </a>\n\n <br />\n\n cognee - Memory for AI Agents in 5 lines of code\n\n <p align=\"center\">\n <a href=\"https://www.youtube.com/watch?v=1bezuvLwJmw&t=2s\">Demo</a>\n .\n <a href=\"https://cognee.ai\">Learn more</a>\n \u00b7\n <a href=\"https://discord.gg/NQPKmU5CCg\">Join Discord</a>\n \u00b7\n <a href=\"https://www.reddit.com/r/AIMemory/\">Join r/AIMemory</a>\n </p>\n\n\n [](https://GitHub.com/topoteretes/cognee/network/)\n [](https://GitHub.com/topoteretes/cognee/stargazers/)\n [](https://GitHub.com/topoteretes/cognee/commit/)\n [](https://github.com/topoteretes/cognee/tags/)\n [](https://pepy.tech/project/cognee)\n [](https://github.com/topoteretes/cognee/blob/main/LICENSE)\n [](https://github.com/topoteretes/cognee/graphs/contributors)\n <a href=\"https://github.com/sponsors/topoteretes\"><img src=\"https://img.shields.io/badge/Sponsor-\u2764\ufe0f-ff69b4.svg\" alt=\"Sponsor\"></a>\n\n<a href=\"https://www.producthunt.com/posts/cognee?embed=true&utm_source=badge-top-post-badge&utm_medium=badge&utm_souce=badge-cognee\" target=\"_blank\"><img src=\"https://api.producthunt.com/widgets/embed-image/v1/top-post-badge.svg?post_id=946346&theme=light&period=daily&t=1744472480704\" alt=\"cognee - Memory for AI Agents  in 5 lines of code | Product Hunt\" style=\"width: 250px; height: 54px;\" width=\"250\" height=\"54\" /></a>\n\n<a href=\"https://trendshift.io/repositories/13955\" target=\"_blank\"><img src=\"https://trendshift.io/api/badge/repositories/13955\" alt=\"topoteretes%2Fcognee | Trendshift\" style=\"width: 250px; height: 55px;\" width=\"250\" height=\"55\"/></a>\n\n\n**\ud83d\ude80 We are launching Cognee SaaS: Sign up [here](https://www.cognee.ai/waitlist) for the hosted beta!**\n\nBuild dynamic memory for Agents and replace RAG using scalable, modular ECL (Extract, Cognify, Load) pipelines.\n\nMore on [use-cases](https://docs.cognee.ai/use-cases) and [evals](https://github.com/topoteretes/cognee/tree/main/evals)\n\n <p align=\"center\">\n \ud83c\udf10 Available Languages\n :\n <!-- Keep these links. Translations will automatically update with the README. -->\n <a href=\"https://www.readme-i18n.com/topoteretes/cognee?lang=de\">Deutsch</a> |\n <a href=\"https://www.readme-i18n.com/topoteretes/cognee?lang=es\">Espa\u00f1ol</a> |\n <a href=\"https://www.readme-i18n.com/topoteretes/cognee?lang=fr\">fran\u00e7ais</a> |\n <a href=\"https://www.readme-i18n.com/topoteretes/cognee?lang=ja\">\u65e5\u672c\u8a9e</a> |\n <a href=\"https://www.readme-i18n.com/topoteretes/cognee?lang=ko\">\ud55c\uad6d\uc5b4</a> |\n <a href=\"https://www.readme-i18n.com/topoteretes/cognee?lang=pt\">Portugu\u00eas</a> |\n <a href=\"https://www.readme-i18n.com/topoteretes/cognee?lang=ru\">\u0420\u0443\u0441\u0441\u043a\u0438\u0439</a> |\n <a href=\"https://www.readme-i18n.com/topoteretes/cognee?lang=zh\">\u4e2d\u6587</a>\n </p>\n\n\n<div style=\"text-align: center\">\n <img src=\"https://raw.githubusercontent.com/topoteretes/cognee/refs/heads/main/assets/cognee_benefits.png\" alt=\"Why cognee?\" width=\"50%\" />\n</div>\n</div>\n\n\n## Features\n\n- Interconnect and retrieve your past conversations, documents, images and audio transcriptions\n- Replaces RAG systems and reduces developer effort, and cost.\n- Load data to graph and vector databases using only Pydantic\n- Manipulate your data while ingesting from 30+ data sources\n\n## Get Started\n\nGet started quickly with a Google Colab <a href=\"https://colab.research.google.com/drive/1jHbWVypDgCLwjE71GSXhRL3YxYhCZzG1?usp=sharing\">notebook</a> , <a href=\"https://deepnote.com/workspace/cognee-382213d0-0444-4c89-8265-13770e333c02/project/cognee-demo-78ffacb9-5832-4611-bb1a-560386068b30/notebook/Notebook-1-75b24cda566d4c24ab348f7150792601?utm_source=share-modal&utm_medium=product-shared-content&utm_campaign=notebook&utm_content=78ffacb9-5832-4611-bb1a-560386068b30\">Deepnote notebook</a> or <a href=\"https://github.com/topoteretes/cognee-starter\">starter repo</a>\n\n\n## Contributing\nYour contributions are at the core of making this a true open source project. Any contributions you make are **greatly appreciated**. See [`CONTRIBUTING.md`](CONTRIBUTING.md) for more information.\n\n\n\n\n\n## \ud83d\udce6 Installation\n\nYou can install Cognee using either **pip**, **poetry**, **uv** or any other python package manager.\nCognee supports Python 3.8 to 3.12\n\n### With pip\n\n```bash\npip install cognee\n```\n\n## Local Cognee installation\n\nYou can install the local Cognee repo using **pip**, **poetry** and **uv**.\nFor local pip installation please make sure your pip version is above version 21.3.\n\n### with UV with all optional dependencies\n\n```bash\nuv sync --all-extras\n```\n\n## \ud83d\udcbb Basic Usage\n\n### Setup\n\n```\nimport os\nos.environ[\"LLM_API_KEY\"] = \"YOUR OPENAI_API_KEY\"\n\n```\n\nYou can also set the variables by creating .env file, using our <a href=\"https://github.com/topoteretes/cognee/blob/main/.env.template\">template.</a>\nTo use different LLM providers, for more info check out our <a href=\"https://docs.cognee.ai\">documentation</a>\n\n\n### Simple example\n\nThis script will run the default pipeline:\n\n```python\nimport cognee\nimport asyncio\n\n\nasync def main():\n # Add text to cognee\n await cognee.add(\"Natural language processing (NLP) is an interdisciplinary subfield of computer science and information retrieval.\")\n\n # Generate the knowledge graph\n await cognee.cognify()\n\n # Query the knowledge graph\n results = await cognee.search(\"Tell me about NLP\")\n\n # Display the results\n for result in results:\n print(result)\n\n\nif __name__ == '__main__':\n asyncio.run(main())\n\n```\nExample output:\n```\n Natural Language Processing (NLP) is a cross-disciplinary and interdisciplinary field that involves computer science and information retrieval. It focuses on the interaction between computers and human language, enabling machines to understand and process natural language.\n\n```\n\n## Our paper is out! <a href=\"https://arxiv.org/abs/2505.24478\" target=\"_blank\" rel=\"noopener noreferrer\">Read here</a>\n\n<div style=\"text-align: center\">\n <img src=\"assets/cognee-paper.png\" alt=\"cognee paper\" width=\"100%\" />\n</div>\n\n</div>\n\n## Cognee UI\n\nYou can also cognify your files and query using cognee UI.\n\n<img src=\"assets/cognee-ui-2.webp\" width=\"100%\" alt=\"Cognee UI 2\"></a>\n\nTry cognee UI out locally [here](https://docs.cognee.ai/how-to-guides/cognee-ui).\n\n## Understand our architecture\n\n<div style=\"text-align: center\">\n <img src=\"assets/cognee_diagram.png\" alt=\"cognee concept diagram\" width=\"100%\" />\n</div>\n\n\n\n## Demos\n\n1. What is AI memory:\n\n[Learn about cognee](https://github.com/user-attachments/assets/8b2a0050-5ec4-424c-b417-8269971503f0)\n\n2. Simple GraphRAG demo\n\n[Simple GraphRAG demo](https://github.com/user-attachments/assets/d80b0776-4eb9-4b8e-aa22-3691e2d44b8f)\n\n3. cognee with Ollama\n\n[cognee with local models](https://github.com/user-attachments/assets/8621d3e8-ecb8-4860-afb2-5594f2ee17db)\n\n\n## Code of Conduct\n\nWe are committed to making open source an enjoyable and respectful experience for our community. See <a href=\"https://github.com/topoteretes/cognee/blob/main/CODE_OF_CONDUCT.md\"><code>CODE_OF_CONDUCT</code></a> for more information.\n\n## \ud83d\udcab Contributors\n\n<a href=\"https://github.com/topoteretes/cognee/graphs/contributors\">\n <img alt=\"contributors\" src=\"https://contrib.rocks/image?repo=topoteretes/cognee\"/>\n</a>\n\n\n## Star History\n\n[](https://star-history.com/#topoteretes/cognee&Date)\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Cognee - is a library for enriching LLM context with a semantic layer for better understanding and reasoning.",
"version": "0.2.0",
"project_urls": {
"Homepage": "https://www.cognee.ai",
"Repository": "https://github.com/topoteretes/cognee"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "13fef44e5217b40b49be8b238dcbe0dce3d45d3ae18284218d0b43039cf8235b",
"md5": "6ca9b16863d6ef1d10220358307077c1",
"sha256": "e11d76c8a56dc75045095f14f8efbd1a52357818688724c7e6ab147fbb1a447e"
},
"downloads": -1,
"filename": "cognee-0.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6ca9b16863d6ef1d10220358307077c1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<=3.13,>=3.10",
"size": 963410,
"upload_time": "2025-06-30T14:20:50",
"upload_time_iso_8601": "2025-06-30T14:20:50.165043Z",
"url": "https://files.pythonhosted.org/packages/13/fe/f44e5217b40b49be8b238dcbe0dce3d45d3ae18284218d0b43039cf8235b/cognee-0.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f76a71ecadc9cfb90a512e3857ad2f02d4c47e69611aabb6bb5b7b20ac13e4ac",
"md5": "9cf00dc8598838bace352a60658e4fba",
"sha256": "3ae302040dfe36dffcfb991452249c121f3f82787b99db0205a82a278112ac71"
},
"downloads": -1,
"filename": "cognee-0.2.0.tar.gz",
"has_sig": false,
"md5_digest": "9cf00dc8598838bace352a60658e4fba",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<=3.13,>=3.10",
"size": 15453724,
"upload_time": "2025-06-30T14:21:04",
"upload_time_iso_8601": "2025-06-30T14:21:04.301555Z",
"url": "https://files.pythonhosted.org/packages/f7/6a/71ecadc9cfb90a512e3857ad2f02d4c47e69611aabb6bb5b7b20ac13e4ac/cognee-0.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-06-30 14:21:04",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "topoteretes",
"github_project": "cognee",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "cognee"
}
