Cognee 项目评测报告
🏆 核心结论(先看这里!)
推荐指数:⭐⭐⭐⭐⭐ (5/5)
一句话总结
14.5k Stars 的开源知识引擎,6 行代码为 AI Agent 构建持久化记忆,支持 Vector + Graph 双检索模式。
核心价值
✅ 极简使用 - 6 行代码即可完成文档索引和检索
✅ 双模检索 - Vector 语义搜索 + Graph 关系查询
✅ 持久记忆 - AI Agent 跨会话知识保留
✅ 本地运行 - 完全本地化,数据隐私可控
📸 产品展示

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 │
│ │
└─────────────────────────────────────────────────────────────┘📌 基本信息
| 项目 | 信息 |
|---|---|
| GitHub | topoteretes/cognee |
| Stars | 14.5k |
| Forks | 1.4k |
| License | Apache 2.0 |
| 主要语言 | Python |
| Python 版本 | 3.10 - 3.13 |
| Commits | 6,122+ |
| Contributors | 60+ |
| 分类 | ai-tools |
🎯 核心特性
功能矩阵
| 模块 | 功能 | 说明 |
|---|---|---|
| 数据摄取 | 多格式支持 | 文档/PDF/JSON/数据库/多模态 |
| 知识图谱 | 自动构建 | LLM 实体提取 + 关系构建 |
| 双模检索 | Vector + Graph | 语义匹配 + 关系遍历 |
| 持久记忆 | 跨会话保留 | AI Agent 长期记忆 |
| 多租户 | 用户隔离 | 数据安全 + 权限控制 |
| 本地运行 | 完全本地化 | 隐私可控 |
| MCP Server | AI 工具集成 | 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 Neptune4. 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 DB | Qdrant/Weaviate/Pinecone/Milvus |
| Graph DB | Neo4j/NetworkX/Kuzu |
| 关系数据库 | PostgreSQL + SQLAlchemy |
| API | FastAPI |
| CLI | cognee-cli |
| MCP | cognee-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:11434CLI 使用
bash
# 添加数据
cognee-cli add "Your document content here"
# 构建知识图谱
cognee-cli cognify
# 搜索
cognee-cli search "Your query"
# 删除所有数据
cognee-cli delete --all
# 启动本地 UI
cognee-cli -uiPython 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 小时 (完整配置)
🎯 竞争优势对比
竞品对比
| 对比项 | Cognee | LangChain Memory | Mem0 | Zep |
|---|---|---|---|---|
| 知识图谱 | ✅ 内置 | ❌ 需集成 | ⚠️ 有限 | ⚠️ 有限 |
| 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 提取实体
✅ 优势
- 双模检索 - Vector + Graph,检索质量更高
- 6 行代码 - 极简 API,快速上手
- 知识图谱 - 原生支持,多跳推理
- 多后端 - Vector/Graph/关系数据库灵活选择
- 本地运行 - 完全本地化,数据隐私
- MCP 集成 - 原生支持 Claude 等 Agent 框架
- 多租户 - 内置用户/租户隔离
- 可追溯 - OTEL 收集器 + 审计追踪
- 研究支撑 - 发表 arXiv 论文
- 活跃社区 - 14.5k stars,持续更新
❌ 不足
- 依赖 LLM - 实体提取需要 LLM API
- 存储复杂 - 需要配置多个数据库后端
- 学习曲线 - 知识图谱概念需要理解
- 资源消耗 - 图谱构建需要计算资源
- 文档更新 - 部分 API 变化较快
🌐 社区活跃度
| 指标 | 数据 |
|---|---|
| Stars | 14,500+ |
| Forks | 1,400+ |
| Contributors | 60+ |
| Commits | 6,122+ |
| Open Issues | 48 |
| Pull Requests | 48 |
| 最后更新 | 2026-03-14 (持续更新) |
| License | Apache 2.0 |
社区生态
- Discord 社区
- Reddit r/AIMemory
- GitHub Discussions
- Colab 示例
- 研究论文 (arXiv)
- 社区插件仓库
📊 综合评分
| 维度 | 评分 | 说明 |
|---|---|---|
| 技术创新性 | 9.0/10 | Vector + Graph 双模检索创新 |
| 易用性 | 8.5/10 | 6 行代码快速开始,完整配置需时间 |
| 性能表现 | 8.5/10 | 多后端优化,但图谱构建需资源 |
| 功能完整性 | 9.0/10 | 完整的知识引擎功能 |
| 代码质量 | 8.5/10 | 6k+ commits,持续重构优化 |
| 文档完善度 | 8.5/10 | 详细文档,但 API 变化快 |
| 社区活跃度 | 9.0/10 | 14.5k stars,活跃开发 |
| 可扩展性 | 9.0/10 | 多后端、多 LLM、模块化设计 |
| 商业价值 | 9.0/10 | AI Agent 记忆刚需 |
总体评分:8.8/10 ⭐⭐⭐⭐⭐
📌 推荐建议
Cognee 是目前最完善的开源 AI Agent 记忆解决方案,适合需要构建持久化知识的应用场景。
核心价值:
- 6 行代码快速开始
- Vector + Graph 双模检索
- 完全本地化运行
适用人群: AI Agent 开发者、RAG 应用开发者、知识管理工程师
使用建议:
- 从 CLI 快速体验核心功能
- 理解知识图谱基本概念
- 根据场景选择合适存储后端
- 生产环境使用 Neo4j + Qdrant
注意事项: 需要 LLM API 用于实体提取,图谱构建需要计算资源
评测时间: 2026-03-23
评测版本: v0.5.5
项目链接: https://github.com/topoteretes/cognee