프로젝트 소개

Vellum Assistant는 빠르게 설정하여 지속적으로 실행할 수 있도록 설계된 오픈소스 개인 AI 어시스턴트입니다. 핵심 주장은 계층형 기억 시스템입니다. 여덟 가지 유형(일화, 의미, 절차, 감정, 예상, 행동, 서사, 공유)이 있으며, 각각 고유한 노후화 기간, 하이브리드 dense 및 sparse 검색, 사용자별 및 채널별 격리를 갖춥니다. 신원, 선호도, 프로젝트, 이벤트와 같은 구조화된 항목은 출처 표기와 중복 제거를 통해 대화에서 추출되며, 임베딩은 기본적으로 로컬에서 실행됩니다. 행동은 SOUL.md 파일에 정의됩니다. 온보딩 중에 어시스턴트는 의사소통 스타일을 관찰하고 자체 성격 파일을 작성하며, 사용자별 성찰 일지를 유지하고, NOW.md를 현재 집중 사항을 위한 스크래치패드로 사용합니다. 선제성 루프는 매시간 노트를 다시 읽고, 미완료 또는 기한 도래 항목을 찾아내며, 진행 중인 대화를 방해하지 않고 적절한 채널로 사용자에게 메시지를 보냅니다. 보안은 행위자 신원(보호자, 신뢰됨, 알 수 없음)을 중심으로 구축되며, 한 번 확인되어 모든 곳에서 적용되고, 알 수 없는 행위자는 기억을 읽거나 도구를 트리거하거나 권한을 상승시킬 수 없습니다. 자격 증명은 별도 프로세스에 존재하며 모델에 노출되지 않고, 도구 호출은 기본 거부 태세의 샌드박스에서 실행됩니다. 컴퓨터 사용은 권한에 따라 제한됩니다. 어시스턴트는 자체 샌드박스에서 작업하며, 승인 시 파일을 읽고 편집하고, 명령을 실행하고, 브라우저를 구동할 수 있으며, 권한 부여는 일회, 10분, 또는 항상 유효합니다. 채널에는 macOS, Windows, iOS, Web, Voice, Email, Telegram, Slack, Twilio가 포함되며, 하나의 어시스턴트와 하나의 기억을 공유합니다. OAuth 통합은 Slack, Notion, Google, HubSpot, Linear, Discord, Twitter, Telegram, Twilio를 포함합니다. 스킬은 SKILL.md와 TOOLS.json으로 정의된 플러그인으로, 런타임에 도구와 프롬프트 섹션을 추가하며, 카탈로그에서 설치하거나, 번들로 제공하거나, 워크스페이스에 넣을 수 있습니다. 배포는 Vellum Platform에서 관리형으로 하거나 동일한 코드베이스에서 자체 호스팅할 수 있습니다. CLI(bun으로 설치하거나 setup.sh로 소스에서 설치)는 hatch, wake, sleep, client, ps, terminal, upgrade와 같은 명령을 제공합니다. 모델 제공자에는 Anthropic, OpenAI, Google Gemini, Fireworks, OpenRouter, MiniMax, Atlas Cloud 및 모든 OpenAI 호환 엔드포인트가 포함되며, Ollama를 통한 로컬 모델도 지원합니다. 이 프로젝트는 MIT 라이선스이며 아키텍처, 보안, 기능, API 및 개발 워크플로에 대한 문서를 포함합니다.