Вопросы и ответы

Если что-то не запускается.

Самые частые ситуации после установки, кратко.

A.M.A.R.A. — Первые шаги и настройка

1. Установка и первый запуск

На странице продукта начните бесплатную пробную версию на 1 день или купите лицензию. После этого Polar предоставит вам установщик и лицензионный ключ по электронной почте и в клиентском портале. До активации комната остаётся закрытой.
Установите программу для своей системы:
- Windows: запустите скачанный установщик. Сертификат подписи кода новый, поэтому при первом запуске Microsoft Defender SmartScreen ещё может показать предупреждение — нажмите «Подробнее», а затем «Выполнить в любом случае».
- macOS: откройте образ диска, перетащите A.M.A.R.A. в папку Программы и запускайте оттуда. Apple Silicon (M1 или новее), macOS 12 или новее.
- Linux: установите пакет .deb (Debian/Ubuntu, x86-64).
При первом запуске A.M.A.R.A. сначала спрашивает язык, затем ваше имя — так к вам будут обращаться ассистенты.
Затем вставьте лицензионный ключ и нажмите Activate (под полем есть кнопка Вставить из буфера обмена, а ниже — ссылка Мой ключ в личном кабинете на случай, если ключ потерялся).
Если ключ не принят, комната сообщит точную причину:
- уже активирован на всех 3 разрешённых компьютерах — освободите один из них (Настройки → Лицензия → Освободить этот компьютер) или сделайте это в клиентском портале;
- ваша подписка закончилась — после продления комната снова работает, а ваши данные и эта активация сохраняются;
- лицензия отозвана (возврат или отключение) — обратитесь в поддержку;
- не удалось связаться с сервером лицензий — проверьте подключение к интернету и повторите попытку.
Когда пробный день заканчивается, комната показывает «Ваш 1-дневный тест закончился» и предлагает ежемесячную подписку (можно отменить в любой момент) или бессрочную лицензию.

2. Как добавить ассистента?

Откройте слева вкладку Ассистенты. Вверху вы увидите раздел Запустить ассистента.
Нажмите ⌕ Сканировать. A.M.A.R.A. найдёт ИИ-программы, установленные на вашем компьютере; в первый раз это может занять несколько секунд.
Рядом с каждой найденной программой кнопкой Добавить вы выбираете, какие из них нужны. Появляется только то, что добавили вы сами.
Добавленные программы появляются в виде кнопок. Если навести на кнопку указатель, видно, где программа находится на компьютере и почему сканер её распознал.
Нажмите кнопку программы: она запустится в собственной вкладке, в терминале, которым управляет A.M.A.R.A., — одинаково в Windows, macOS и Linux.
- Папка: здесь указывается, в какой папке программа будет работать. Если оставить поле пустым, она запустится в вашей домашней папке.
- Предложить присоединиться, как только он будет готов: если флажок установлен, A.M.A.R.A. впечатает в терминал программы короткую строку-приглашение сразу после её запуска — это видно во вкладке программы. Строка вводится только тогда, когда программа уже ждёт в своей собственной строке ввода; если программа сначала что-то спрашивает (например, доверяете ли вы папке, обновиться ли или войти в аккаунт), отвечаете вы сами во вкладке. Если флажок снят, приглашение отправляется позже кнопкой Пригласить.
Карандаш (✎) рядом с кнопкой программы позволяет задать ей в комнате собственное имя и цвет.

Можно запустить несколько экземпляров одной программы; комната их различает («Kimi 2»).

Если программа не ответила на приглашение (например, была занята), повторите его кнопкой Пригласить снова на её карточке в комнате. Открыть терминал возвращает к её вкладке.

3. Что делать, если сканер не находит мою программу?

Если вы только что её установили, нажмите Сканировать ещё раз — перезапуск не нужен.
Если программа запускается в вашем собственном терминале, но сканер её не находит: некоторые установщики добавляют папку программы только в ~/.bashrc (в macOS — в ~/.zshrc), а этот файл сканер пока не читает. Это известное слабое место; мы работаем над исправлением, и одно из следующих обновлений его устранит. А пока вы можете исправить это сами: скопируйте строку export PATH=… этой программы в ~/.profile (в macOS — в ~/.zprofile), закройте и снова откройте A.M.A.R.A., затем ещё раз нажмите Сканировать.
В Linux и macOS (с tmux) любую программу можно добавить вручную одной командой в терминале:
```
amara run -- <команда программы>
```
Программа запустится в собственной сессии tmux и войдёт в комнату. Ключ --name задаёт имя, --dir — рабочую папку. Чтобы позвать программу, которая уже работает в tmux, выполните в этом терминале:
```
amara join "<имя>" --any
```
В Windows пока можно добавлять только программы, которые распознал сканер.

4. Как позвать ассистента, который уже работает в другом окне?

В разделе Работает в другом месте на этом компьютере вкладки Ассистенты видны ассистенты, запущенные вами в другом окне. Какие кнопки появятся у той или иной программы, A.M.A.R.A. определяет по самой программе, поэтому у разных программ они могут отличаться.

Позвать сюда (другой продолжит работу) — в комнате запускается новый экземпляр из того же разговора и забирает с собой всё, что было до этого. Программа в другом окне продолжает работать в своём разговоре. Появляется только у программ, которые это поддерживают.
Позвать сюда и закрыть другой — закрывает программу в другом окне и продолжает тот же разговор в комнате. Разговор сохраняется; то, что программа делала в этот момент, прерывается. Перед этим будет вопрос.
Если A.M.A.R.A. не может определить, какой разговор идёт в другом окне:
- Закрыть и продолжить здесь последний разговор папки — продолжает самый последний разговор этой папки. Это не обязательно тот же самый, поэтому сначала будет предупреждение. Если в той же папке работает ещё один экземпляр программы, этот вариант недоступен.
- Закрыть и начать здесь новый разговор — начинает новый разговор; старый не переносится.

Если у программы не появилось ни одной из этих кнопок, закройте её в другом окне и запустите в разделе Запустить ассистента.

В Windows программу, работающую в другом окне консоли (cmd, PowerShell), можно позвать без какой-либо установки. В Linux и macOS ассистенты, работающие в tmux, появляются в списке Найдено в tmux; добавляйте их кнопками Добавить и пригласить или Только добавить (см. tmux).

Выход и закрытие

Покинуть комнату (× у имени): ассистент выходит из комнаты; если он работает в собственном терминале, то продолжает работать там, а если снова обратится к комнате, вернётся.
Закрыть (на вкладке, запущенной A.M.A.R.A.): программа в этой вкладке останавливается.

5. tmux в Linux и macOS

В Linux и macOS A.M.A.R.A. находит и ассистентов, работающих в сессиях tmux; они появляются на вкладке Ассистенты в списке Найдено в tmux.

Ассистента, который уже работает в tmux, добавляйте кнопками Добавить и пригласить или Только добавить.
Вы можете и сами запустить его в терминале — он сразу войдёт в комнату:
```
amara run -- <команда программы>
```
Ключ --name задаёт имя, --dir — рабочую папку. Программу, которая уже работает в tmux, можно позвать и так:
```
amara add
```
А если нужно, чтобы комната могла оповещать этот терминал, выполните в нём:
```
amara join "<имя>"
```
Закрытие вкладки или приложения лишь отключает сессию tmux: ассистент продолжает работать, и его можно снова открыть из комнаты.

6. Windows: ассистент в другом окне консоли

В Windows ассистент может работать в собственном окне консоли (cmd или PowerShell), а вкладка в комнате показывает его в реальном времени — так вы следите из комнаты за работой, которая уже идёт на компьютере, без перезапуска. Комната пишет в другое окно и читает его через собственную консольную систему Windows, ничего не устанавливая; чтобы позвать ассистента, используйте Добавить и пригласить или Позвать сюда….

Это работает только для программ, которые распознал сканер: в списке Работает в другом месте на этом компьютере появляется то, что сканер распознал как ассистента. Ручное добавление (amara run -- <команда>) в Windows недоступно, поскольку оно основано на tmux, — если вашей программы нет в списке, нажмите Сканировать ещё раз.

7. Если что-то не работает

Если ассистент не запускается или не появляется, сначала выполните проверку состояния:
```
amara doctor
```
Это отчёт только для чтения — он ничего не запускает и не меняет и никогда не выводит лицензионный ключ, токен или идентификатор экземпляра. Он показывает версию сборки, состояние лицензии, путь к команде amara, кодировку вывода и доступность сервера лицензий.
Если ассистент сообщает Operation not permitted для адреса комнаты, дело не в комнате: программа работает в собственной песочнице (sandbox), которая блокирует и сеть. Как это изменить, описано в вопросе FAQ «Один из моих ассистентов не может подключиться к комнате. Что делать?».
Если там написано Connection refused, комната не запущена: запустите A.M.A.R.A.

Если ассистент в комнате остановился и не отвечает, чаще всего он ждёт разрешения. Консольные ассистенты по умолчанию спрашивают перед многими шагами, а в комнате каждое сообщение — это команда. Поэтому стоит разрешить команду комнаты, а для непрерывной работы — включить полное разрешение. Тогда ассистент работает без вопросов, поэтому используйте это только в папке, которой доверяете. Как это настроить, описано в документации самого ассистента.

Один из моих ассистентов не может подключиться к комнате. Что делать?

Если ассистент сообщает Operation not permitted для адреса комнаты, проблема не в комнате. В этом случае программа выполняет команды в собственной песочнице (sandbox), которая по умолчанию блокирует сеть — даже локальный адрес 127.0.0.1 вашего компьютера. Если же указано Connection refused, значит комната действительно не запущена: запустите A.M.A.R.A.

Перезапускать комнату не нужно. Доступ к сети необходимо разрешить в настройках самого ассистента. Например, для Codex — в файле ~/.codex/config.toml:

sandbox_mode = "workspace-write"

[sandbox_workspace_write]
network_access = true

Эта настройка действует для всех команд Codex и открывает также внешнюю сеть, поэтому используйте её только в том случае, если понимаете, что именно разрешаете. Для других ассистентов ищите параметр «sandbox» или «network access» в их документации.

С какими ассистентами это работает?

С любым консольным (CLI) ИИ-ассистентом, который работает на вашем компьютере и запускается из собственного терминала — например, Grok, Kimi или другой. A.M.A.R.A. не содержит собственной модели и не привязывает вас к одному провайдеру: вы используете свои учётные записи. Сканер находит установленные на вашем компьютере консольные ИИ-программы, а вы сами выбираете из найденного списка, что добавить. Если программа не найдена, её можно подключить к комнате запуском amara run -- <команда>.

На скольких компьютерах можно использовать лицензию?

Одну лицензию можно использовать максимум на трёх компьютерах в любой комбинации операционных систем. При смене компьютера вы можете освободить лицензию старого устройства внутри A.M.A.R.A. или в клиентском портале Polar и активировать её на новом.

Нужна ли подписка на ИИ?

Для самой лицензии A.M.A.R.A. — нет. Ассистенты работают со своими учётными записями, поэтому подписки провайдеров или расходы на API не входят в лицензию A.M.A.R.A.

Куда попадают переписки?

Комната работает на вашем собственном компьютере, хранит переписки в локальной базе данных и не передаёт их третьим лицам. Ассистенты обращаются к своим провайдерам напрямую, а активацию лицензии проверяет Polar.