AI导哈

智能助手服务

基于Telegram的智能助手，具备记忆功能、向量数据库和多种工具集成，适用于日常任务管理和信息查询。

  • by Z4R43
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 HiroHamato/ai-daily-assistant

使用说明

Daily Assistant (Python + LLM)

Интеллектуальный ассистент с Telegram-интерфейсом, памятью (SQLite), векторной БЗ (FAISS), MCP-инструментами (Weather, Notion, Web Search) и ядром LLM через SambaNova Cloud API.

Быстрый старт (локально)

  1. Создайте и активируйте venv
  2. Скопируйте env.example в .env и заполните переменные
  3. Установите зависимости:
pip install -r requirements.txt
  1. Запустите бота:
python main.py

Деплой (systemd)

  1. Скопируйте проект на сервер (Ubuntu/Debian), например /opt/daily-assistant
  2. Скопируйте env.example в .env и заполните значения (TOKENы и т.п.)
  3. Настройте сервис:
sudo cp agent.service /etc/systemd/system/agent.service
sudo systemctl daemon-reload
sudo systemctl enable --now agent
  1. Проверка:
sudo systemctl status agent
journalctl -u agent -f

Docker (опционально)

docker compose up --build -d

Используемые MCP-инструменты

  • Weather (Open‑Meteo): геокодинг и текущая/дневная погода. Маркер: [[WEATHER:Город]].
  • Notion: поиск заметок и создание страниц в базе. Маркеры: [[NOTION_SEARCH:запрос]], [[NOTION_ADD:Заголовок|Текст]].
  • Web Search (DuckDuckGo News): новости за 24 часа, приоритет крипто‑домены. Маркер: [[WEB_SEARCH:запрос]].
  • KB (FAISS): локальная база знаний — добавление и поиск фактов. Маркеры: [[KB_ADD:факт]], [[KB_SEARCH:запрос]].

Краткий отчёт

  • Назначение: ежедневный ассистент в Telegram с памятью, RAG и инструментами.
  • Подключённые MCP: Weather, Notion, Web Search, локальная KB (FAISS).
  • Память: SQLite (memory/dialogue.db), хранит историю для контекста.
  • База знаний: FAISS + SentenceTransformers, асинхронная инициализация, RAG‑вставки.
  • LLM: SambaNova Cloud /chat/completions, модель задаётся в .env, встроенный троттлинг/429‑retry.
  • Оркестрация: система tool‑call маркеров, mini‑loop (1 инструмент → финальный ответ), статусы выполнения в чате.

Папки/файлы

  • telegram/ — Telegram-бот
  • llm/ — клиент SambaNova LLaMA
  • memory/ — SQLite-хранилище
  • vector_store/ — FAISS
  • mcp/ — инструменты Weather/Notion/Web Search
  • utils/ — промпты
  • agent.service — unit для systemd (в корне)
  • Dockerfile, docker-compose.yml — для контейнерного запуска
  • report.md — краткий отчёт

Переменные окружения

См. env.example.

相关 MCP