TL;DR

  • Instinct는 각자 전용 컴퓨터를 갖고 실제 작업을 수행하며 신뢰하는 사람들의 에이전트와 협력하는 오픈소스 개인 에이전트임.
  • Inkbox가 전화번호, 이메일 주소, 에이전트 간 엔드포인트를 제공하고, Maritime의 Linux 데스크톱을 갖춘 마이크로VM에서 에이전트가 실행됨.
  • 모든 도구 실행 전 코드로 적용되는 6단계 권한 체계와 자연어 예외 권한으로 접근 범위를 제어함.
  • 기본 모델은 Claude Fable 5.1이며, 어떤 Pi 제공자도 사용할 수 있고 앱 연동에는 Composio, 결제에는 Stripe Link를 사용함.
  • 버전 0.1에는 9개 패키지, 725개 테스트, 종단 간 스모크 테스트와 콜드 스타트 테스트가 포함되며, 실시간 iMessage 및 Maritime 배포는 베타 상태임.

작동 방식

  • 전화번호로 문자를 보내면 Inkbox가 에이전트에 해당 번호와 이메일 주소, 에이전트 간 엔드포인트를 할당함.
  • 소형 게이트웨이가 에이전트를 깨우며, 에이전트는 Maritime의 Linux 데스크톱이 포함된 전용 마이크로VM에서 실행됨.
  • 내부에서는 Pi 에이전트 루프가 Composio를 통한 앱 연동, Stripe Link 지갑, 모든 도구 앞에 놓인 정책 가드와 함께 작동함.
  • 기본 모델은 Claude Fable 5.1이며, 어떤 Pi 제공자도 사용할 수 있음.

누가 어떤 권한을 갖는가

  • 도구 실행 전에 코드로 적용되는 6단계 권한 체계를 사용함.
  • 파트너의 에이전트는 캘린더를 읽을 수 있고, 친구의 에이전트는 일정이 비는 시간만 물어볼 수 있음.
  • 낯선 사람의 에이전트에는 정중히 거절하며, 누가 무엇을 요청했는지 한 줄 문자로 알림.
  • 자연어 권한 부여로 예외를 추가할 수 있음. 예: “Sam은 이번 주에 우리 저녁 식사를 예약할 수 있음.”
  • 자세한 내용은 PERMISSIONS.md와 PROTOCOL.md에 있음.

빠른 시작

  • Node 22.19+와 pnpm 10이 필요함.
  • 사용자가 직접 API 키를 준비해야 하며, 필요한 키와 발급 방법은 KEYS.md에 정리돼 있음.
  • 저장소에는 어떤 키도 저장되지 않음.

노트북에서 전화번호 없이 실행

  • 저장소를 복제하고 nvm use와 corepack enable을 실행한 뒤 의존성을 설치하고 빌드함. corepack에 권한 문제가 있으면 전역으로 pnpm@10을 설치함.
  • ANTHROPIC_API_KEY를 설정한 다음 pnpm instinct init으로 이름, 전화번호, 이메일, 핸들을 지정해 초기화함.
  • pnpm instinct dev로 개발 서버를 실행하고, 다른 터미널에서 pnpm instinct chat에 메시지를 전달해 에이전트와 대화함.
  • 저장소 주소: https://github.com/mariagorskikh/open-instinct

iMessage 회선 사용

  • inkbox.ai 콘솔에서 INKBOX_ADMIN_API_KEY를 설정함.
  • pnpm instinct init으로 이름, 전화번호, 이메일, 핸들을 설정하고 pnpm instinct dev --tunnel로 터널을 실행함.
  • pnpm instinct connect를 실행하면 연결할 전화번호와 보낼 문자가 표시됨. 문자는 connect @maria-instinct 형식임.

Maritime에서 사람마다 에이전트 하나 실행

  • maritime.sh의 설정 및 API 키 메뉴에서 MARITIME_API_KEY를 설정함.
  • pnpm instinct deploy로 ghcr.io/mariagorskikh/open-instinct-agent:latest 이미지를 배포함.
  • 여러 사람을 대상으로 운영하려면 게이트웨이를 실행함. 가입 페이지가 사용자별 신원과 에이전트를 생성함.
  • 안내 문서는 DEPLOY-MARITIME.md임.

가입 페이지와 연결 페이지

  • 가입 페이지와 연결 페이지가 제공됨.

저장소

  • packages/core: Pi 에이전트 루프, 정책 엔진, 메모리, 스케줄러, 승인, 감사 기능.
  • packages/inkbox: iMessage, SMS, 이메일, 웹훅, 에이전트 간 전송.
  • packages/computer: 데스크톱. VM 안의 Maritime desktopd 또는 호스팅된 Computers MCP를 사용함.
  • packages/apps: Composio Tool Router.
  • packages/network: 연락처, 권한 단계, 권한 부여, 초대, 에이전트 간 도구.
  • packages/payments: 소유자가 승인하는 일회용 카드용 Stripe Link 지갑.
  • packages/server: 에이전트 프로세스와 /health, /chat, /schedules 엔드포인트.
  • packages/gateway: 다중 사용자 릴레이와 가입 기능.
  • packages/cli: instinct 명령.
  • skills/: 에이전트가 따르는 실행 지침.
  • docs/: 아키텍처, 권한, 프로토콜, 키, 배포, 조사 문서.

문서

  • 아키텍처, 권한, 프로토콜, 키, Maritime 배포, 자체 호스팅, Inkbox, Composio, 결제, 보안, FAQ, 예제 문서가 있음.
  • 조사 문서에는 Instinct의 정의, 요구 사항, 기술 참조가 포함됨.

상태

  • 버전은 0.1이며, 패키지 9개와 테스트 725개를 포함함.
  • 스크립트 기반 종단 간 스모크 테스트와 새로 복제한 저장소에서 실행하는 콜드 스타트 테스트가 있음.
  • 개발 중 실제 신원을 사용해 실시간 iMessage와 Maritime 배포를 시험했으며, 두 기능은 베타로 취급해야 함.
  • 로그인, 2단계 인증(2FA), 결제는 데스크톱 인계 또는 Link 승인으로 사용자에게 전달되며, 모델에만 전달되지는 않음.

프로젝트 구분 및 라이선스

  • Merit Systems는 무관한 프로젝트인 OpenInstinct를 공개함. 이 프로젝트는 OpenInstinct 또는 Instinct와 제휴 관계가 없음.
  • 기여 안내와 MIT 라이선스가 제공됨.