cognee

library1.1.3pypypiunverified

Cognee is a Python library for enriching LLM context with a semantic layer, enabling better understanding and reasoning. It provides memory management, knowledge graph construction, and ontology support. Current version is 1.0.3, with active development on 1.0.4.dev0. Release cadence is rapid, with multiple minor/patch releases per month.

llm-agents ai-ml database

pip install cognee

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · COGNEE

cognee

llm-agentspythonv1.1.3

Install

43.1s avg

Import

—

Disk

912MB

Pass rate

5/ 10

Env Coverage5 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.1.3 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

build_error

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 43.1s · import 0.000s · 837MB

912MB installed

● package 912MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

CogneeClient

✓ from cognee import CogneeClient

Memory

✓ from cognee import Memory

Basic usage: create a client, add a memory, and search.

import os from cognee import CogneeClient api_key = os.environ.get('COGNEE_API_KEY', '') client = CogneeClient(api_key=api_key) # Add a memory memory = client.add_memory("The Eiffel Tower is in Paris.") print(memory) # Search memories results = client.search("Where is the Eiffel Tower?") print(results)

cognee --version

Debug

Known issues

gotchaCogneeClient requires an API key by default. Without it, operations may fail silently. Always set the COGNEE_API_KEY environment variable or pass api_key explicitly.

fix

Set environment variable: export COGNEE_API_KEY='your_key' or pass api_key='your_key' to CogneeClient.

affects: >=1.0.0

breakingIn v1.0.0, caching was enabled by default. If you rely on immediate data freshness, you may need to disable caching or clear cache explicitly.

fix

To disable caching, set cache_enabled=False in the client constructor.

affects: 1.0.0

gotchaMemory synchronization across devices may be unreliable in v1.0.2 and earlier. Upgrading to v1.0.3+ is recommended for production use.

fix

Upgrade to v1.0.3 or later: pip install --upgrade cognee

affects: <=1.0.2

Upgrade

Version history

1.1.3latest on PyPI · released Jun 18, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

13 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/topoteretes/cognee ↗

packagehttps://pypi.org/project/cognee/ ↗

homepagehttps://www.cognee.ai ↗