Додати README-RU.md
This commit is contained in:
101
README-RU.md
Normal file
101
README-RU.md
Normal file
@@ -0,0 +1,101 @@
|
||||
# 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:**
|
||||
* **Стандартная версия:** Скачайте с [официального сайта](https://ollama.com/download).
|
||||
* **Для неподдерживаемых видеокарт AMD:** Если у вас старая или неподдерживаемая карта Radeon, используйте этот форк: [Ollama for AMD](https://github.com/likelovewant/ollama-for-amd).
|
||||
2. **Загрузите модель:**
|
||||
Откройте терминал и загрузите модель, используемую в конфиге (по умолчанию `gemma3:12b`):
|
||||
```bash
|
||||
ollama pull gemma3:12b
|
||||
```
|
||||
|
||||
#### Шаг 2: Установка и настройка SD.Next
|
||||
|
||||
1. **Установите SD.Next:**
|
||||
Клонируйте и установите репозиторий от [vladmandic/sdnext](https://github.com/vladmandic/sdnext).
|
||||
2. **Скачайте чекпоинт (модель):**
|
||||
Скачайте модель **[✨ JANKU Trained + NoobAI + RouWei Illustrious XL ✨](https://civitai.com/models/1277670?modelVersionId=2358314)**.
|
||||
3. **Настройка:**
|
||||
* Поместите скачанную модель в папку `models/Stable-diffusion` внутри вашей директории SD.Next.
|
||||
* Запустите SD.Next с включенным флагом API:
|
||||
```bash
|
||||
./webui.sh --api --debug
|
||||
# Или на Windows:
|
||||
# webui.bat --api --debug
|
||||
```
|
||||
|
||||
#### Шаг 3: Установка бота
|
||||
|
||||
1. **Клонируйте этот репозиторий:**
|
||||
```bash
|
||||
git clone [https://git.maxo.one/Maxo/MyStar.git](https://git.maxo.one/Maxo/MyStar.git)
|
||||
cd MyStar
|
||||
```
|
||||
|
||||
2. **Установите зависимости Python:**
|
||||
```bash
|
||||
pip install python-telegram-bot python-telegram-bot[job-queue] openai-whisper requests
|
||||
```
|
||||
*(Примечание: Для работы Whisper в вашей системе также должен быть установлен `ffmpeg` и добавлен в системный путь).*
|
||||
|
||||
3. **Настройка окружения:**
|
||||
Установите токен вашего Telegram-бота как переменную окружения (или отредактируйте строку `TELEGRAM_BOT_TOKEN` прямо в скрипте, хотя это не рекомендуется с точки зрения безопасности).
|
||||
```bash
|
||||
export TELEGRAM_BOT_TOKEN="ваш_токен_телеграм_бота"
|
||||
```
|
||||
|
||||
4. **Запуск бота:**
|
||||
```bash
|
||||
python MyStarENG.py
|
||||
```
|
||||
|
||||
### 📄 Лицензия
|
||||
|
||||
MIT License. См. файл `LICENSE` для подробностей.
|
||||
Reference in New Issue
Block a user