z2839181153/ai-library-obsidian

O que ai-library-obsidian faz?

IA Library: base de conhecimento pessoal com IA + Obsidian. Backend Python + Habilidades de Agente + MCP. Recuperação híbrida FastAPI + SQLite FTS5 + LanceDB, modelos gratuitos do ModelScope.

Visão Geral

Esta habilidade permite que agentes de IA (como Claude Code, Cursor, Codex) interajam com sua base de conhecimento do Obsidian através de um backend Python. Ela oferece:

• Pesquisa híbrida: combina busca textual (SQLite FTS5) com busca semântica (LanceDB) para resultados precisos.
• Suporte a múltiplos agentes: funciona com MCP (Model Context Protocol) e como Agent Skill personalizada.
• Modelos gratuitos: usa modelos de embedding e LLM do ModelScope, sem necessidade de APIs pagas.
• API REST: construída com FastAPI, fácil de integrar e estender.

Como funciona

1. O backend indexa suas notas do Obsidian (armazenadas em markdown).
2. Cada nota é dividida em chunks, que são armazenados tanto no SQLite (para busca textual) quanto no LanceDB (para embeddings).
3. Quando um agente faz uma pergunta, o sistema realiza uma busca híbrida, combinando resultados de ambas as fontes.
4. Os resultados são retornados como contexto para o agente, que pode então responder à pergunta do usuário ou executar ações.

Pré-requisitos

• Python 3.10+
• Obsidian vault (diretório com arquivos .md)
• ModelScope SDK (grátis, sem chave necessária)

Instalação

git clone https://github.com/z2839181153/ai-library-obsidian
cd ai-library-obsidian
pip install -r requirements.txt

Configuração

Crie um arquivo .env:

OBSIDIAN_VAULT_PATH=/caminho/para/seu/vault
SQLITE_DB_PATH=data/library.db
LANCE_DB_PATH=data/lancedb

Uso

Iniciar o servidor

python main.py

Endpoints

• POST /search - Pesquisa híbrida
• POST /add - Adiciona nova nota ao índice
• GET /health - Verifica status

Exemplo de requisição

curl -X POST http://localhost:8000/search \
  -H "Content-Type: application/json" \
  -d '{"query": "O que é RAG?", "top_k": 5}'

Integração com MCP

Para usar com agentes que suportam MCP, configure o endpoint como ferramenta MCP.

Como Agent Skill

Coloque os arquivos de habilidade no diretório de skills do seu agente (ex.: Cursor, Claude Code).

Licença

MIT