mariagorskikh/open-instinct

Open‑Instinct – 문자로 대화할 수 있는 오픈소스 개인 AI 에이전트

소개

• 문자 메시지(iMessage, SMS 또는 이메일)를 보내 상호작용하는 "개인 에이전트"입니다. 에이전트는 자체 경량 가상 머신(Maritime 플랫폼의 microVM) 내에서 실행되며, 파일 생성, 캘린더 일정 예약, 구매 등 실제 작업을 사용자를 대신하여 수행할 수 있습니다.

작동 방식

1. ID 및 메시징 – 에이전트에 전화번호를 부여합니다. Inkbox(전화번호/이메일을 agent‑to‑agent 엔드포인트로 매핑하는 서비스)가 해당 번호, 이메일 주소 및 보안 엔드포인트를 상대방 에이전트에게 전달합니다.
2. 실행 환경 – 소형 게이트웨이가 에이전트를 깨우고, Maritime의 microVM 내에서 실행됩니다. VM 내부에서는 Pi 에이전트 루프(핵심 오케스트레이션 엔진)가 작동합니다.
3. 도구 및 통합 – Pi 루프는 다음을 통해 외부 서비스와 통신합니다:
   • Composio – SaaS 도구(Notion, Google Calendar 등)를 위한 통합 API.
   • Stripe Link – 구매를 위한 일회용 카드를 생성하는 지갑으로, 모델이 카드 세부 정보를 절대 볼 수 없습니다.
   • Claude Fable 5.1 – 추론을 담당하는 기본 LLM.
4. 정책 및 신뢰 – 도구를 사용하기 전에 정책 가드가 요청 에이전트의 신뢰 등급(소유자, 파트너, 친구, 낯선 사람 등)을 확인합니다. 권한은 평이한 영어로 표현됩니다(예: "Sam은 이번 주에 우리 저녁 식사를 예약할 수 있다").
5. 출력 – 에이전트는 작업 공간에서 실제 결과물(PDF, 파일)을 생성하고 첨부 파일로 다시 보낼 수 있습니다.

주요 구성 요소(저장소 구조)

패키지	역할
core	Pi 루프, 메모리, 스케줄러, 정책 엔진
inkbox	메시징 어댑터(iMessage, SMS, 이메일) 및 agent‑to‑agent 전송
computer	microVM 내부의 데스크톱 환경(Maritime desktopd)
apps	Composio 지원 도구로 요청을 전달하는 라우터
network	연락처 관리, 등급 정의, 초대
payments	일회용 카드 결제를 위한 Stripe Link 통합
server	HTTP API (/health, /chat, /schedules)
gateway	다수의 에이전트를 프로비저닝하기 위한 다중 사용자 등록/릴레이 서비스
cli	명령줄 인터페이스 (instinct)
skills	에이전트의 행동을 정의하는 플레이북

시작하기

• Node 22.19+ 및 pnpm 10이 필요합니다.
• 클론 후 설치를 진행하고, Anthropic API 키를 설정한 다음, 이름, 전화번호, 이메일, 핸들을 사용하여 pnpm instinct init을 실행합니다.
• pnpm instinct dev로 로컬 에이전트를 시작할 수 있으며, CLI를 통해 또는 Inkbox 설정 후 실제 전화번호를 통해 대화할 수 있습니다.
• 프로덕션 환경에서는 빌드된 Docker 이미지를 Maritime에 배포할 수 있습니다(pnpm instinct deploy). 게이트웨이 서비스를 통해 여러 사용자를 위한 에이전트를 프로비저닝할 수 있습니다.

신뢰 모델 및 결제

• 도구 실행 전 코드 내에서 6단계 신뢰 등급(소유자 → 낯선 사람)이 강제됩니다.
• 구매는 Stripe Link를 통해 중재됩니다. 에이전트가 일회용 카드를 요청하면 사용자가 휴대폰으로 승인하고, 거래 후 카드는 폐기됩니다.

상태

• 버전 0.1, 테스트 스위트(837개 테스트) 및 엔드투엔드 스모크 테스트 완료.
• 실제 iMessage 및 Maritime 배포 사례가 있으나, 프로젝트는 여전히 베타 단계로 간주됩니다.

대상 사용자

• 타사 서비스에 자격 증명을 넘기지 않고 자신을 대신하여 행동할 수 있는 비공개 셀프 호스팅 AI 비서를 원하는 개발자나 파워 유저.
• 신뢰 수준과 감사 가능성이 중요한 맞춤형 "agent‑to‑agent" 워크플로우를 구축하는 팀.

라이선스 – MIT。