Talorys: Cloudflare 무료 티어로 나만의 AI 비서 한 번에 배포하기
별도 서버나 데이터베이스 없이 Cloudflare 무료 티어만으로 채팅, 메모리, 할 일, 알림까지 갖춘 개인 AI 에이전트를 운영할 수 있습니다. 단일 명령어(npx create-talorys@latest)로 인증, 비밀번호 설정, Worker·Pages 배포까지 자동 완료됩니다. 이 글은 설치부터 첫 대화, 비밀번호 재설정·업데이트·삭제까지 전 과정을 단계별로 정리합니다.
매달 구독료를 내거나 민감한 대화를 타사 서버에 맡기지 않고도, 내 Cloudflare 계정 안에 완전히 격리된 나만의 AI 비서를 두고 싶다면 Talorys가 정답입니다. Workers AI, Durable Objects, D1/SQLite, Pages Functions만 조합해 무료 티어 한도 안에서 영구적으로 돌려 쓸 수 있습니다.
Talorys란 무엇인가요
Talorys는 여러분만의 Cloudflare 계정 안에서 동작하는 무료 오픈소스 개인 AI 비서예요. 서버, 데이터베이스, 외부 계정이 전혀 필요 없고, 단일 사용자 전용이라 개인 정보가 외부에 노출되지 않아요. 또한 Telemetry가 없고, Cloudflare 무료 티어에서도 바로 사용할 수 있도록 설계되었습니다.
핵심 기능은 채팅·메모리·태스크·노트·알림 다섯 가지예요. 채팅은 스트리밍 응답과 Markdown, 도구 사용 표시를 지원하고, 메모리는 영구 저장·편집·삭제가 가능하며 가장 관련 있는 기억만 모델에 전달됩니다. UI와 채팅 모두에서 CRUD가 가능한 태스크와 노트, 그리고 한 번 설정하면 일회성·반복 알림과 일일 작업 요약을 인앱 알림 센터에 전달해 줍니다. 모든 데이터는 Cloudflare Workers AI와 Durable Object에 저장된 SQLite에 보관되고, 알림은 Durable Object 알람으로 실행돼 무료 쿠터가 꺼져도 작동합니다.
npx create-talorys@latest로그인 확인
Wrangler CLI가 Cloudflare 로그인 상태를 확인하고, 필요하면 브라우저 인증 페이지를 엽니다.
계정·에이전트 선택
여러 계정이 있다면 사용할 계정과 에이전트 이름을 선택합니다.
소유자 비밀번호 설정
숨김 입력창에 비밀번호를 입력하면 PBKDF2‑SHA256으로 로컬 해시해 Cloudflare 비밀에 저장합니다.
배포 진행
SQLite Durable Object와 Workers AI, Pages 프로젝트를 자동으로 생성·배포하고, 서비스 바인딩을 설정합니다.
배포 확인
프론트엔드, 인증 엔드포인트, 저장소 상태를 검증해 정상 동작을 확인합니다.
| 핵심 기능 | 설명 |
|---|---|
| 채팅 | 스트리밍 응답, Markdown, 도구 활동 표시 |
| 메모리 | 지속 저장·편집·삭제, 필요 시만 모델에 전송 |
| 태스크·노트 | UI와 채팅 모두에서 CRUD 지원 |
| 알림 | 일회성·반복, Durable Object 알람 기반 |
Talorys는 내 데이터를 어떻게 보호하나요?
데이터는 모두 사용자의 Cloudflare 계정 안에 있는 SQLite Durable Object에 저장됩니다. 인증·인가 로직은 Worker 내부에서 처리되며, 비밀번호는 로컬에서 PBKDF2‑SHA256으로 해시돼 Cloudflare 비밀에만 보관됩니다. 외부 서버나 Talorys 자체 데이터베이스가 없으니 데이터 유출 위험이 최소화됩니다.
- 내 계정·내 데이터 전용
- Free‑tier 친화적
- 원 커맨드 배포
왜 Talorys를 쓰나요
Talorys는 서버리스 환경에서 동작합니다. 별도의 서버나 데이터베이스가 필요 없고, Cloudflare Workers AI와 Durable Object를 활용해 채팅, 메모, 작업, 알림 등을 한 번에 관리해요. Free‑tier friendly, single‑user, no telemetry가 핵심이라, 무료 티어에서도 바로 사용 가능하고, 사용 기록이 외부에 전송되지 않아요. 데이터는 여러분의 Cloudflare 계정 안에 있는 SQLite Durable Object에 저장되므로 데이터 주권을 완전히 보장합니다.
설치 과정도 간단합니다. npx create-talorys@latest 한 줄 명령으로 전체 인프라가 자동 배포되고, 오너 비밀번호는 로컬에서 PBKDF2‑SHA256으로 해시된 뒤 Cloudflare 비밀에만 저장돼요. 따라서 가입 절차 없이 바로 시작할 수 있습니다. 한 번 만든 작업, 메모, 알림은 Workers AI가 일시적으로 중단되거나 무료 할당량을 초과해도 계속 동작합니다. Durable Object 알람 덕분에 오프라인에서도 알림·태스크가 지속돼요.
npx create-talorys@latestNode.js 확인
Node.js 20.18+가 설치돼 있는지 확인합니다.
명령 실행
npx create-talorys@latest를 입력하고 Cloudflare 로그인·계정 선택을 진행합니다.비밀번호 설정
오너 비밀번호를 입력하면 해시가 로컬에서 처리돼 비밀에만 저장됩니다. 이후 브라우저에서 바로 채팅을 시작할 수 있어요.
| 전통적 셀프‑호스팅 | Talorys (무료 티어) |
|---|---|
| 서버·DB 관리 필요 | 서버·DB 전혀 필요 없음 |
| 데이터 외부 전송 | Zero telemetry, 데이터는 Cloudflare 안에만 |
| 비용 | 완전 무료, 추가 요금 없음 |
| 오프라인 지속성 | Durable Object 알람으로 언제든 작동 |
데이터는 어디에 저장되나요?
모든 대화·메모·작업·알림은 Cloudflare Pages Function이 연결한 SQLite Durable Object에 저장됩니다. 이 객체는 여러분의 Cloudflare 계정에만 존재하므로 외부에 데이터가 유출되지 않으며, 필요 시 직접 조회·수정·삭제가 가능합니다.
아키텍처 한눈에 보기
브라우저에서 HTTPS 요청을 보내면 Cloudflare Pages에 배포된 React 앱과 /api Pages Function이 받아요. 이 함수는 서비스 바인딩을 통해 내부에 있는 TalorysAgent(Durable Object)를 호출하고, 외부 URL을 노출하지 않아요. getAgentByName("personal-agent") 로 에이전트를 찾으며 인증·인가도 Worker 안에서 처리됩니다.
TalorysAgent 안에는 세 가지 핵심 구성요소가 있어요. SQLite는 대화·기억·작업·노트·프로젝트 등을 영구 저장하고, Workers AI(@cf/zai-org/glm-4.7-flash)는 스트리밍 응답과 툴 호출을 제공해요. Alarms는 알림·반복 일정을 Durable Object 알람으로 실행해 언제든 실행 가능하게 합니다. 채팅 응답은 Server‑Sent Events 로 스트리밍되어 프론트엔드에 바로 표시됩니다.
| 구성요소 | 역할 |
|---|---|
| SQLite | 대화·기억·작업·노트 저장 |
| Workers AI | 스트리밍 응답·툴 호출 |
| Alarms | 알림·반복 일정 실행 |
1. 브라우저 → Pages Function
HTTPS 로 React UI와
/api엔드포인트에 요청을 보냅니다.2. Pages Function → 서비스 바인딩
getAgentByName("personal-agent")로 Durable Object 에이전트를 찾습니다.3. 에이전트 → SQLite/Workers AI/Alarms
요청에 따라 SQLite에 저장·조회, Workers AI에 전달, 혹은 Alarms 설정을 수행합니다.
설치·배포 5단계 따라 하기
Talorys 를 배포하려면 먼저 Node.js(20.18 이상)와 Wrangler CLI가 설치돼 있는지 확인해주세요. Wrangler는 npm i -g @cloudflare/wrangler 로 전역 설치하거나, 최신 Node 에서는 기본 번들링돼 있습니다. 그리고 Cloudflare 계정에 로그인돼 있어야 해요. 로그인 상태가 아니면 설치 과정에서 브라우저가 자동으로 OAuth 페이지를 열어 줍니다.
준비가 끝났다면 터미널에 아래 명령을 입력합니다. 명령어 하나만으로 프로젝트 생성, 비밀키 저장, Workers AI와 Durable Object 설정, Pages 배포까지 모두 자동으로 진행돼요. 배포가 끝나면 설치 프로그램이 제공하는 URL을 열어 바로 AI 비서를 사용할 수 있습니다.
npx create-talorys@latest1. 사전 체크
Node.js와 Wrangler 버전을 확인하고 Cloudflare 로그인 상태를 검증합니다.
2. 명령 실행
npx create-talorys@latest를 입력해 설치 마법사를 시작합니다.3. 계정·에이전트·비밀번호 입력
계정을 선택하고 에이전트 이름을 정한 뒤, 숨김 입력으로 비밀번호를 입력합니다. 비밀번호는 PBKDF2‑SHA256 로 로컬에서 해시돼 Cloudflare 비밀에만 저장돼요.
4. 자동 리소스 생성·배포 검증
SQLite Durable Object, Workers AI, Pages 프로젝트가 생성되고, 배포가 성공했는지 프론트엔드와 인증 엔드포인트를 자동으로 검사합니다.
5. 접속 URL 확인
설치 프로그램이 출력한 URL을 브라우저에 열면 개인 AI 비서 화면이 뜹니다. 이제 채팅, 메모, 작업 관리 등을 바로 이용할 수 있어요.
| 항목 | 예시값 |
|---|---|
| resource names | talorys‑agent‑<random> |
| URL | https://talorys.example.pages.dev |
- Account › Workers Scripts › Edit
- Account › Cloudflare Pages › Edit
- Account › Account Settings › Read
- User › User Details › Read (선택)
추가 관리 명령
npx create-talorys@latest reset-password운영 팁과 주의할 점
Talorys는 설치 시 소유자 비밀번호를 물어보고, 입력값을 PBKDF2‑SHA256으로 해시해 Cloudflare 비밀에만 저장합니다. 비밀번호를 바꾸거나 완전히 삭제하려면 아래 명령어를 실행하면 돼요. 기존 비밀번호가 이미 설정돼 있으면 재입력 없이 바로 진행됩니다.
npx create-talorys@latest reset-password비밀번호 재설정
터미널에 위 명령을 입력하고, 화면에 표시되는 새 비밀번호를 입력합니다. 비밀번호는 최소 8자, 특수문자 포함을 권장합니다.
비밀번호 업데이트
재설정 후, 브라우저에서 로그인 화면을 열고 새 비밀번호로 로그인합니다.
비밀번호 완전 삭제
Cloudflare 대시보드 → Workers → Secrets 에서
OWNER_PASSWORD비밀을 삭제하면 비밀번호가 완전히 사라집니다.
Workers AI의 무료 할당량을 초과하면 모델 호출이 차단되지만, 대화, 메모, 작업, 알림은 계속 동작합니다. 이는 Durable Object와 알람에 저장돼 있기 때문이며, 할당량이 회복될 때까지 기존 데이터를 잃지 않아요.
| 권한 | 설명 |
|---|---|
| Account › Workers Scripts › Edit | Worker 스크립트 배포·수정 |
| Account › Cloudflare Pages › Edit | Pages 프로젝트 업데이트 |
| Account › Account Settings › Read | 계정 ID·리소스 이름 조회 |
| User › User Details › Read (optional) | 이메일 등 사용자 정보 확인 |
API 토큰을 만들 때는 위 표에 나온 최소 권한만 선택하세요. 불필요한 권한을 부여하면 보안 위험이 커질 수 있습니다.
멀티 디바이스 로그인 시 세션 관리 요령
모든 디바이스는 동일한 소유자 비밀번호를 사용해 로그인합니다. 세션이 오래될 경우 자동 로그아웃되며, 새로운 디바이스에서 로그인하면 기존 세션이 무효화됩니다. 필요하면 reset-password 명령으로 비밀번호를 바꿔 모든 세션을 강제로 종료할 수 있어요.
- 비밀번호 재설정·업데이트·완전 삭제 명령어 실행
- Workers AI 무료 할당량 소진 시 동작 확인
- API 토큰 권한은 최소한으로 설정
- 멀티 디바이스 로그인 시 정기적으로 비밀번호 갱신