cognee-community

Use and contribute cognee-community packages

Community-maintained plugins live in a separate monorepo:

https://github.com/topoteretes/cognee-community. Everything installable is

under packages/; experimental/ holds demos (n8n nodes, dlt demos,

bauplan, tower) that are not published packages. Each package publishes to

PyPI as cognee-community-<family>-<kind>-<name> and imports as the same

name with underscores.

Package families

| Family | Packages |

|---|---|

| Vector adapters | azureaisearch, milvus, moss, opengauss, opensearch, pinecone, qdrant, redis, singlestore, turbopuffer, valkey, weaviate |

| Graph adapters | arcadedb, memgraph, networkx, pggraph, spanner, turbopuffer, turingdb |

| Hybrid (graph+vector in one DB) | arcadedb, duckdb, falkordb, helixdb |

| Connectors (data sources) | confluence, gmail, google-drive, notion, slack |

| Tasks / pipelines / retrievers | codify_tasks, codify_pipeline, code_retriever, exa_tasks, scrapegraph_tasks |

| Observability | keywordsai (MONITORING_TOOL=keywordsai + KEYWORDSAI_API_KEY) |

Using a database adapter

Install, then **import the package's register module before cognee touches

any engine** — registration is what makes the provider name valid:

uv pip install cognee-community-vector-adapter-qdrant

import cognee
from cognee import config
from cognee_community_vector_adapter_qdrant import register  # noqa: F401

config.set_vector_db_config({
    "vector_db_provider": "qdrant",
    "vector_db_url": "http://localhost:6333",
    "vector_db_key": "...",
    "vector_dataset_database_handler": "qdrant",  # only if the adapter ships one
})

The register.py calls use_vector_adapter(name, AdapterClass) /

use_graph_adapter(...). Setting VECTOR_DB_PROVIDER/GRAPH_DATABASE_PROVIDER

to a community name without the register import raises "Unsupported

vector database provider". Hybrid adapters (e.g. falkordb) register as both

graph and vector — set both configs to the same provider name.

Multi-tenancy caveat: with ENABLE_BACKEND_ACCESS_CONTROL=true (the

default), both backends must have a dataset-database handler or cognee raises

EnvironmentError. Community adapters that ship one (registered via

use_dataset_database_handler in their register.py): qdrant, moss,

singlestore, turbopuffer (vector + graph), falkordb, arcadedb, helixdb. All

other community adapters need ENABLE_BACKEND_ACCESS_CONTROL=false.

Using a connector

Connectors expose a dlt source you hand straight to remember(); they

reuse core's DLT ingestion path, so snapshot sync and forget-on-delete work

with no core changes:

from cognee_community_connector_slack import slack_export_source

await cognee.remember(
    slack_export_source("/path/to/slack-export"),
    dataset_name="team-slack-export",  # use a dedicated dataset
    max_rows_per_table=0,
)

Same shape for gmail ("ask my inbox"), notion, confluence, and google-drive

(incremental, forget-on-delete). Each package README documents its

credentials; always give a connector its own dataset.

Verifying an install

Every package has examples/example.py (run uv run python examples/example.py

from the package dir) and a tests/ directory. An LLM API key is still

required (LLM_API_KEY, OpenAI by default).

Contributing a package

• Branch from main — unlike the core repo, cognee-community does not

use a dev branch.

• Follow the existing structure: package dir under packages/<family>/<name>/

with pyproject.toml, a README.md (install + usage), examples/example.py,

and tests/ that go beyond the example.

• New DB adapters implement VectorDBInterface / GraphDBInterface from

core, expose a register.py, and should run the shared conformance tests

in packages/shared/contract_suite/ (vector_contract.py / graph_contract.py).

• Add a handler via use_dataset_database_handler(...) if the backend can

isolate per user+dataset — that's what makes it work with access control on.

• Name it cognee-community-<family>-<kind>-<name> and add it to the tables

in the repo README. Lint config is the repo-root ruff.toml.