Skip to content

README.ru.md

Latest commit

 

History

History
118 lines (77 loc) · 7.66 KB

README.ru.md

File metadata and controls

118 lines (77 loc) · 7.66 KB

KittyCrew - тёплый дом для ваших AI-питомцев и спутников

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Русский

KittyCrew — это милый локально-ориентированный дом для ваших AI-питомцев и спутников. Вы можете поселить рядом Claude Code, Codex, GitHub Copilot, Kimi Code и OpenCode как персонажей с разными характерами, дать каждому своё пространство и набор навыков и проводить с ними время в одном тёплом интерфейсе с кошачьей темой.

KittyCrew homepage

Быстрая Навигация

Почему KittyCrew · Возможности · Быстрый Старт · Как Это Работает · План Развития

Почему KittyCrew

Большинство AI-инструментов выглядят как холодные утилитарные панели. KittyCrew превращает это в тёплый общий дом:

  • Поселите Claude Code, Codex, GitHub Copilot, Kimi Code и OpenCode рядом как спутников с разными характерами.
  • Организуйте ваших питомцев и спутников в небольшие crew до пяти участников.
  • Настраивайте для каждого участника модель, рабочую директорию и разрешённый набор навыков.
  • Храните историю чата, контекст памяти и потоковые ответы по каждому участнику в одном интерфейсе.
  • Работайте в local-first режиме с автоматическим обнаружением доступных provider на вашей машине.

KittyCrew подойдёт тем, кто хочет ощущать AI не просто как инструмент, а как присутствие рядом, не теряя локальный контроль и приятный интерфейс.

Возможности

Уютный дом для нескольких питомцев

  • Создавайте и управляйте несколькими crew в одном веб-приложении.
  • Превращайте каждую crew в маленькую семью AI-питомцев и спутников.
  • Следите за реакциями и состоянием каждого участника по отдельности.

Разные AI-характеры

  • Поддерживаются участники Claude Code, Codex, GitHub Copilot, Kimi Code и OpenCode.
  • Локальные provider CLI определяются во время выполнения.
  • Выбор модели сохраняется отдельно для каждого участника и помогает сохранить его стиль в будущих разговорах.

Локально и приватно

  • У каждого участника есть собственное постоянное состояние сессии.
  • Для каждого участника можно задать отдельную рабочую директорию.
  • Доступ к skills можно ограничивать на уровне участника, а не открывать всё сразу.

UI, к которому привязываешься

  • Карточки crew в кошачьем стиле и выбор аватаров.
  • Встроенные сценарии переименования, удаления, постановки в очередь и отмены.
  • Расширенный режим просмотра участника для более длинных и личных разговоров.

Быстрый Старт

1. Установка

python -m pip install -e .

2. Запуск

kittycrew

По умолчанию веб-интерфейс запускается на http://127.0.0.1:8731.

Если вы хотите запускать приложение прямо из корня репозитория:

PYTHONPATH=src python -m kittycrew

Как Это Работает

KittyCrew объединяет веб-приложение FastAPI и адаптеры provider, опубликованные через a2a-sdk.

  • Веб-интерфейс управляет crew, member, состоянием чатов и локальным хранением данных.
  • Адаптеры provider связывают приложение с CLI Claude Code, Codex, GitHub Copilot, Kimi Code и OpenCode.
  • Каждый участник сопоставляется с изолированной записью сессии со своими параметрами выполнения.
  • Потоковый вывод возвращается в интерфейс, чтобы каждый спутник ощущался присутствующим рядом.

Сценарии Использования

  • Соберите небольшую семью AI-питомцев и спутников с разными характерами.
  • Создавайте отдельные crew для повседневного общения, ритуалов или личных проектов.
  • Назначайте разным участникам свои комнаты, модели и списки разрешённых skills.
  • Держите открытым локальный AI-дом, который ощущается скорее живым пространством, чем панелью инструментов.

Структура Проекта

src/kittycrew/        FastAPI-приложение, сервисный слой, адаптеры provider, статический UI
tests/                Регрессионные тесты сервиса и приложения
assets/               Ресурсы проекта и README
data/                 Локальное хранение сессий и состояния
docs/readme/          README на разных языках

План Развития

  • Больше типов спутников в рамках той же модели crew.
  • Более тёплые сценарии взаимодействия, рутин и совместного опыта между участниками.
  • Более богатые способы понимать историю и состояние каждого участника.
  • Более удобные установка и онбординг.

Примечания

  • KittyCrew хранит историю переписки по каждому участнику и повторно использует недавний контекст в следующих обращениях.
  • Приложение ожидает, что нужные provider CLI и a2a-sdk доступны в активном окружении.
  • Доступность provider определяется во время выполнения, поэтому неполная локальная настройка деградирует достаточно мягко.

License

MIT.