Skip to content

Cognee 项目评测报告

🏆 核心结论(先看这里!)

推荐指数:⭐⭐⭐⭐⭐ (5/5)

一句话总结
14.5k Stars 的开源知识引擎,6 行代码为 AI Agent 构建持久化记忆,支持 Vector + Graph 双检索模式。

核心价值

极简使用 - 6 行代码即可完成文档索引和检索
双模检索 - Vector 语义搜索 + Graph 关系查询
持久记忆 - AI Agent 跨会话知识保留
本地运行 - 完全本地化,数据隐私可控


📸 产品展示

Cognee Benefits

Cognee 知识引擎核心优势:统一摄取、图/向量搜索、本体落地、多模态支持

核心工作流程

┌─────────────────────────────────────────────────────────────┐
│                    Cognee 工作流程                           │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  Step 1: Ingest (摄取)                                      │
│  └── 文档/PDF/JSON/数据库 → 结构化数据                       │
│                                                             │
│  Step 2: Cognify (认知)                                     │
│  └── LLM 提取实体/关系 → 知识图谱构建                        │
│                                                             │
│  Step 3: Search (检索)                                      │
│  └── Vector 搜索 + Graph 遍历 → 上下文返回                   │
│                                                             │
│  特性:                                                      │
│  ├── 持久化存储 - 跨会话记忆                                 │
│  ├── 反馈学习 - 从用户反馈优化                               │
│  ├── 多租户 - 用户/租户隔离                                  │
│  └── 可追溯 - OTEL 收集器 + 审计追踪                         │
│                                                             │
└─────────────────────────────────────────────────────────────┘

架构概览

┌─────────────────────────────────────────────────────────────┐
│                    Cognee 架构                               │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  数据源层                                                    │
│  ├── 文档 (PDF/Word/Markdown)                               │
│  ├── 结构化数据 (JSON/CSV/数据库)                            │
│  └── 多模态 (图像/音频)                                      │
│                                                             │
│  处理层                                                      │
│  ├── DLT 数据加载                                           │
│  ├── LLM 实体提取                                           │
│  └── 知识图谱构建                                           │
│                                                             │
│  存储层                                                      │
│  ├── Vector DB (Qdrant/Weaviate/Pinecone)                  │
│  ├── Graph DB (Neo4j/NetworkX/Kuzu)                        │
│  └── 关系数据库 (PostgreSQL)                                │
│                                                             │
│  检索层                                                      │
│  ├── Vector Search (语义匹配)                               │
│  ├── Graph Traversal (关系查询)                             │
│  └── Hybrid Search (混合检索)                               │
│                                                             │
│  集成层                                                      │
│  ├── REST API                                               │
│  ├── Python SDK                                             │
│  ├── CLI 工具                                               │
│  └── MCP Server                                             │
│                                                             │
└─────────────────────────────────────────────────────────────┘

📌 基本信息

项目信息
GitHubtopoteretes/cognee
Stars14.5k
Forks1.4k
LicenseApache 2.0
主要语言Python
Python 版本3.10 - 3.13
Commits6,122+
Contributors60+
分类ai-tools

🎯 核心特性

功能矩阵

模块功能说明
数据摄取多格式支持文档/PDF/JSON/数据库/多模态
知识图谱自动构建LLM 实体提取 + 关系构建
双模检索Vector + Graph语义匹配 + 关系遍历
持久记忆跨会话保留AI Agent 长期记忆
多租户用户隔离数据安全 + 权限控制
本地运行完全本地化隐私可控
MCP ServerAI 工具集成Claude/其他 Agent 框架

核心能力

1. 6 行代码快速开始

python
import cognee
import asyncio

async def main():
    await cognee.add("Cognee turns documents into AI memory.")
    await cognee.cognify()
    results = await cognee.search("What does Cognee do?")
    print(results)

asyncio.run(main())

2. 双模检索系统

Vector Search:
├── 语义相似度匹配
├── 适合模糊查询
└── 快速召回

Graph Traversal:
├── 实体关系查询
├── 多跳推理
└── 精确关联

Hybrid Search:
├── Vector 召回 + Graph 排序
└── 最佳检索质量

3. 多存储后端支持

Vector Stores:
├── Qdrant (推荐)
├── Weaviate
├── Pinecone
├── Milvus
└── pgvector

Graph Databases:
├── Neo4j (推荐)
├── NetworkX (本地)
├── Kuzu (轻量)
└── Amazon Neptune

4. MCP Server 集成

bash
# 安装 MCP Server
pip install cognee-mcp

# 配置 Claude Desktop
{
  "mcpServers": {
    "cognee": {
      "command": "cognee-mcp"
    }
  }
}

🏗️ 技术架构

技术栈

层级技术选型
语言Python 3.10+
数据处理DLT (Data Load Tool)
LLM 集成OpenAI/Anthropic/Ollama/LM Studio
Vector DBQdrant/Weaviate/Pinecone/Milvus
Graph DBNeo4j/NetworkX/Kuzu
关系数据库PostgreSQL + SQLAlchemy
APIFastAPI
CLIcognee-cli
MCPcognee-mcp

目录结构

cognee/
├── cognee/                  # 核心库
│   ├── modules/             # 功能模块
│   │   ├── data/           # 数据处理
│   │   ├── graph/          # 图谱构建
│   │   ├── search/         # 检索引擎
│   │   └── storage/        # 存储层
│   ├── infrastructure/      # 基础设施
│   └── api/                # REST API
├── cognee-mcp/             # MCP Server
├── cognee-frontend/        # Web UI
├── cognee-starter-kit/     # 快速开始模板
├── deployment/             # 部署配置
│   ├── docker/            # Docker 部署
│   └── helm/              # Kubernetes 部署
├── examples/              # 示例代码
├── notebooks/             # Jupyter Notebooks
└── evals/                 # 评估脚本

核心模块

  • cognee.add(): 数据摄取
  • cognee.cognify(): 知识图谱构建
  • cognee.search(): 双模检索
  • cognee.delete(): 数据删除
  • cognee-mcp: MCP 服务器

💡 安装与使用

环境要求

  • Python 3.10 - 3.13
  • 可选: Docker (容器化部署)
  • 可选: Neo4j/PostgreSQL (生产环境)

快速安装

bash
# 方式 1: pip 安装
pip install cognee

# 方式 2: uv 安装 (推荐)
uv pip install cognee

# 方式 3: Docker
docker run -p 8000:8000 topoteretes/cognee

# 方式 4: 从源码
git clone https://github.com/topoteretes/cognee.git
cd cognee
pip install -e .

基础配置

python
# .env 配置
LLM_API_KEY=your_openai_api_key

# 或使用其他 LLM 提供商
LLM_PROVIDER=ollama
LLM_MODEL=llama3.2
LLM_ENDPOINT=http://localhost:11434

CLI 使用

bash
# 添加数据
cognee-cli add "Your document content here"

# 构建知识图谱
cognee-cli cognify

# 搜索
cognee-cli search "Your query"

# 删除所有数据
cognee-cli delete --all

# 启动本地 UI
cognee-cli -ui

Python SDK 使用

python
import cognee
import asyncio

async def main():
    # 1. 摄取数据
    await cognee.add("document.pdf")
    await cognee.add("data.json")
    
    # 2. 构建知识图谱
    await cognee.cognify()
    
    # 3. 搜索
    results = await cognee.search(
        query="What are the key insights?",
        search_type="GRAPH_COMPLETION"
    )
    
    # 4. 输出结果
    for result in results:
        print(result)

asyncio.run(main())

学习曲线:5 分钟 (快速开始) - 2 小时 (完整配置)


🎯 竞争优势对比

竞品对比

对比项CogneeLangChain MemoryMem0Zep
知识图谱✅ 内置❌ 需集成⚠️ 有限⚠️ 有限
Vector 搜索✅ 多后端✅ 多后端✅ 内置✅ 内置
Graph 检索✅ 原生❌ 无❌ 无⚠️ 有限
本地运行✅ 完全✅ 完全⚠️ 云端⚠️ 混合
MCP 集成✅ 原生❌ 无❌ 无❌ 无
多租户✅ 内置❌ 无✅ 有✅ 有
持久化✅ 多后端⚠️ 简单✅ 云端✅ 有
开源✅ Apache 2.0✅ MIT⚠️ 部分⚠️ 部分

核心差异化

vs. LangChain Memory

  • ✅ 原生知识图谱支持
  • ✅ 双模检索 (Vector + Graph)
  • ✅ 更强的上下文推理能力
  • ❌ 学习曲线更陡

vs. Mem0

  • ✅ 完全本地化运行
  • ✅ 知识图谱可视化
  • ✅ 更多存储后端
  • ❌ 云端功能较少

vs. Zep

  • ✅ 知识图谱原生支持
  • ✅ MCP Server 集成
  • ✅ 研究论文支撑
  • ❌ 企业功能较少

🎯 适用场景

✅ 推荐场景

  • AI Agent 开发 - 构建持久化记忆的 Agent
  • RAG 应用 - 增强检索质量 (Vector + Graph)
  • 知识管理 - 企业知识库构建
  • 聊天机器人 - 多轮对话上下文保持
  • 推荐系统 - 基于知识图谱的推荐
  • 研究项目 - 知识图谱 + LLM 研究

❌ 不适合场景

  • 简单缓存 - 过于重量级
  • 实时流处理 - 不是流处理工具
  • 纯 Vector 搜索 - 可用更简单工具
  • 无 LLM 场景 - 依赖 LLM 提取实体

✅ 优势

  1. 双模检索 - Vector + Graph,检索质量更高
  2. 6 行代码 - 极简 API,快速上手
  3. 知识图谱 - 原生支持,多跳推理
  4. 多后端 - Vector/Graph/关系数据库灵活选择
  5. 本地运行 - 完全本地化,数据隐私
  6. MCP 集成 - 原生支持 Claude 等 Agent 框架
  7. 多租户 - 内置用户/租户隔离
  8. 可追溯 - OTEL 收集器 + 审计追踪
  9. 研究支撑 - 发表 arXiv 论文
  10. 活跃社区 - 14.5k stars,持续更新

❌ 不足

  1. 依赖 LLM - 实体提取需要 LLM API
  2. 存储复杂 - 需要配置多个数据库后端
  3. 学习曲线 - 知识图谱概念需要理解
  4. 资源消耗 - 图谱构建需要计算资源
  5. 文档更新 - 部分 API 变化较快

🌐 社区活跃度

指标数据
Stars14,500+
Forks1,400+
Contributors60+
Commits6,122+
Open Issues48
Pull Requests48
最后更新2026-03-14 (持续更新)
LicenseApache 2.0

社区生态

  • Discord 社区
  • Reddit r/AIMemory
  • GitHub Discussions
  • Colab 示例
  • 研究论文 (arXiv)
  • 社区插件仓库

📊 综合评分

维度评分说明
技术创新性9.0/10Vector + Graph 双模检索创新
易用性8.5/106 行代码快速开始,完整配置需时间
性能表现8.5/10多后端优化,但图谱构建需资源
功能完整性9.0/10完整的知识引擎功能
代码质量8.5/106k+ commits,持续重构优化
文档完善度8.5/10详细文档,但 API 变化快
社区活跃度9.0/1014.5k stars,活跃开发
可扩展性9.0/10多后端、多 LLM、模块化设计
商业价值9.0/10AI Agent 记忆刚需

总体评分:8.8/10 ⭐⭐⭐⭐⭐


📌 推荐建议

Cognee 是目前最完善的开源 AI Agent 记忆解决方案,适合需要构建持久化知识的应用场景。

核心价值:

  • 6 行代码快速开始
  • Vector + Graph 双模检索
  • 完全本地化运行

适用人群: AI Agent 开发者、RAG 应用开发者、知识管理工程师

使用建议:

  1. 从 CLI 快速体验核心功能
  2. 理解知识图谱基本概念
  3. 根据场景选择合适存储后端
  4. 生产环境使用 Neo4j + Qdrant

注意事项: 需要 LLM API 用于实体提取,图谱构建需要计算资源


评测时间: 2026-03-23
评测版本: v0.5.5
项目链接: https://github.com/topoteretes/cognee

基于 VitePress 构建, 部署于 Cloudflare Pages