KiCk

Локальный OpenAI-совместимый прокси для Gemini CLI в нативном Flutter-приложении

Поддерживаемые платформы

Интерфейс

Что это

KiCk поднимает у вас на устройстве локальный адрес в формате OpenAI и пересылает запросы в Gemini через подключенные Google-аккаунты. Приложение нужно для тех, кто хочет работать с Gemini CLI без терминала, ручной настройки входа и отдельного локального сервера.

Что умеет

• Запускает локальный адрес http://127.0.0.1:3000/v1 по умолчанию.
• Принимает запросы в формате OpenAI.
• Работает с несколькими Google-аккаунтами, умеет выставлять приоритеты и временно убирать проблемный аккаунт из очереди.
• Подключает аккаунты через вход в браузере.
• Позволяет менять адрес, порт, ключ доступа, число повторов и список моделей.
• Показывает состояние прокси, аккаунтов и журнал работы.
• Работает в фоне на Android.
• Может запускаться вместе с Windows.

Как начать

1. Скачайте последнюю версию из раздела выпусков.
2. Откройте экран аккаунтов и подключите Google-аккаунт.
3. Укажите идентификатор проекта в Google Cloud для этого аккаунта.
4. Вернитесь на главный экран и запустите прокси.
5. Скопируйте локальный адрес и ключ доступа (если требуется)
6. Подставьте их в свою программу или в Gemini CLI.

По умолчанию используется адрес http://127.0.0.1:3000/v1. Его можно поменять в настройках.

Какие адреса поддерживаются

• GET /health
• GET /v1/models
• POST /v1/chat/completions
• POST /v1/responses

Пример запроса

curl http://127.0.0.1:3000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ВАШ_КЛЮЧ" \
  -d '{
    "model": "gemini-2.5-pro",
    "messages": [
      {"role": "user", "content": "Напиши короткое приветствие"}
    ]
  }'

Если вы отключили проверку ключа доступа, строку с Authorization можно убрать.

Что можно настроить

• Сетевые параметры: адрес, порт, доступ из локальной сети.
• Доступ: требование ключа, просмотр и перевыпуск ключа.
• Надежность: число повторов, задержка после ошибки 429, временный вывод аккаунта из очереди.
• Модели: список дополнительных моделей и список недоступных моделей для конкретного аккаунта.
• Google: веб-поиск по умолчанию и показ источников в ответе.
• Приложение: тема, подробность журнала, работа в фоне на Android, запуск вместе с Windows.

Где хранятся данные

• Токены входа и локальный ключ доступа хранятся в защищенном хранилище устройства.
• Настройки, список аккаунтов и журнал работы хранятся локально.
• Запись полных сырых данных по умолчанию отключена.
• При сохранении и выгрузке журнала чувствительные данные маскируются.
• Анонимная аналитика отключена по умолчанию.

Подробности: Политика конфиденциальности.

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

• Порт занят: выберите другой порт в настройках.
• Нет активных аккаунтов: подключите аккаунт или включите уже добавленный.
• Истек вход в Google: переподключите аккаунт.
• Google просит подтвердить аккаунт: откройте страницу подтверждения и войдите тем же аккаунтом.
• Неверно указан идентификатор проекта в Google Cloud или отключен нужный доступ: проверьте проект и его настройки.
• Ошибка 429: подождите сброса ограничения или включите временный вывод проблемного аккаунта из очереди.

Сборка из исходников

1. Установите Flutter и нужные инструменты для Android.
2. Выполните:

flutter pub get
flutter test

3. Для запуска во время разработки используйте:

flutter run -d windows

или

flutter run -d android

4. Для локальной сборки установщика Windows нужен Inno Setup 6:

powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\build-windows-installer.ps1

Подробности по сборке и выпуску: CONTRIBUTING.md.

Лицензия | Политика конфиденциальности | Как вносить изменения