ДокументацияКрасичка

Красичка

Красичка — наш собственный AI coding-агент на Rust с терминальным UI: стриминг инструментов, восстановление сессий, переключение моделей/провайдеров, делегирование задач субагентам и MCP. Подключается к AI Chaos как OpenAI-совместимый провайдер.

Шаг 1. Установка

Статус: публичная дистрибуция бинаря готовится. Пока Красичка собирается из исходников (доступ к репозиторию — через команду AI Chaos) или ставится скриптом из репозитория.

# Зависимости (Debian/Ubuntu)
sudo apt-get install -y libasound2-dev libssl-dev pkg-config

# Сборка
cargo build --release

Бинарь — ./target/release/krasichka-rs. Полная локальная установка вместе с web-приложением и локальными движками: ./scripts/install.sh.

В других дистрибутивах: Fedora/RHEL — alsa-lib-devel openssl-devel pkgconf, Arch — alsa-lib openssl pkgconf.

Шаг 2. Провайдер AI Chaos

Создайте ~/.krasichka/krasichka.jsonc (файл читается, но никогда не перезаписывается приложением) и добавьте провайдер:

{
  provider: {
    aichaos: {
      name: "AI Chaos",
      kind: "openai",
      options: {
        baseURL: "https://aichaos.ru/v1"
      }
    }
  },
  model: "aichaos/chat-model"
}

Замените chat-model на код модели изкаталога . Формат селектора модели — provider-id/model-id.

Шаг 3. API ключ

Ключ хранится в ~/.krasichka/auth.json:

{
  "aichaos": {
    "type": "api",
    "key": "chaos-u-..."
  }
}

Обратите внимание: поле называется key (не apiKey), тип — api. Можно перечислить несколько ключей в массиве keys. Отключить провайдера — Ctrl+U в списке провайдеров TUI, он удалит учётные данные из auth.json.

Быстрый вариант: переменные окружения

Красичка умеет собрать провайдера из переменных — без конфиг-файла:

export LLM_URL=https://aichaos.ru/v1
export LLM_MODEL=chat-model
export LLM_APIKEY=chaos-u-...
export LLM_KIND=openai

Провайдер появится под именем «Provider from ENV» с селектором env-provider/<LLM_MODEL>. Отключить — LLM_KIND=none.

Шаг 4. Запуск

# Терминальный UI (рекомендуется)
./target/release/krasichka-rs tui

# Продолжить последнюю сессию
./target/release/krasichka-rs tui --continue-session

# Одноразовая задача
./target/release/krasichka-rs do "разберись в архитектуре src/ и напиши summary"

# Web-приложение
cargo run --package krasichka-rs -- serve

Проверить соединение: ./target/release/krasichka-rs test — короткий запрос к настроенному провайдеру.

Настройки по умолчанию

Сессию можно завершить сохранением профиля — модель, режим компакции, MCP-тогглы записываются в ~/.krasichka/profiles/default.json5 и подхватываются при старте:

{
  model: "aichaos/chat-model",
  compaction: "auto",
  retry: { enabled: true, times: 3, delay: 30 },
  language: "ru"
}
ПараметрОписание
compactionРежим компакции контекста: auto, manual, off.
retryПовтор неудачных/пустых ходов; по умолчанию выключен, чтобы агент не молотил по сломанному провайдеру.
languageЯзык TUI: ru (по умолчанию) или en.

Устранение неполадок

  • 401. Проверьте, что в auth.json ключ записан с типом api, поле называется key, и что баланс аккаунта положительный.
  • Model not found. Код модели в model: "aichaos/<id>" должен совпадать с кодом изкаталога посимвольно.
  • Провайдер не появляется в переключателе моделей. Убедитесь, что kind: "openai" и options.baseURL — https://aichaos.ru/v1, с /v1, без слеша в конце; перезапустите TUI после правки конфига.

См. также