The-Vibe-Company/companion

What it solves

Companion은 "Skills"(SKILL.md 라이브러리에 정의됨)를 관리하고 Companions라고 불리는 AI 팀원을 조정하기 위한 중앙 집중식 시스템을 제공합니다. 개인 및 조직 환경 모두에서 AI 에이전트에게 특정 기능이나 지침을 조직하고, 버전 관리하며, 배포하는 문제를 해결합니다.

How it works

이 프로젝트의 핵심은 멀티테넌트 스킬 허브(Skills Hub)입니다. 레이블, 검증, 불변 버전 관리 및 종속성 추적과 같은 기능을 갖춘 스킬 라이브러리를 관리합니다. 선택 사항인 Companions 컨트롤 플레인이 활성화되면, 시스템은 이름이 지정된 AI 팀원을 생성하며, 각 팀원은 영구적인 Box(box.ascii.dev를 통해)와 Pi 데몬, 그리고 지속적인 채팅 스레드와 연결됩니다.

아키텍처는 여러 전문화된 구성 요소로 나뉩니다:

• Web: 스킬과 채팅 스레드를 관리하기 위한 Next.js 워크스페이스.
• API: 권한 부여 및 컨트롤 플레인 의도를 처리합니다.
• Worker: 백그라운드 루틴, GitHub 동기화 및 알림을 관리합니다.
• Runtime: Box/Pi 라이프사이클을 담당하고 턴(turns)을 실행하는 유일한 프로세스.

Who it&s for

AI 에이전트 기술을 관리하고 지속적인 AI 팀원을 배포하기 위한 구조화된 환경을 셀프 호스팅하려는 개인 및 조직을 위해 설계되었습니다.

Highlights

• Multi-tenant Skill Management: 프라이빗 및 공유 스킬 라이브러리를 가진 조직(Organization) 및 사용자(User) 역할 계층 구조를 지원합니다.
• Self-Hostable: Railway 또는 로컬 환경과 같은 인프라에 배포할 수 있도록 설계되었습니다.
• Secure Architecture: 보안을 보장하기 위해 API, worker 및 runtime에 대해 별도의 최소 권한 PostgreSQL 역할을 사용합니다.
• Integrated Runtime: Box 및 Pi 데몬과 인터페이스하는 전용 runtime을 통해 AI 에이전트의 라이프사이클을 관리합니다。