Skip to content

README.ko.md

Latest commit

 

History

History
118 lines (77 loc) · 4.86 KB

README.ko.md

File metadata and controls

118 lines (77 loc) · 4.86 KB

KittyCrew - AI 반려동물과 친구들을 위한 따뜻한 집

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

KittyCrew는 Claude Code, Codex, GitHub Copilot, Kimi Code, OpenCode를 AI 반려동물과 친구처럼 함께 둘 수 있는 귀엽고 로컬 우선적인 공간입니다. 여러 멤버에게 각자의 방과 스킬 세트를 주고, 고양이 테마의 따뜻한 화면 안에서 함께 지낼 수 있습니다.

KittyCrew homepage

빠른 탐색

왜 KittyCrew인가 · 주요 기능 · 빠른 시작 · 동작 방식 · 로드맵

왜 KittyCrew인가

대부분의 AI 도구는 차갑고 기능적인 패널처럼 보입니다. KittyCrew는 그것을 함께 머무는 따뜻한 집으로 바꿉니다.

  • Claude Code, Codex, GitHub Copilot, Kimi Code, OpenCode를 서로 다른 성격의 친구처럼 함께 둘 수 있습니다.
  • 최대 5명의 멤버로 반려동물과 친구들을 작은 crew로 묶을 수 있습니다.
  • 각 멤버마다 모델, 작업 디렉터리, 허용 스킬 범위를 따로 지정할 수 있습니다.
  • 멤버별 채팅 기록, 기억 맥락, 스트리밍 응답을 하나의 UI에서 볼 수 있습니다.
  • 로컬 우선 방식으로 동작하며, 사용 가능한 provider를 내 컴퓨터에서 자동 감지합니다.

KittyCrew는 AI를 단순한 도구가 아니라 곁에 두는 존재처럼 느끼고 싶은 사용자를 위한 공간입니다. 로컬 제어와 다정한 UI를 함께 제공합니다.

주요 기능

따뜻한 멀티 펫 홈

  • 하나의 웹 앱에서 여러 crew를 생성하고 관리할 수 있습니다.
  • 각 crew를 AI 반려동물과 친구들로 이루어진 작은 가족처럼 꾸릴 수 있습니다.
  • 각 멤버의 반응과 상태를 따로 지켜볼 수 있습니다.

개성 있는 AI 친구들

  • Claude Code, Codex, GitHub Copilot, Kimi Code, OpenCode 멤버를 지원합니다.
  • 로컬 provider CLI를 런타임에 자동 감지합니다.
  • 이후 대화에 적용되는 멤버 단위 모델 선택을 유지해 각자의 분위기를 살릴 수 있습니다.

로컬에서 안심

  • 각 멤버는 독립적인 영속 세션 상태를 가집니다.
  • 각 멤버마다 서로 다른 작업 디렉터리를 사용할 수 있습니다.
  • 모든 스킬을 열어두는 대신 멤버별로 접근 범위를 제한할 수 있습니다.

애착이 가는 UI

  • 고양이 테마 crew 카드와 아바타 선택.
  • 인라인 이름 변경, 삭제, 대기열 추가, 취소 흐름.
  • 오래 머무는 대화를 위한 확장 멤버 보기.

빠른 시작

1. 설치

python -m pip install -e .

2. 실행

kittycrew

기본적으로 Web UI는 http://127.0.0.1:8731 에서 실행됩니다.

저장소 루트에서 직접 실행하려면:

PYTHONPATH=src python -m kittycrew

동작 방식

KittyCrew는 FastAPI 웹 앱과 a2a-sdk 로 노출되는 provider 어댑터를 결합합니다.

  • Web UI가 crew, member, 채팅 상태, 로컬 영속화를 관리합니다.
  • Provider 어댑터가 Claude Code, Codex, GitHub Copilot, Kimi Code, OpenCode CLI를 연결합니다.
  • 각 멤버는 독립 실행 설정을 가진 격리된 세션 레코드에 매핑됩니다.
  • 스트리밍 출력은 UI로 다시 전달되어 각 친구가 곁에 있는 느낌을 유지합니다.

사용 사례

  • 서로 다른 성격과 역할을 가진 AI 반려동물과 친구들을 함께 둡니다.
  • 일상 대화, 창작, 생활 루틴에 맞춰 crew를 나눕니다.
  • 멤버마다 방, 모델, 허용 스킬을 다르게 설정합니다.
  • 단순한 도구 패널이 아니라 늘 열어 둘 수 있는 따뜻한 AI 공간으로 사용합니다.

프로젝트 구조

src/kittycrew/        FastAPI 앱, 서비스 계층, provider 어댑터, 정적 UI
tests/                서비스 및 앱 회귀 테스트
assets/               README 및 프로젝트 에셋
data/                 로컬 세션 및 상태 저장소
docs/readme/          다국어 README

로드맵

  • 같은 crew 모델 아래 더 많은 친구 유형 추가.
  • 멤버 간 상호작용과 일상 경험 강화.
  • 각 멤버의 기록과 상태를 더 풍부하게 살펴볼 수 있도록 개선.
  • 설치와 온보딩 흐름 개선.

참고

  • KittyCrew는 멤버별 대화 기록을 저장하고 이후 대화에서 최근 문맥을 다시 사용합니다.
  • 앱을 사용하려면 관련 provider CLI와 a2a-sdk 가 현재 환경에서 사용 가능해야 합니다.
  • Provider 가용성은 런타임에 감지되므로 로컬 설정이 완전하지 않아도 가능한 범위에서 동작합니다.

License

MIT.