
obsidian-wiki
让 AI 智能体用 Obsidian 记笔记,拥有长期记忆大脑
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-01 · 当前星标 ★ 3727
使用教程
⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。
环境要求
- Python 环境(项目为 Python 实现,并发布在 PyPI 上)
- 本地已安装 Obsidian,并有一个 Markdown 笔记库文件夹
- 一个支持 agent-skills 机制的 AI 智能体/客户端
- 能访问 PyPI 或 GitHub 的网络环境
安装与启动步骤
-
1确认环境
先确认本机已装 Python 和 Obsidian;README 强调把 Obsidian 笔记库当作智能体的记忆库,因此本地需要一个可读写的 Markdown 目录。
python --version -
2安装 Python 包
项目已发布到 PyPI(包名 obsidian-wiki),可用 pip 安装为依赖库。README 节选未给出完整安装步骤,此命令由 PyPI 徽章推断。
pip install obsidian-wiki -
3准备笔记库目录
新建或选定一个本地文件夹作为 wiki 记忆库,后续把智能体指向这个文件夹,让它自动写入和整理笔记。
-
4配置智能体记忆
按 README 描述,把智能体指向该文件夹,并告诉它需要记住的内容,让笔记之间自动建立双链与知识图谱。
-
5写入与检索
日常使用中让智能体把结论写入 wiki,需要时按主题检索调用,实现跨会话的知识复用。
如何确认成功
在 Obsidian 中打开该笔记库文件夹,若能看到智能体新写入的 Markdown 笔记并与既有笔记形成双链,即说明已生效。
常见问题
Q:README 里没有完整的安装命令怎么办?
A:节选内容只给出了 PyPI 包页和项目定位,未列出逐步安装指令。建议直接打开 GitHub 仓库 README 或 PyPI 页面,按官方最新说明执行。
Q:必须使用 Obsidian 吗?
A:项目核心思路就是把 Obsidian 笔记库当作智能体的数字大脑,依赖其 Markdown 本地化、双链和图谱能力,因此建议在 Obsidian 环境下使用。
Q:安装包名叫什么?
A:PyPI 徽章指向的项目名为 obsidian-wiki,因此安装命令为 pip install obsidian-wiki。若报错请核对官方页面的最新包名。
Q:数据会上传到云端吗?
A:README 强调编译结果是「你拥有的」互联 Markdown 笔记,说明知识沉淀在本地笔记库中;但智能体调用大模型时仍可能产生外部请求,需自行评估。
注意事项
- 本教程依据的 README 节选信息有限,安装与运行细节以官方 README 和 PyPI 页面为准。
- README 未给出端口、配置文件、CLI 子命令等具体参数,请勿自行臆测。
- 项目尚在快速迭代,包名、命令和依赖可能随版本变化。
核心亮点
- 把 Obsidian 双链笔记直接变成智能体可读写的记忆层,复用现有笔记生态
- 通过 agent-skills 让智能体自动整理、链接和沉淀知识,减少人工维护
- 基于 Python 和 LLM 工具链,便于接入现有智能体框架和自定义工作流
不足之处
- 强依赖 Obsidian 和本地文件结构,非 Obsidian 用户迁移成本高
- 项目处于成长阶段,长期记忆的检索质量与稳定性仍需更多验证
适用场景
- 给个人 AI 助手搭建跨会话长期记忆,自动记录和回顾对话要点
- 把已有 Obsidian 笔记库接入智能体,实现知识自动整理与图谱补全
- 构建垂直领域知识库,让智能体持续沉淀资料并按主题检索调用
替代项目
mem0、Letta、LangMem
上一篇:awesome-grokbot
同类项目推荐
llm-wiki-v2
开源
文档一键变可读 Markdown 知识库,回答带引用
Turn your documents into a Markdown wiki you can read, that answers with citations. ···
learn-retrieval-augmented-genera···
开源
跟着示例跑通检索增强生成全流程
Examples and demos on how to use Retrieval Augmented Generation with Large Language ···
open-deep-research
开源
给个主题,开源模型自动查资料写报告
The Open Deep Research app – generate reports with OSS LLMs
RAG_Hack
开源
跟着微软示例,快速搭出你的 RAG 应用
Hack Together: RAG Hack | Register, Learn, Hack
ai-research-assistant
开源
用大白话提问,自动查资料写报告,省下几小时文献苦工。
Aria is Your AI Research Assistant Powered by GPT Large Language Models
obsidian-wiki
开源
让 AI 智能体用 Obsidian 记笔记,拥有长期记忆大脑
Framework for AI agents to build and maintain a digital brain through Obsidian wiki ···
akcio
开源
用向量数据库给大模型装上知识库,回答更靠谱
Akcio is a demonstration project for Retrieval Augmented Generation (RAG). It levera···
mini-rag
开源
手把手分步教学,带你从零搭出生产级 RAG 应用
An Educational Project (step by step) to teach how to build a production-ready app f···
llm-search
开源
用自然语言问本地文档,秒级精准找答案
Querying local documents, powered by LLM