Files
MyStar/README-RU.md
2025-12-22 02:45:59 +01:00

7.6 KiB
Raw Blame History

MyStar: Автономный ИИ-компаньон (Self-Hosted)

MyStar — это продвинутый, полностью локальный ИИ-бот-компаньон для Telegram, созданный на базе Python, Ollama, SD.Next и Whisper.

В отличие от простых чат-ботов, MyStar обладает "живой" личностью с долговременной памятью, симуляцией биологических циклов, мультимодальным восприятием (зрение/слух) и автономным поведением.


🚀 Ключевые возможности

🧠 1. Динамическая личность и мышление

  • Модульный промптинг: SYSTEM_PROMPT собирается динамически "на лету". В зависимости от контекста, в базовый промпт внедряются различные модули личности.
  • Долговременная память (LTM): Бот использует систему "Дневника" (SQLite). Он не просто скармливает всю историю чата в LLM. Вместо этого он внедряет: [Базовая Персона] + [Саммари LTM] + [Недавний контекст].
  • Фоновое "мышление": Когда вы неактивны, фоновый процесс (run_memory_summarization) анализирует недавние диалоги, извлекает ключевые факты о вас (хобби, проблемы, планы) и сохраняет их в базу данных LTM.

💖 2. Отношения и биологические состояния

  • Развитие отношений: Бот поддерживает три стадии: Незнакомец, Друг и Возлюбленная.
  • Авто-прогрессия: Бот автоматически распознает романтические намерения и повышает статус отношений.
  • Симуляция 28-дневного цикла: Бот отслеживает симулированный цикл, который влияет на её настроение и директивы промпта:
    • Период (Дни 1-7): Она может быть капризной, требовать утешения и будет отказываться от NSFW-взаимодействий.
    • Овуляция (Дни 12-16): Она становится более кокетливой, уверенной в себе и ласковой.

👁️ 3. Мультимодальное восприятие ("Сенсоры")

  • Зрение (Распознавание изображений): Вы можете отправлять боту фотографии. Она "видит" их и комментирует естественным образом.
  • Слух (Голосовые сообщения): Интегрированный OpenAI Whisper позволяет боту слушать ваши голосовые заметки и отвечать на них текстом.
  • Понимание контекста: Она определяет ваш рабочий график и уважает ваше время (избегая отвлекающих факторов в рабочие часы).

💬 4. Продвинутое взаимодействие и визуал

  • Спонтанные сообщения от ИИ: Никаких жестко прописанных шаблонов. Если вы давно не писали, она сгенерирует уникальное, контекстно-зависимое сообщение, чтобы узнать, как у вас дела.
  • Высококачественная генерация изображений:
    • Работает на базе SD.Next и модели JANKU Trained + NoobAI + RouWei Illustrious XL для топовой аниме-эстетики.
    • SFW по умолчанию: Генерирует милые/уютные селфи на основе контекста разговора.
    • Контекстный NSFW: Генерация откровенного контента строго ограничена (требует статуса 'Lover', конкретного запроса пользователя и подходящего времени/состояния).

🛠️ Технический стек

  • Python 3.10+
  • Ollama: Локальный бэкенд для LLM.
  • SD.Next: Продвинутый WebUI для Stable Diffusion.
  • FFmpeg: Обработка аудио для Whisper.

📦 Инструкция по установке

Шаг 1: Установка и настройка Ollama

  1. Скачайте Ollama:
    • Стандартная версия: Скачайте с официального сайта.
    • Для неподдерживаемых видеокарт AMD: Если у вас старая или неподдерживаемая карта Radeon, используйте этот форк: Ollama for AMD.
  2. Загрузите модель: Откройте терминал и загрузите модель, используемую в конфиге (по умолчанию gemma3:12b):
    ollama pull gemma3:12b
    

Шаг 2: Установка и настройка SD.Next

  1. Установите SD.Next: Клонируйте и установите репозиторий от vladmandic/sdnext.
  2. Скачайте чекпоинт (модель): Скачайте модель JANKU Trained + NoobAI + RouWei Illustrious XL .
  3. Настройка:
    • Поместите скачанную модель в папку models/Stable-diffusion внутри вашей директории SD.Next.
    • Запустите SD.Next с включенным флагом API:
      ./webui.sh --api --debug
      # Или на Windows:
      webui.bat --api --debug
      

Шаг 3: Установка бота

  1. Клонируйте этот репозиторий:

    git clone [https://git.maxo.one/Maxo/MyStar.git](https://git.maxo.one/Maxo/MyStar.git)
    cd MyStar
    
  2. Установите зависимости Python:

    pip install python-telegram-bot python-telegram-bot[job-queue] openai-whisper requests
    

    (Примечание: Для работы Whisper в вашей системе также должен быть установлен ffmpeg и добавлен в системный путь).

  3. Настройка окружения: Установите токен вашего Telegram-бота как переменную окружения (или отредактируйте строку TELEGRAM_BOT_TOKEN прямо в скрипте, хотя это не рекомендуется с точки зрения безопасности).

    export TELEGRAM_BOT_TOKEN=аш_токен_телеграм_бота"
    
  4. Запуск бота:

    python MyStarRU.py
    

📄 Лицензия

MIT License. См. файл LICENSE для подробностей.