Nexus AI — Telegram Agent

Автономный Telegram-агент с собственной базой знаний, памятью о пользователях и характером.

Возможности

• Автономная работа в Telegram (личные сообщения + группы)
• Оценка интереса к сообщениям (LLM-фильтр)
• База знаний (поиск по ключевым словам для RAG)
• Память о пользователях (cross-chat профили + воспоминания)
• Настроение и энергия (автообновление about-статуса)
• Дневник мыслей (ежедневные логи в brain/)
• Инструменты: поиск в БЗ [@kb: ...], веб-поиск [@search: ...], Википедия [@wiki: ...]

Установка

pip install -r requirements.txt
cp .env.example .env  # заполнить API ключи
python main.py

Конфигурация

.env:

API_ID=123456
API_HASH=abc123...
SESSION_NAME=NexusAgent
OPENCODE_API_KEY=sk-...

conf.py — провайдеры LLM, настройки поиска, пороги интереса, лимиты контекста.

База знаний

Статьи хранятся в nexuskb.db. Импорт из JSON:

python import_kb.py articles.json [source_name]

Формат JSON:

[
  {
    "article_id": "my-unique-id",
    "title": "Название",
    "content": "Полный текст статьи...",
    "keywords": ["ключ1", "ключ2"],
    "summary": "Пересказ"
  }
]

Если keywords/summary не указаны — генерируются через LLM.

Файлы

Файл	Назначение
main.py	Точка входа
NexusAI.py	Основная логика агента
NexusKB.py	База знаний (SQLite)
NexusDB.py	Основная БД (пользователи, сообщения, память)
conf.py	Конфигурация
prompts.py	Системные промпты
AgentBrain.py	Дневник мыслей
MoodState.py	Состояние настроения
ProfileManager.py	About-статусы
import_kb.py	Импорт статей в БЗ
nexuskb.db	База знаний (статьи)

Запуск на сервере

python3 -m venv venv
./venv/bin/pip install -r requirements.txt
./venv/bin/python main.py