obsidian-assist 0.2.0

Modular AI assistant with Obsidian memory integration and local Whisper transcription.

Obsidian AI Assistant

Модульный AI-помощник для работы с Obsidian-заметками: локальная транскрибация голоса, векторный поиск, Telegram-бот и CLI.

✨ Возможности

• 🎙️ Локальная транскрибация голосовых сообщений через faster-whisper (без OpenAI API)
• 💬 Telegram бот с историей диалогов и контекстом
• 🔍 Векторный поиск по заметкам с фильтрами по блокам и темам
• 📝 Автоматическое сохранение заметок в Obsidian vault
• 🔐 Шифрование локального индекса
• 🐳 Docker поддержка для простого деплоя

📦 Установка

pip install obsidian-assist

Или из исходников:

git clone https://github.com/yourusername/obsidian-ai-assistant.git
cd obsidian-ai-assistant
pip install -e ".[local]"

🚀 Быстрый старт

1. Скопируйте конфигурацию:

cp .env.example .env

2. Отредактируйте .env — укажите VAULT_PATH и TELEGRAM_TOKEN.

3. Инициализируйте vault:

obsidian-assist init --vault-path "./my_vault"

4. Синхронизируйте и ищите:

obsidian-assist sync
obsidian-assist search "Python"

5. Запустите Telegram бота:

obsidian-assist telegram

🤖 Telegram бот

Отправляйте текст или голосовые сообщения:

• Текст → автоматически сохраняется в vault с метаданными
• Голос → расшифровывается и сохраняется
• Команды:
  • /start, /help — справка
  • /status — статус системы
  • /search <запрос> — поиск по заметкам
  • /chat <вопрос> — диалог с контекстом
  • /clear — очистить историю диалога
  • /new — создать новую заметку

Метаданные в тексте:

Block: Работа
Theme: Идеи
Title: План на неделю

🐳 Docker

# Сборка и запуск
docker-compose up --build

# Только бот
docker-compose up telegram-bot

🏗️ Архитектура

Модуль	Назначение
obsidian.py	Работа с vault и markdown-файлами
memory.py	Векторный индекс и поиск
models.py	Адаптеры LLM и эмбеддингов
transcriber.py	Локальная транскрибация audio
telegram_bot.py	Telegram-бот
cli.py	Командный интерфейс
crypto.py	Шифрование данных
assistant.py	Ядро ассистента

🧪 Разработка

# Установка dev-зависимостей
pip install -e ".[dev]"

# Pre-commit hooks
pre-commit install

# Тесты
pytest obsidian_assistant/tests/ -v

# Линтеры
ruff check .
mypy obsidian_assistant/

📄 Документация

• CONTRIBUTING.md — как внести вклад
• CHANGELOG.md — история изменений
• docs/ — расширенная документация

📜 Лицензия

MIT License — см. LICENSE