Как добавить свою ИИ-модель в aish

Совместимые модели

С aish можно использовать модели, которые поддерживают OpenAI Chat Completions API и Tool Calling. Например, в ИИ-роутере можно увидеть наличие tool и chat сразу в списке моделей.

Добавляем модель через интерфейс

Шаг 1

Вызовите меню Commands сочетанием клавиш Alt+C или клавишей F9. В Terminal на MacOS используйте клавишу Option вместо Alt.

В меню Commands по умолчанию выбран пункт Select model — нажмите Enter.

Шаг 2

В окне Models с помощью клавиш ↑↓ или Tab переместите фокус на кнопку + Add в правом нижнем углу окна и нажмите Enter.

Шаг 3

Укажите провайдера в окне Select provider. В нашем примере мы рассмотрим, как подключить модель GLM-5.2 из ИИ-роутера Selectel.

Если вы добавляете модель впервые, список провайдеров будет пуст. В окне Select provider окажется выбран пункт New provider — нажмите Enter.

Если вы уже свои добавляли модели ранее и хотите добавить еще одну модель в заведенного ранее провайдера, выберите его с помощью клавиш ↑↓ или Tab и нажмите Enter.

Если хотите добавить еще одного провайдера, выберите пункт New provider и нажмите Enter.

Шаг 4

После выбора провайдера заполните форму Connect Models. Вы можете вставить данные из буфера обмена. Перемещайтесь по полям с помощью клавиш ↑↓ или Tab.

Если вы создаете нового провайдера, обязательно заполните все поля формы — ниже разберем, как это сделать. А если вы добавляете еще одну модель в рамках подключенного провайдера, впишите только ее идентификатор, нажмите Enter и Save. Поле ввода модели будет сразу в фокусе.

Как заполнять поля

• Provider name — имя провайдера. Записывается в свободном формате, как вам удобно. Рекомендуем выбирать краткие имена, в нашем примере это AI-router.
• Provider URL — сетевой адрес, который указывает на API провайдера. Значение имеет формат ссылки: https://ai.provider.example.ru. В ИИ-роутере панели управления эта ссылка находится внутри карточки роутера в разделе Обзор → Base URL.
• API key — приватный ключ доступа к сервису провайдера формата UUID с возможными префиксами в зависимости от провайдера. В ИИ-роутере API-ключ выводится один раз при создании роутера — скопируйте его сразу. Если не успели или забыли это сделать, добавьте новый ключ во вкладке Ключи и Лимиты.
• Models (ID) — идентификаторы модели формата qwen3.6-27b, glm-5.2 и т.п. Рекомендуем копировать точный идентификатор из панели провайдера.

В случае ИИ-роутера точное название модели можно посмотреть так:

1. Перейдите во вкладку Модели внутри своего роутера.
2. Выберите модель и раскройте карточку.
3. Скопируйте значение из поля Aлиасы.

Если вы решите удалить модель внутри провайдера, возьмите ее в фокус и нажмите клавишу Delete (или Option+Backspace на MacOS).

Когда закончите заполнять форму, сохраните изменения. Для этого переместите фокус на кнопку Save с помощью клавиш ↑↓ или Tab.

Обратите внимание: для сохранения изменений важно, чтобы все поля на форме были заполнены и указана хотя бы одна модель. При ошибке сохранения верните фокус в поле и заполните его. В случае с моделью — нажмите Enter, чтобы она добавилась в список под полем ввода.

Шаг 5

После сохранения вы вернетесь к списку моделей. Выберите модель в списке с помощью клавиш ↑↓ или Tab и нажмите Enter.

Должен появиться круглый маркер слева от модели:

В чате пока что мы не отображаем, какая именно модель отвечает, но в случае успешного подключения чат продолжит работать с предыдущим контекстом.

А если что-то пойдет не так — несовместима модель, провайдер или ошибки в конфиге, — в чате на любой запрос появится сообщение об ошибке:

Добавляем модель через конфигурационный файл

Вы можете добавить модель или провайдера и через конфигурационный файл описанным ниже способом.

Пример команды для редактора nano:

nano /root/.local/share/aish/llm_registry.json

Пример конфигурационного файла:

{
  "map": {
    "AI-provider": {
      "api_key": "exampleAPIkey1",
      "endpoint": "https://provider.example.ru",
      "models": [
        "qwen3-6-27b"
      ]
    }
    "AI-router": {
      "api_key": "exampleAPIkey2",
      "endpoint": "https://ai.provider.example.ru",
      "models": [
        "z-ai/glm-5.2"
      ]
    }
  },
  "selected": [
    "aish",
    "aish_model"
  ]

Заключение

Мы разобрали два способа добавления модели в aish: через интерфейс и конфигурационный файл. По такому же принципу вы можете добавить другие модели — из ИИ-роутера или локально развернутые. Важно, чтобы модели поддерживали OpenAI Chat Completions API и Tool Calling.

Попробуйте aish и поделитесь впечатлениями от работы в нашем коммьюнити.