rociiu/talorys

Talorys – Cloudflare 계정에서 호스팅되는 개인 AI 어시스턴트

소개

• 개인 Cloudflare 계정 내에서 완전히 실행되는 오픈소스 단일 사용자용 AI 어시스턴트입니다.
• 채팅, 메모리, 작업/노트/프로젝트 관리 및 예약된 자동화(알림, 요약, AI 기반 루틴) 기능을 제공합니다.
• 외부 서버나 데이터베이스가 필요 없으며, 모든 데이터는 사용자가 소유한 SQLite 기반의 Durable Object에 저장됩니다.

작동 방식

1. 프론트엔드 – Cloudflare Pages (*.pages.dev)에서 제공되는 React/Vite 앱.
2. API 계층 – 비공개 Cloudflare Workers 함수(Hono router)가 service binding을 통해 전용 Worker로 요청을 전달합니다.
3. 에이전트 – Worker는 TalorysAgent(Cloudflare Agents SDK)를 실행하여 다음을 수행합니다:
   • 대화, 메모리, 작업, 노트, 프로젝트, 자동화 등을 SQLite에 저장.
   • Workers AI (@cf/zai-org/glm-4.7-flash)를 호출하여 스트리밍 채팅 및 도구 호출 수행.
   • Durable Object 알람을 사용하여 알림 및 반복 일정 관리.
4. 보안 – 인증은 Worker 내에서 이루어지며, 소유자 비밀번호는 로컬에서 해시 처리되어 Cloudflare 시크릿으로만 저장됩니다. 어떠한 원격 측정 데이터도 계정 외부로 유출되지 않습니다.

주요 기능

• 채팅: 스트리밍 응답, Markdown 렌더링 및 시각화된 도구 활동.
• 메모리: 지속적인 개인 정보 저장; 선택적 의미 기반 검색(시맨틱 리콜).
• 작업, 노트, 프로젝트 CRUD: UI 또는 채팅 명령어를 통해 직접 조작.
• 자동화: 일회성/반복 알림, 일일 요약, 선택적 AI 루틴; Durable Object 알람에서 실행되므로 상시 온라인 상태일 필요가 없습니다.
• 오프라인 모드: Workers AI 할당량이 소진되어도 작업/노트 기능은 계속 작동합니다.
• 백업 및 복원: 모든 개인 데이터의 JSON 백업 다운로드 가능; 가져오기 시 안전하게 병합.
• 셀프 호스팅 무료 티어: Cloudflare Workers 무료 플랜(Pages, Workers, Durable Objects, Workers AI 일일 무료 할당량)에 맞게 설계되었습니다. 유료 서비스가 자동으로 프로비저닝되지 않습니다.

설치

npx create-talorys@latest

설치 프로그램은 다음 과정을 안내합니다:

• Node 22+ 확인, Cloudflare 로그인, 계정 선택.
• 소유자 비밀번호 설정(로컬 해시).
• 시크릿 및 리소스 이름 생성, 비공개 Worker 및 Pages 사이트 배포.
• AI 호출 없이 배포 검증. 향후 업데이트를 위한 비기밀 설정이 포함된 talorys/ 폴더가 생성됩니다.

개발

• 리포지토리를 클론하고 npm install 후 npm run dev를 실행하여 Worker, Pages 프록시, Vite UI를 로컬에서 실행합니다.
• 결정론적 모의 AI 제공자를 사용하므로 로컬 개발 시 Cloudflare 로그인이 필요하지 않습니다.
• 전체 테스트 스위트(단위, e2e, 스모크) 및 TypeScript 타입 검사가 포함되어 있습니다.

유지보수

• npx create-talorys@latest update로 업데이트 – Durable Object 네임스페이스와 비밀번호를 유지하면서 코드를 재배포합니다.
• npx create-talorys@latest reset-password로 비밀번호 재설정.
• npx create-talorys@latest doctor로 상태 점검.

대상 사용자

• 서버를 직접 관리하지 않고도 비공개 셀프 호스팅 AI 어시스턴트를 원하는 사용자.
• Cloudflare 플랫폼에 익숙하며 즉시 사용 가능한 개인 에이전트를 원하는 개발자.

라이선스 – MIT.

---

위의 모든 세부 정보는 리포지토리의 README에서 직접 가져왔습니다.