Asuna Project (Open-LLM-VTuber Enhanced)

Це модифікована версія Open-LLM-VTuber, створена спеціально для проекту "Асуна". Вона включає інтеграцію з Twitch, TikTok (через TikFinity), дзеркалювання чату та систему пам'яті.

Особливості "Асуни"

1. Єдиний Інтелект: Працює на GPT-4o (рекомендовано) з детальним системним промптом (українська мова, характер "tsundere").
2. Мульти-Чат:
   • Читає Twitch та TikTok одночасно.
   • Дзеркало: Повідомлення з TikTok дублюються в чат Twitch від імені бота.
3. Пам'ять: Запам'ятовує глядачів, їх рівень довіри та останні теми розмов (src/open_llm_vtuber/memory.py).
4. Голос: Використовує якісний український голос (EdgeTTS uk-UA-PolinaNeural).

Встановлення

1. Встановіть залежності:

   cd open-llm-vtuber
   pip install -r requirements.txt

2. Конфігурація (conf.yaml):

   • OpenAI: Вставте свій ключ в llm_api_key.
   • Twitch: Заповніть channel_name, bot_username, oauth_token (отримати на twitchapps.com/tmi/).
   • TikFinity: Переконайтеся, що TikFinity Desktop App запущено і WebSocket увімкнено (стандартний порт 21213).

Запуск

Потрібно запустити два скрипти в різних вікнах терміналу:

1. Основний Сервер (Мозок):

   python run_server.py

   Відкрийте http://localhost:12393 у браузері (або додайте як Browser Source в OBS).

2. Лайв Хаб (Вуха і Зв'язок):

   python run_live_hub.py

   Цей скрипт підключиться до Twitch та TikFinity і почне керувати чатами.

Примітки для Творця

• Мікрофон: Щоб Асуна впізнала вас, налаштуйте свій мікрофон у веб-інтерфейсі. (Поточна версія Whisper розпізнає голос, але для повної ідентифікації "Творець" краще використовувати окремий канал або кодову фразу, наразі система налаштована вірити конфігу).
• Грубіяни: Асуна має інструкцію жорстко, але красиво відповідати на хамство.
• Пам'ять: Дані глядачів зберігаються у файлі viewers.json. Ви можете редагувати його вручну, щоб змінити рівень довіри (trust_level).