hubris
Войти
Интеграции
ИНТЕГРАЦИИ

Kilo Code (VS Code / PyCharm)

Подключение Kilo Code — AI-агента для VS Code и PyCharm — к Hubris.

Kilo Code — AI-агент для разработчиков, доступный и в VS Code, и в PyCharm. Автономно выполняет многошаговые задачи: пишет, рефакторит, отлаживает, добавляет тесты, при необходимости открывает браузер для проверки результата.

Требования

  • VS Code 1.85+ или PyCharm 2024.1+
  • Аккаунт на hubris.pw и API-ключ

Установка и подключение в VS Code

  1. Откройте панель расширений (Ctrl+Shift+X), найдите Kilo Code, нажмите Install.
  2. В боковой панели появится иконка Kilo — откройте её → Settings (шестерёнка) → вкладка Providers.
  3. Нажмите Custom providerConnect.
  4. Заполните поля:
ПолеЗначение
Provider IDhubris (или любое имя — это локальный идентификатор)
Base URLhttps://api.hubris.pw/v1
API Keyваш ключ из личного кабинета
  1. Сохраните настройки. Kilo автоматически подтянет список моделей.

Установка и подключение в PyCharm

  1. Откройте SettingsPluginsMarketplace, найдите Kilo Code, установите. Перезапустите IDE.
  2. В правой панели появится иконка Kilo — откройте, нажмите Settings.
  3. В разделе Configuration Profile создайте новый профиль.
  4. В поле API Provider выберите OpenAI Compatible.
  5. Заполните Base URL = https://api.hubris.pw/v1 и API Key. Список моделей подтянется автоматически.

Рекомендуемые модели

Kilo автономно делает много шагов (план → код → тест → правка), поэтому имеет смысл выбирать модели с поддержкой tool calling и нормальным reasoning.

IDКогда подходит
anthropic/claude-haiku-4.5быстрая работа над типовыми правками
openai/gpt-4o-miniуниверсальный недорогой выбор
google/gemini-2.0-flashмультимодальные сценарии

Для тяжёлых рефакторингов и многошаговых задач — берите Claude Opus/Sonnet из каталога. Фильтр «tool calling» поможет отсеять модели, не поддерживающие агентский сценарий.

Контроль расходов

  • Заведите отдельный ключ под Kilo, поставьте суточный лимит — на случай если автономный агент уйдёт «копать» дольше ожидаемого.
  • Для рутины используйте недорогую модель, на тяжёлые задачи переключайте Opus.
  • Расход по сессиям виден в «Расходах» — фильтруйте по ключу.

Решение проблем

Список моделей пустой / Kilo не подтягивает каталог

  • Это обычно про невалидный API-ключ или неправильный Base URL. Перепроверьте оба.
  • В VS Code иногда нужно перезагрузить окно: Ctrl+Shift+PDeveloper: Reload Window.
  • В PyCharm — закройте и заново откройте панель Kilo.

401 при первом запросе

  • Ключ должен быть в формате sk-gw- + hex, без пробелов и переводов строк.

Модель «не поддерживает изображения» / картинка не доходит

Симптомы: при попытке прикрепить изображение Kilo пишет, что модель не поддерживает image input, либо картинка вроде бы отправляется, но модель отвечает что-то вроде «This model does not support image input, please provide details as text» — и так на любой модели, даже заведомо мультимодальной (openai/gpt-4o, Claude Sonnet, Gemini).

Причина — в самом Kilo, а не в Hubris. Для провайдеров типа OpenAI Compatible Kilo определяет поддержку изображений на своей стороне, не запрашивая возможности модели у сервера, и по умолчанию считает такие модели текстовыми. В итоге расширение либо блокирует прикрепление, либо кладёт в запрос только имя файла без самой картинки — модель получает текст вроде 233.png, но не пиксели, и закономерно отвечает, что изображения не видит.

Решение — явно объявить модальности модели в файле kilo.jsonc (лежит в корне проекта или в .kilo/kilo.jsonc):

{
  "provider": {
    "hubris": {
      "models": {
        "openai/gpt-4o": {
          "name": "openai/gpt-4o",
          "modalities": {
            "input": ["text", "image"],
            "output": ["text"]
          }
        }
      }
    }
  }
}
  • hubris — тот же Provider ID, что вы задали при подключении.
  • Ключ модели (openai/gpt-4o) должен точно совпадать с тем, что выбран в Kilo.
  • В input перечислите реально поддерживаемые модальности — для работы с картинками обязателен "image". Поддерживает ли модель изображения, видно в каталоге (фильтр «принимает изображения»).
  • Пропишите так каждую модель, которой будете отправлять картинки.

После правки перезагрузите окно: Ctrl+Shift+PDeveloper: Reload Window.

Со стороны Hubris vision работает в полном объёме: /v1/chat/completions принимает изображения и публичным URL, и base64 data URL — подробности в Изображения на вход. Ограничение здесь чисто на стороне Kilo.

Kilo не справляется с задачей / зацикливается

  • Слабая модель плохо ведёт себя как агент. Попробуйте более сильную из каталога с явной поддержкой tool calling.
  • Уменьшите размер задачи: дайте Kilo более узкую цель.

Что дальше

Обновлено: