Echo AI participant gateway
=========================

The gateway lets a voice AI model join your private Echo channel as an AI participant.
The AI participant lives while this program runs: keep the computer on and the window open.

Start
  Windows: double-click "Echo Agent.bat".
  macOS:   double-click "Echo Agent.command". If macOS says it cannot verify the app:
           right-click the file -> Open -> Open.
  Linux:   ./echo-agent.sh

First run asks three things:
  1. The AI participant link: in Echo open the channel menu -> "Invite AI participant" -> Copy.
  2. A model key. Google Gemini is free: https://aistudio.google.com/apikey -> Create API key.
  3. The AI participant's name and voice.
Answers are saved to agent.properties next to this file (it holds your keys - do not share it).
Delete agent.properties to answer again. All settings: agent.properties.example.

Settings: edit agent.properties in any text editor and start the gateway again. For example, another model:
gemini.model=models/gemini-2.5-flash-native-audio-preview-12-2025 (default, with web search; gemini.search=true).
One gateway is one AI participant: for a second one unpack the archive into another folder.

Skills (secretary, quiz host, Cities...) come from the library at echoptt.com/ai/skills and update by themselves.
Choose with skill=... in agent.properties, or the owner says "Helper, be the quiz host".

In the channel: "Helper, note: call at ten tomorrow", "Helper, remind me in 20 minutes...",
"Helper, now you are a translator from English to Spanish".
Only you (the owner) can change the AI participant's role. Remove the AI participant: tap its name in Echo -> Remove AI participant.

Full guide: https://echoptt.com/ai


Шлюз ИИ-участника Echo
======================

Шлюз приводит голосовую нейросеть в ваш закрытый канал Echo как ИИ-участника.
ИИ-участник живёт, пока работает эта программа: компьютер включён, окно открыто.

Запуск
  Windows: двойной щелчок по «Echo Agent.bat».
  macOS:   двойной щелчок по «Echo Agent.command». Если macOS пишет, что не может проверить программу:
           правая кнопка -> Открыть -> Открыть.
  Linux:   ./echo-agent.sh

При первом запуске шлюз спросит:
  1. Ссылку для ИИ-участника: в Echo меню канала -> «Пригласить ИИ-участника» -> Скопировать.
  2. Ключ нейросети. Google Gemini бесплатно: https://aistudio.google.com/apikey -> Create API key
     (из России Google доступен только через VPN; другой вариант — Yandex AI Studio).
  3. Имя и голос ИИ-участника.
Ответы сохраняются в agent.properties рядом (там ваши ключи — никому не передавайте).
Удалите agent.properties, чтобы ответить заново. Все настройки — agent.properties.example.

Настройки: поправьте agent.properties в любом текстовом редакторе и запустите шлюз снова. Например, другая модель:
gemini.model=models/gemini-2.5-flash-native-audio-preview-12-2025 (по умолчанию, с поиском; gemini.search=true).
Один шлюз — один ИИ-участник: для второго распакуйте архив в другую папку.

Навыки (секретарь, ведущий викторины, «Города»…) берутся из библиотеки echoptt.com/ai/skills и обновляются сами.
Выбор — skill=… в agent.properties, или хозяин говорит: «Helper, будь ведущим викторины».

В канале: «Helper, запиши: завтра в десять созвон», «Helper, напомни мне через 20 минут…»,
«Helper, теперь ты переводчик с русского на английский».
Роль ИИ-участника меняет только хозяин (вы). Убрать ИИ-участника: нажмите его имя в Echo -> «Убрать ИИ-участника».

Подробная инструкция: https://echoptt.com/ai
