# topoteretes/cognee-community architecture

> Architecture diagram of the GitHub repository topoteretes/cognee-community, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/topoteretes/cognee-community
- Repository: https://github.com/topoteretes/cognee-community

## Overview

Cognee Community is a collection of installable plugins and experimental applications for building AI memory: database adapters, data connectors, custom pipelines/tasks, and retrievers. The documented usage is to install a package, configure Cognee and a database or data source, and use the selected extension from Cognee. The sampled code additionally shows a code-ingestion pipeline and a code retriever. Many adapters and demos are listed but not sampled, so their internal wiring is omitted; README-supported plugin relationships are retained.

Main entry points: [`packages/connector/google-drive/cognee_community_connector_google_drive/google_drive.py`](https://github.com/topoteretes/cognee-community/blob/main/packages/connector/google-drive/cognee_community_connector_google_drive/google_drive.py) (Google Drive), [`packages/graph/typedb/cognee_community_graph_adapter_typedb/typedb_adapter.py`](https://github.com/topoteretes/cognee-community/blob/main/packages/graph/typedb/cognee_community_graph_adapter_typedb/typedb_adapter.py) (TypeDB adapter), [`packages/pipeline/codify_pipeline/cognee_community_pipeline_codify/code_graph_pipeline.py`](https://github.com/topoteretes/cognee-community/blob/main/packages/pipeline/codify_pipeline/cognee_community_pipeline_codify/code_graph_pipeline.py) (Code graph pipeline), [`packages/retriever/code_retriever/cognee_community_retriever_code/code_retriever.py`](https://github.com/topoteretes/cognee-community/blob/main/packages/retriever/code_retriever/cognee_community_retriever_code/code_retriever.py) (Code retriever)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_connectors["Data connectors"]
  node_connectors["Source connectors"]
  node_google_drive["Google Drive<br/>[google_drive.py]"]
  node_gmail["Gmail<br/>[gmail.py]"]
  node_confluence["Confluence<br/>[confluence.py]"]
  node_notion["Notion<br/>[notion.py]"]
  node_slack["Slack<br/>[slack_export.py]"]
end

subgraph group_storage["Database adapters"]
  node_vector_adapters["Vector adapters"]
  node_azure_vector[("Azure AI Search")]
  node_graph_adapters["Graph adapters"]
  node_typedb_adapter[("TypeDB adapter<br/>[typedb_adapter.py]")]
  node_typedb_handler["TypeDB dataset handler"]
  node_typedb_provenance["TypeDB provenance<br/>[provenance.py]"]
  node_typedb_queries["TypeDB queries<br/>[queries.py]"]
  node_hybrid_adapters["Hybrid adapters"]
end

subgraph group_processing["Pipelines and tasks"]
  node_code_pipeline["Code graph pipeline"]
  node_repo_dependencies["Repository dependencies"]
  node_local_dependencies["Local dependencies"]
  node_noncode_files["Non-code files"]
  node_embedding_limits["Embedding limits"]
  node_exa_task["Exa web search<br/>[exa_task.py]"]
  node_scrapegraph_task["ScrapeGraph task"]
end

subgraph group_retrieval["Retrieval and observability"]
  node_code_retriever["Code retriever<br/>[code_retriever.py]"]
  node_observability["Keywords AI"]
end

subgraph group_demos["Experimental applications"]
  node_dlt_backend["DLT demo backend<br/>[backend.py]"]
  node_faq_query["FAQ query demo<br/>[query.py]"]
end

node_user(("Developer or agent"))
node_cognee["Cognee core"]
node_external_sources["External data sources"]

node_user -->|"selects source"| node_google_drive
node_google_drive -->|"reads files"| node_external_sources
node_google_drive -->|"provides ingestion resource"| node_cognee
node_user -->|"uses plugins"| node_cognee
node_cognee -->|"uses extensions"| node_connectors
node_cognee -->|"uses extensions"| node_vector_adapters
node_cognee -->|"uses extensions"| node_graph_adapters
node_cognee -->|"uses extensions"| node_hybrid_adapters
node_cognee -->|"runs pipeline"| node_code_pipeline
node_cognee -->|"uses extension"| node_code_retriever
node_code_pipeline -->|"runs task"| node_repo_dependencies
node_code_pipeline -->|"optionally runs"| node_noncode_files
node_repo_dependencies -->|"imports helper"| node_local_dependencies
node_code_retriever -->|"searches vectors"| node_vector_adapters
node_code_retriever -->|"reads connections"| node_graph_adapters
node_typedb_handler -->|"provisions database"| node_typedb_adapter
node_typedb_adapter -->|"uses provenance"| node_typedb_provenance
node_typedb_adapter -->|"uses queries"| node_typedb_queries
node_faq_query -->|"searches datasets"| node_cognee

click node_connectors "https://github.com/topoteretes/cognee-community/tree/main/packages/connector"
click node_google_drive "https://github.com/topoteretes/cognee-community/blob/main/packages/connector/google-drive/cognee_community_connector_google_drive/google_drive.py"
click node_gmail "https://github.com/topoteretes/cognee-community/blob/main/packages/connector/gmail/cognee_community_connector_gmail/gmail.py"
click node_confluence "https://github.com/topoteretes/cognee-community/blob/main/packages/connector/confluence/cognee_community_connector_confluence/confluence.py"
click node_notion "https://github.com/topoteretes/cognee-community/blob/main/packages/connector/notion/cognee_community_connector_notion/notion.py"
click node_slack "https://github.com/topoteretes/cognee-community/blob/main/packages/connector/slack/cognee_community_connector_slack/slack_export.py"
click node_vector_adapters "https://github.com/topoteretes/cognee-community/tree/main/packages/vector"
click node_azure_vector "https://github.com/topoteretes/cognee-community/blob/main/packages/vector/azureaisearch/cognee_community_vector_adapter_azure/azureaisearch_adapter.py"
click node_graph_adapters "https://github.com/topoteretes/cognee-community/tree/main/packages/graph"
click node_typedb_adapter "https://github.com/topoteretes/cognee-community/blob/main/packages/graph/typedb/cognee_community_graph_adapter_typedb/typedb_adapter.py"
click node_typedb_handler "https://github.com/topoteretes/cognee-community/blob/main/packages/graph/typedb/cognee_community_graph_adapter_typedb/TypeDBDatasetDatabaseHandler.py"
click node_typedb_provenance "https://github.com/topoteretes/cognee-community/blob/main/packages/graph/typedb/cognee_community_graph_adapter_typedb/provenance.py"
click node_typedb_queries "https://github.com/topoteretes/cognee-community/blob/main/packages/graph/typedb/cognee_community_graph_adapter_typedb/queries.py"
click node_hybrid_adapters "https://github.com/topoteretes/cognee-community/tree/main/packages/hybrid"
click node_code_pipeline "https://github.com/topoteretes/cognee-community/blob/main/packages/pipeline/codify_pipeline/cognee_community_pipeline_codify/code_graph_pipeline.py"
click node_repo_dependencies "https://github.com/topoteretes/cognee-community/blob/main/packages/task/codify_tasks/cognee_community_tasks_codify/get_repo_file_dependencies.py"
click node_local_dependencies "https://github.com/topoteretes/cognee-community/blob/main/packages/task/codify_tasks/cognee_community_tasks_codify/get_local_dependencies.py"
click node_noncode_files "https://github.com/topoteretes/cognee-community/blob/main/packages/task/codify_tasks/cognee_community_tasks_codify/get_non_code_files.py"
click node_embedding_limits "https://github.com/topoteretes/cognee-community/blob/main/packages/task/codify_tasks/cognee_community_tasks_codify/embedding_limits.py"
click node_exa_task "https://github.com/topoteretes/cognee-community/blob/main/packages/task/exa_tasks/cognee_community_tasks_exa/exa_task.py"
click node_scrapegraph_task "https://github.com/topoteretes/cognee-community/blob/main/packages/task/scrapegraph_tasks/cognee_community_tasks_scrapegraph/scrapegraph_task.py"
click node_code_retriever "https://github.com/topoteretes/cognee-community/blob/main/packages/retriever/code_retriever/cognee_community_retriever_code/code_retriever.py"
click node_observability "https://github.com/topoteretes/cognee-community/blob/main/packages/observability/keywordsai/cognee_community_observability_keywordsai/keywordsai_adapter.py"
click node_dlt_backend "https://github.com/topoteretes/cognee-community/blob/main/experimental/dlt_demo/backend.py"
click node_faq_query "https://github.com/topoteretes/cognee-community/blob/main/experimental/faq_assistant_qdrant_docs/query.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_connectors,node_google_drive,node_gmail,node_confluence,node_notion,node_slack toneBlue
class node_vector_adapters,node_azure_vector,node_graph_adapters,node_typedb_adapter,node_typedb_handler,node_typedb_provenance,node_typedb_queries,node_hybrid_adapters toneAmber
class node_code_pipeline,node_repo_dependencies,node_local_dependencies,node_noncode_files,node_embedding_limits,node_exa_task,node_scrapegraph_task toneMint
class node_code_retriever,node_observability toneRose
class node_dlt_backend,node_faq_query,node_user,node_cognee,node_external_sources toneIndigo
```

## Components

### Data connectors

- [Source connectors](https://github.com/topoteretes/cognee-community/tree/main/packages/connector): `packages/connector`
- [Google Drive](https://github.com/topoteretes/cognee-community/blob/main/packages/connector/google-drive/cognee_community_connector_google_drive/google_drive.py): `packages/connector/google-drive/cognee_community_connector_google_drive/google_drive.py`
- [Gmail](https://github.com/topoteretes/cognee-community/blob/main/packages/connector/gmail/cognee_community_connector_gmail/gmail.py): `packages/connector/gmail/cognee_community_connector_gmail/gmail.py`
- [Confluence](https://github.com/topoteretes/cognee-community/blob/main/packages/connector/confluence/cognee_community_connector_confluence/confluence.py): `packages/connector/confluence/cognee_community_connector_confluence/confluence.py`
- [Notion](https://github.com/topoteretes/cognee-community/blob/main/packages/connector/notion/cognee_community_connector_notion/notion.py): `packages/connector/notion/cognee_community_connector_notion/notion.py`
- [Slack](https://github.com/topoteretes/cognee-community/blob/main/packages/connector/slack/cognee_community_connector_slack/slack_export.py): `packages/connector/slack/cognee_community_connector_slack/slack_export.py`

### Database adapters

- [Vector adapters](https://github.com/topoteretes/cognee-community/tree/main/packages/vector): `packages/vector`
- [Azure AI Search](https://github.com/topoteretes/cognee-community/blob/main/packages/vector/azureaisearch/cognee_community_vector_adapter_azure/azureaisearch_adapter.py): `packages/vector/azureaisearch/cognee_community_vector_adapter_azure/azureaisearch_adapter.py`
- [Graph adapters](https://github.com/topoteretes/cognee-community/tree/main/packages/graph): `packages/graph`
- [TypeDB adapter](https://github.com/topoteretes/cognee-community/blob/main/packages/graph/typedb/cognee_community_graph_adapter_typedb/typedb_adapter.py): `packages/graph/typedb/cognee_community_graph_adapter_typedb/typedb_adapter.py`
- [TypeDB dataset handler](https://github.com/topoteretes/cognee-community/blob/main/packages/graph/typedb/cognee_community_graph_adapter_typedb/TypeDBDatasetDatabaseHandler.py): `packages/graph/typedb/cognee_community_graph_adapter_typedb/TypeDBDatasetDatabaseHandler.py`
- [TypeDB provenance](https://github.com/topoteretes/cognee-community/blob/main/packages/graph/typedb/cognee_community_graph_adapter_typedb/provenance.py): `packages/graph/typedb/cognee_community_graph_adapter_typedb/provenance.py`
- [TypeDB queries](https://github.com/topoteretes/cognee-community/blob/main/packages/graph/typedb/cognee_community_graph_adapter_typedb/queries.py): `packages/graph/typedb/cognee_community_graph_adapter_typedb/queries.py`
- [Hybrid adapters](https://github.com/topoteretes/cognee-community/tree/main/packages/hybrid): `packages/hybrid`

### Pipelines and tasks

- [Code graph pipeline](https://github.com/topoteretes/cognee-community/blob/main/packages/pipeline/codify_pipeline/cognee_community_pipeline_codify/code_graph_pipeline.py): `packages/pipeline/codify_pipeline/cognee_community_pipeline_codify/code_graph_pipeline.py`
- [Repository dependencies](https://github.com/topoteretes/cognee-community/blob/main/packages/task/codify_tasks/cognee_community_tasks_codify/get_repo_file_dependencies.py): `packages/task/codify_tasks/cognee_community_tasks_codify/get_repo_file_dependencies.py`
- [Local dependencies](https://github.com/topoteretes/cognee-community/blob/main/packages/task/codify_tasks/cognee_community_tasks_codify/get_local_dependencies.py): `packages/task/codify_tasks/cognee_community_tasks_codify/get_local_dependencies.py`
- [Non-code files](https://github.com/topoteretes/cognee-community/blob/main/packages/task/codify_tasks/cognee_community_tasks_codify/get_non_code_files.py): `packages/task/codify_tasks/cognee_community_tasks_codify/get_non_code_files.py`
- [Embedding limits](https://github.com/topoteretes/cognee-community/blob/main/packages/task/codify_tasks/cognee_community_tasks_codify/embedding_limits.py): `packages/task/codify_tasks/cognee_community_tasks_codify/embedding_limits.py`
- [Exa web search](https://github.com/topoteretes/cognee-community/blob/main/packages/task/exa_tasks/cognee_community_tasks_exa/exa_task.py): `packages/task/exa_tasks/cognee_community_tasks_exa/exa_task.py`
- [ScrapeGraph task](https://github.com/topoteretes/cognee-community/blob/main/packages/task/scrapegraph_tasks/cognee_community_tasks_scrapegraph/scrapegraph_task.py): `packages/task/scrapegraph_tasks/cognee_community_tasks_scrapegraph/scrapegraph_task.py`

### Retrieval and observability

- [Code retriever](https://github.com/topoteretes/cognee-community/blob/main/packages/retriever/code_retriever/cognee_community_retriever_code/code_retriever.py): `packages/retriever/code_retriever/cognee_community_retriever_code/code_retriever.py`
- [Keywords AI](https://github.com/topoteretes/cognee-community/blob/main/packages/observability/keywordsai/cognee_community_observability_keywordsai/keywordsai_adapter.py): `packages/observability/keywordsai/cognee_community_observability_keywordsai/keywordsai_adapter.py`

### Experimental applications

- [DLT demo backend](https://github.com/topoteretes/cognee-community/blob/main/experimental/dlt_demo/backend.py): `experimental/dlt_demo/backend.py`
- [FAQ query demo](https://github.com/topoteretes/cognee-community/blob/main/experimental/faq_assistant_qdrant_docs/query.py): `experimental/faq_assistant_qdrant_docs/query.py`

### Other components

- **Developer or agent**
- **Cognee core**
- **External data sources**

## Connections

- Developer or agent → Google Drive: selects source (evidence: `packages/connector/google-drive/cognee_community_connector_google_drive/google_drive.py`)
- Google Drive → External data sources: reads files (evidence: `packages/connector/google-drive/cognee_community_connector_google_drive/google_drive.py`)
- Google Drive → Cognee core: provides ingestion resource (evidence: `packages/connector/google-drive/cognee_community_connector_google_drive/google_drive.py`)
- Developer or agent → Cognee core: uses plugins (evidence: `README.md`)
- Cognee core → Source connectors: uses extensions (evidence: `README.md`)
- Cognee core → Vector adapters: uses extensions (evidence: `README.md`)
- Cognee core → Graph adapters: uses extensions (evidence: `README.md`)
- Cognee core → Hybrid adapters: uses extensions (evidence: `README.md`)
- Cognee core → Code graph pipeline: runs pipeline (evidence: `README.md`)
- Cognee core → Code retriever: uses extension (evidence: `README.md`)
- Code graph pipeline → Repository dependencies: runs task (evidence: `packages/pipeline/codify_pipeline/cognee_community_pipeline_codify/code_graph_pipeline.py`)
- Code graph pipeline → Non-code files: optionally runs (evidence: `packages/pipeline/codify_pipeline/cognee_community_pipeline_codify/code_graph_pipeline.py`)
- Repository dependencies → Local dependencies: imports helper (evidence: `packages/task/codify_tasks/cognee_community_tasks_codify/get_repo_file_dependencies.py`)
- Code retriever → Vector adapters: searches vectors (evidence: `packages/retriever/code_retriever/cognee_community_retriever_code/code_retriever.py`)
- Code retriever → Graph adapters: reads connections (evidence: `packages/retriever/code_retriever/cognee_community_retriever_code/code_retriever.py`)
- TypeDB dataset handler → TypeDB adapter: provisions database (evidence: `packages/graph/typedb/cognee_community_graph_adapter_typedb/TypeDBDatasetDatabaseHandler.py`)
- TypeDB adapter → TypeDB provenance: uses provenance (evidence: `packages/graph/typedb/cognee_community_graph_adapter_typedb/typedb_adapter.py`)
- TypeDB adapter → TypeDB queries: uses queries (evidence: `packages/graph/typedb/cognee_community_graph_adapter_typedb/typedb_adapter.py`)
- FAQ query demo → Cognee core: searches datasets (evidence: `experimental/faq_assistant_qdrant_docs/query.py`)
