obsidian-wiki

让 AI 智能体用 Obsidian 记笔记,拥有长期记忆大脑

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 搜索知识 🍴 复刻 374 🐛 待处理 10 👀 关注 16
GitHub ↗
GitHub 星标 ★ 3727
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费,无在线服务,需自行部署

项目预览

obsidian-wiki 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类搜索知识
开发团队Ar9av
定价模式🏷️完全免费
价格说明开源免费,无在线服务,需自行部署
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Python
技术栈/模型agent-memory,agent-skills,brain,claude-code,claude-skills,codex,karpathy,knowledge-base,knowledge-graph,llm-tools,llm-wiki,mcp,memory,obsidian,obsidian-brain,pkm,second-brain,wiki
GitHub 星标★ 3727
上线时间2026-04-06 00:00:00
代码更新2026-11-14
仓库体积12.5 MB
本站数据更新2026-11-15
维护状态活跃
收录时间2026-10-01
浏览次数2

项目介绍

obsidian-wiki 是一个面向 AI 智能体的记忆系统框架,核心思路是把 Obsidian 笔记库当作智能体的“数字大脑”。它解决的是当前大模型智能体缺乏长期、结构化、可检索记忆的问题:对话结束后上下文丢失,知识无法沉淀,跨会话无法复用。项目通过 agent-skills 机制让智能体自动向 Obsidian wiki 写入、整理和链接笔记,形成知识图谱,并在需要时按主题检索调用。技术上基于 Python,结合 LLM 工具链,把普通 Markdown 笔记变成可被智能体读写的记忆层,既保留 Obsidian 的本地化、双链和图谱优势,又让 AI 能主动维护知识库。适合想给个人智能体搭建持久记忆、或把已有 Obsidian 笔记接入 AI 工作流的开发者。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-10-01 · 当前星标 ★ 3727

使用教程

难度:入门 约 10 分钟 部署方式:库/依赖 5 步

⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。

环境要求

  • Python 环境(项目为 Python 实现,并发布在 PyPI 上)
  • 本地已安装 Obsidian,并有一个 Markdown 笔记库文件夹
  • 一个支持 agent-skills 机制的 AI 智能体/客户端
  • 能访问 PyPI 或 GitHub 的网络环境

安装与启动步骤

  1. 1确认环境

    先确认本机已装 Python 和 Obsidian;README 强调把 Obsidian 笔记库当作智能体的记忆库,因此本地需要一个可读写的 Markdown 目录。

    python --version
  2. 2安装 Python 包

    项目已发布到 PyPI(包名 obsidian-wiki),可用 pip 安装为依赖库。README 节选未给出完整安装步骤,此命令由 PyPI 徽章推断。

    pip install obsidian-wiki
  3. 3准备笔记库目录

    新建或选定一个本地文件夹作为 wiki 记忆库,后续把智能体指向这个文件夹,让它自动写入和整理笔记。

  4. 4配置智能体记忆

    按 README 描述,把智能体指向该文件夹,并告诉它需要记住的内容,让笔记之间自动建立双链与知识图谱。

  5. 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

下一篇:stremio-ai-search

同类项目推荐

llm-wiki-v2 开源

文档一键变可读 Markdown 知识库,回答带引用

Turn your documents into a Markdown wiki you can read, that answers with citations. ···

★ 276 2026-10-15
open-deep-research 开源

给个主题,开源模型自动查资料写报告

The Open Deep Research app – generate reports with OSS LLMs

★ 439 2026-11-07
RAG_Hack 开源

跟着微软示例,快速搭出你的 RAG 应用

Hack Together: RAG Hack | Register, Learn, Hack

★ 523 2026-08-09
ai-research-assistant 开源

用大白话提问,自动查资料写报告,省下几小时文献苦工。

Aria is Your AI Research Assistant Powered by GPT Large Language Models

★ 1730 2026-08-09
obsidian-wiki 开源

让 AI 智能体用 Obsidian 记笔记,拥有长期记忆大脑

Framework for AI agents to build and maintain a digital brain through Obsidian wiki ···

★ 3727 2026-10-01
akcio 开源

用向量数据库给大模型装上知识库,回答更靠谱

Akcio is a demonstration project for Retrieval Augmented Generation (RAG). It levera···

★ 257 2026-08-09
mini-rag 开源

手把手分步教学,带你从零搭出生产级 RAG 应用

An Educational Project (step by step) to teach how to build a production-ready app f···

★ 761 2026-08-09
llm-search 开源

用自然语言问本地文档,秒级精准找答案

Querying local documents, powered by LLM

★ 663 2026-08-09