# Senpi (OmO Native)

Источник: https://docs.aicentos.com/ru/clients/senpi

Language: ru

> Подключение к aicentos в Senpi / OmO — каталоги конфигурации и расположение openai-compatible provider

Senpi — форк `pi-mono`, npm-пакет `@code-yeongyu/senpi`, исполняемый файл — `senpi`. Он же служит рантаймом oh-my-openagent (сокращённо OmO), поэтому «OmO Native» означает набор, работающий на harness senpi.

## Подготовка

```bash
curl -fsSL https://get.omo.dev/install.sh | bash
omo
```

Можно установить и через bun:

```bash
bun add -g omo-ai
```

Проект сам называет себя experimental; в официальной формулировке — не стоит ставить его в продакшн-пайплайн.

## Конфигурация для заполнения

Каталог конфигурации — `~/.omo/agent/`, его можно переопределить через `OMO_CODING_AGENT_DIR`; старые переменные `SENPI_*` по-прежнему поддерживаются.

| Файл            | Назначение                                             |
| --------------- | ------------------------------------------------------ |
| `models.json`   | описание provider (эндпоинт, протокол, список моделей) |
| `auth.json`     | ключи                                                  |
| `settings.json` | предпочтения, например модель по умолчанию             |

У самого senpi отдельный набор: `~/.senpi/agent/settings.json`, а также проектный `.senpi/settings.json`.

| Поле              | Значение                                  |
| ----------------- | ----------------------------------------- |
| Протокол provider | `@ai-sdk/openai-compatible`               |
| Base URL          | `https://aicentos.com/v1`                 |
| API Key           | ключ, созданный в консоли                 |
| Модель            | имя модели из «витрины моделей» в консоли |

## Шаги настройки

Добавьте провайдера в `~/.omo/agent/models.json`, выбрав OpenAI-совместимый протокол (в документации указано соответствие `npm: @ai-sdk/openai-compatible`):

```json
{
  "providers": {
    "aicentos": {
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "https://aicentos.com/v1",
        "apiKey": "sk-ваш-API-ключ"
      },
      "models": {
        "имя-модели": {}
      }
    }
  }
}
```

Ключ можно хранить отдельно в `auth.json`, не записывая его в `models.json`. Затем укажите модель по умолчанию в `settings.json`.

## Проверка

Запустите `omo` или `senpi`, в селекторе моделей убедитесь, что появились модели под `aicentos`, и отправьте одну фразу — ответ должен прийти.

## Примечания

* Не путайте два каталога конфигурации: у OmO — `~/.omo/agent/`, у senpi — `~/.senpi/agent/`; изменения не в том месте не подействуют.
* Проектный `.senpi/settings.json` перекрывает глобальные настройки, поэтому при разборе проблем сначала смотрите каталог проекта.
* В официальной документации есть только таблица соответствий при миграции, без полного готового фрагмента конфигурации; приведённая структура собрана по соглашениям семейства Pi, а имена полей сверяйте с текущей версией на `omo.dev/docs`.
* Проект experimental: после обновления структура конфигурации может измениться.

## Полезные ссылки

* [Документация OmO](https://omo.dev/docs)
* [Репозиторий senpi](https://github.com/code-yeongyu/senpi)
* [Репозиторий oh-my-openagent](https://github.com/code-yeongyu/oh-my-openagent)