realchendahuang/FlareMo
realchendahuang/FlareMo has 356 GitHub stars and 107 forks. GitHot measured 0 stars in 24 hours and +2 in 7 days. Last checked 2026-11-18 22:24 UTC. Last push 2026-11-11.
측정된 스타 증가
- in 24h
- 0
- in 7 days
- +2
- in 15 days
- 업데이트 지연
- in 1 month
- 업데이트 지연
서로 겹치는 기간의 순증가량이며 일별 합계가 아닙니다. 측정값이 없으면 비워 둡니다. 스타는 관심도를 나타내며 품질을 보장하지 않습니다.
소개
跑在 Cloudflare 上的 AI 原生第二大脑:零服务器、零运维,记录、任务与文章沉淀为你的知识库,也是 AI Agent 的长期记忆。 / An AI-native second brain on Cloudflare: zero servers, zero upkeep.
생산성README.ko.md
OriginalFlareMo 🔥
서버 제로 · 유지보수 비용 제로 · 24시간 글로벌 엣지 상시 가동 · 완전한 데이터 소유권
개인에게는 AI 네이티브 세컨드 브레인, 팀에게는 함께 쓰는 지식 베이스.
English • 简体中文 • 日本語 • Français • Español • 한국어 • Русский • العربية
| ☀️ 데스크톱 · 라이트 모드 | 🌙 데스크톱 · 다크 모드 | 📱 모바일 · 반응형 |
|---|---|---|
![]() |
![]() |
![]() |
| ✅ 할 일·프로젝트·돌아보기 | 📄 글과 발행 |
|---|---|
![]() |
![]() |
실제 운영 화면 스크린샷: 라이트/다크 모드 매끄러운 전환과 모바일 완전 반응형. 화면에 보이는 모든 기능은 실제로 동작하는 백엔드 기능과 연결되어 있습니다.
💡 왜 FlareMo인가?
부담 없는 메모 기록과 방해받지 않는 타임라인의 가치는 이미 충분히 증명되었습니다. 하지만 전통적인 노트 환경을 자체 호스팅하려면 VPS 비용을 지불하고, Docker와 PostgreSQL을 설정하고, 자동 백업 스크립트를 작성·관리하면서 디스크나 하드웨어 고장을 걱정해야 했습니다.
FlareMo는 더 단순한 질문에 답합니다: 무료 Cloudflare 계정 하나만으로, 서버 유지보수 없이 24시간 온라인으로 살아있고 전 세계에서 가속되는 지식 베이스를 만들 수 없을까?
- 진정한 서버리스: 코드와 정적 자산 모두 사용자 바로 근처의 Cloudflare Workers 엣지 노드에서 밀리초 단위 지연으로 실행됩니다.
- 기본 갖춰진 엔터프라이즈급 내구성: Cloudflare D1이 메모와 메타데이터를 담당하고, Cloudflare R2가 멀티 리전 복제로 미디어 첨부파일을 저장합니다.
- AI 네이티브 제2의 뇌: 노트 MCP 엔드포인트와
flaremo-notes스킬을 제공합니다. Claude, Cursor, Codex, ChatGPT, ZCode가 사용자의 노트를 검색·읽기·쓰기할 수 있습니다. 별도의 AI 기억 저장소나 관리해야 할 두 번째 노트북은 없습니다. - 혼자서는 조용히, 함께라면 강력하게: 기본값은 암호화된 비공개 1인용 안식처입니다. 팀 모드를 켜면 역할과 3단계 공개 범위를 갖춘 팀 공유 공간이 추가됩니다 — 프로젝트를 함께 진행하는 곳이 아니라 메모를 나누는 곳입니다.
- 심플하되 단순하지 않게: 인터페이스는 조용하고 모든 컨트롤은 존재 이유가 분명합니다 — 주의를 끄는 장식도, 빠진 기능도 없습니다.
✨ 핵심 기능
1. 즉석 기록 & 영감을 주는 회고
- 밀리초 만에 기록: 카드형 타임라인, 태그, Markdown/GFM, 이미지·오디오 첨부 미리보기.
- 메모와 글: 입력창은 빠른 메모로 유지됩니다(태그, 이미지 최대 9장, 굵게, 목록, 할 일). '전체 화면으로 쓰기'를 누르면 같은 메모를 전체 화면 캔버스에서 이어 씁니다. 글은 '글' 페이지에서 시작합니다.
- 메모 아래 댓글: 개인 공간이든 팀 공간이든 웨이보처럼 어떤 메모에나 댓글을 달 수 있습니다. 댓글은 원래 메모 아래에 머물며 타임라인, 검색, 통계, 태그, 회고에는 나타나지 않습니다.
- 번개같은 검색: SQLite FTS5 전문 인덱싱과 쿼리 연산자 지원 (
has:attachment,is:pinned,before:YYYY-MM-DD,after:YYYY-MM-DD,in:timeline|archive|trash). - 의미 기반 '찾기' (벡터 검색): Workers AI 임베딩과 Vectorize 파생 벡터 인덱스를 결합해 문맥에 맞는 회상을 제공하며, D1 권한을 재검증하고 필요 시 FTS5로 매끄럽게 대체합니다.
- 생각 활성화: 내장 데일리 리뷰(과거의 오늘), 랜덤 워크(태그·백링크 그래프를 탐험하며 엽서 요약 수집), 관련 노트 추천.
- 버전 이력: 전체 버전 diff 비교와 클릭 한 번으로 과거 버전 복원.
2. AI가 내 노트를 읽고 쓰기 (MCP + Skill)
- 노트 MCP:
/mcp에서 노트 목록·검색·조회·생성·수정·삭제를 제공하며, 폐기 가능한memos_pat_토큰으로 인증합니다. - 하나의 Skill:
skills/flaremo-notes가 쓰기 전 검색, 원문 유지, 변경한 노트 ID 반환을 모든 에이전트에 가르칩니다. - 별도 기억 없음: 에이전트는 필요할 때 노트를 읽을 뿐, 백그라운드에서 두 번째 장부로 추출하지 않습니다.
3. 할 일 & 프로젝트
- 메모에 일정 잡기: 메모에 날짜와 프로젝트를 지정하면 그 안의 체크되지 않은 할 일이 각각 작업이 됩니다. 메모에서 체크하든 할 일 페이지에서 체크하든 양방향으로 동기화됩니다.
- 하나의 할 일 페이지:
/projects는 오늘, 다음 7일, 모든 작업을 날짜별로 묶은 목록으로 보여주고, 프로젝트는 칸반 보드(상태 열 간 드래그, 우선순위, 수동 정렬)로 보여줍니다. 모든 목록에 빠른 추가 행이 있습니다. - 개인 전용, 되돌릴 수 있는 삭제: 작업은 소유자 한 사람의 소유이며, 삭제 시 휴지통으로 이동해 복원하거나 기간이 지나면 자동으로 영구 삭제됩니다.
4. 알림 & 일정
- 읽는 곳에 배지 표시: 일정이 잡힌 메모는 카드에 '할 일 n/m · 날짜 · 프로젝트'를 표시하고, 데일리 리뷰는 오늘의 할 일로 시작합니다.
- 일정이 한눈에: 탐색기 홈 화면이 미니 월간 캘린더와 기한 초과/오늘 알림을 함께 보여줘, 마감이 보드 뒤에 숨지 않습니다.
- 마감 및 기한 초과 알림: 매일 실행되는 작업이 '오늘 마감'과 기한 초과 알림을 앱 안에 띄우며, 브라우저 웹 푸시도 선택적으로 켤 수 있습니다. 일정은 날짜 단위이며, 시각을 지정하는 알람은 없습니다.
5. 팀 공간 & 3단계 공개 범위
- 협업이 아닌 공유: 팀 공간은 멤버들이 서로에게 메모를 발행하고 댓글을 다는 곳입니다. 팀 입력창에서
@username멘션이 자동 완성되고 멘션된 사람에게 알림이 가며, 알림을 열면 원래 메모의 댓글 위치로 이동합니다. - 역할 거버넌스:
owner,admin,member역할. 관리자는 1회용 활성화 링크로 멤버를 초대하고, 멤버가 직접 비밀번호를 설정합니다(관리자는 평문 자격 증명을 절대 다루지 않습니다). - 3단계 공개 범위:
- 🔒 비공개: 작성자 본인만 열람 가능.
- 👥 팀 공개: 활성 팀원에게 읽기 전용 공유.
- 🌐 전체 공개: 기한이 있는 공유 링크로 익명 읽기 전용 접근.
- 안전한 멤버 제외: 멤버 제거 시 신뢰할 수 있는 백그라운드 정리가 실행되어 비공개 데이터는 완전히 삭제하고 팀 및 공개 메모는 보존합니다.
- 리더 시트: 기한이 있는 읽기 전용 시트를 부여할 수 있습니다 — 게스트 독자, 강의 수강생, 고객 납품 등. 시트는 만료 시점에 자동으로 접근이 차단됩니다(자격 해석 시 fail-closed, 크론 불필요). 멤버 페이지에서 관리하거나, Personal Access Token으로
PUT /api/app/admin/team/reader엔드포인트를 호출해 이메일로 개통할 수 있습니다(docs/team-mode.md참조).
6. 오프라인 우선 & PWA 경험
- 설치형 PWA: macOS, Windows, iOS, Android 홈 화면에 설치해 네이티브 앱과 같은 사용감을 제공합니다.
- 신뢰할 수 있는 오프라인 동기화: 초안은 즉시 로컬에 저장됩니다. 오프라인 상태의 제출과 업로드는 큐에 쌓였다가 연결이 복구되면 자동으로 재생됩니다.
- 실시간 음성 입력: 입력창의 마이크 버튼을 누르면 말하는 내용이 실시간 음성 인식(ASR)으로 초안에 입력됩니다.
7. 강력한 Better Auth 애플리케이션 보안
- Better Auth 기반:
HttpOnly,SameSite=Lax브라우저 쿠키 세션과, 스크립트·MCP용으로 폐기 가능한memos_pat_Personal Access Token을 제공합니다. - 엄격한 Origin 보호: 상태 변경 요청에는 정확한 Origin 화이트리스트 검증을 강제합니다. Cloudflare Access는 선택적 외부 방어선으로 계속 사용할 수 있습니다.
8. 데이터는 언제나 내 것
- 원클릭 전체 내보내기: 노트, 첨부 파일, 할 일, 프로젝트, 아티클, 공유 관계를 하나의 파일로 묶어 언제든 오프라인 보관합니다.
- 절반만 남지 않는 가져오기: 건너뛰기와 복제 두 가지 충돌 전략을 지원하며, 실패한 가져오기는 전부 롤백되어 불완전한 데이터가 남지 않습니다.
- 기존 기록 가져오기: 함께 제공되는 변환 스크립트가 기존 내보내기를 FlareMo 가져오기 패키지로 바꾸고, 시각·태그·고정·공개 범위를 유지합니다(마이그레이션 가이드).
- 프로토콜로 열기:
/api/v1호환 계층과 폐기 가능한 Personal Access Token, AI 도구를 위한 MCP. 정확한 지원 범위는 호환성 매트릭스에 있습니다.
9. 플러그인 시스템: 카드도 플러그인
- 기본 카드 5장: Plain, Daily, Ticket, Postcard, 그리고 canvas로 그리는 Postmark 데모.
- 스토어와 큐레이션: 설정에서 디렉터리 탐색, 원클릭 설치(SHA-256 검증), 활성화/비활성화, 순서 변경, 기본 카드 지정, 숨기기를 모두 처리합니다. 공식 디렉터리는 flaremo.app/plugins에 있습니다.
- 직접 업로드: 관리자는 로컬 패키지를 설치할 수 있습니다 — 해당 인스턴스에만 존재하며 어디로도 전송되지 않습니다.
- 제작 도구:
pnpm plugin:new로 스캐폴딩하고,pnpm plugin:check는 인스턴스가 설치 시 강제하는 것과 정확히 동일한 규칙으로 검증하며,pnpm plugins:build로 패키징합니다. document 카드는 순수 JSON 레이아웃, sandbox 카드는 직접 작성한 HTML/CSS/JS를 실행합니다. 자세한 내용은 플러그인 가이드를 참조하세요. - 기본이 안전: 카드는 불투명 오리진 샌드박스에서 네트워크 접근 없이 실행됩니다. 커뮤니티/브랜드 팩은 관리자가 켜기 전까지 꺼져 있습니다.
📊 Cloudflare 무료 제공량은 얼마나 넉넉한가?
'무료'는 곧 '극심한 제한'이라고 여기는 경우가 많습니다. 하지만 텍스트 중심의 개인 지식 베이스에는 Cloudflare의 무료 할당량이 사실상 무한대입니다:
| 리소스 | 무료 제공량 | 환산 용량 | 실제 사용 가능 기간 |
|---|---|---|---|
| Cloudflare D1 | 5 GB 데이터베이스 | 텍스트 메모 약 250만 개 | 매일 100개씩 작성해도 채우는 데 68년 소요 |
| Cloudflare R2 | 10 GB 스토리지 | 사진 약 5,000–10,000장 / 음성 80시간 | 아웃바운드 요금 $0; 공개 공유로도 대역폭 청구가 발생하지 않음 |
| Cloudflare Workers | 넉넉한 무료 요청 한도 | 전 세계 300개 이상 엣지 로케이션 | 콜드 부트 없는 전 세계 밀리초 응답 |
🥊 비교: Cloudflare 네이티브 vs 홈 NAS vs 전통적 VPS
| 기준 | Cloudflare 네이티브 (FlareMo) | 홈 NAS / 미니 PC | 전통적 VPS |
|---|---|---|---|
| 데이터 내구성 | 엔터프라이즈급 멀티 리전 복제, 하드웨어 고장 위험 제로 | 단일 디스크 고장이나 정전 한 번으로 데이터 전체 손실 가능 | 수동 스냅샷·백업 루틴에 의존 |
| 유지보수 | 제로: OS 패치도, Docker compose도, DB 관리도 없음 | OS 업데이트, Docker 관리, SMART 디스크 알림, 라우터 설정 | 커널 업그레이드, 보안 패치, 감시 데몬 관리 |
| 접속 지연 | 글로벌 엣지 CDN, 어디서나 100ms 미만 응답 | DDNS / frp / Tailscale 터널 필요, 가정용 회선 업링크에 제약 | 단일 클라우드 리전에 의존, 국경 간 지연 큼 |
| SSL & 도메인 | 자동 HTTPS 및 커스텀 도메인 바인딩 | 수동 인증서 발급, 리버스 프록시 설정 | Nginx / Caddy 설정과 Let's Encrypt 갱신 관리 |
| 비용 | 무료 티어에서 월 $0 | 높은 초기 하드웨어 비용 + 지속적인 전기료 | 매월/매년 청구되는 서버·대역폭 비용 |
🚀 5분 만에 배포하기
방법 1: 원클릭 Cloudflare 배포
저장소를 내 GitHub 계정으로 복제하고 D1, R2, Queues, Vectorize를 자동으로 프로비저닝합니다. 최초 배포 후 FLAREMO_PUBLIC_URL과 시크릿을 설정하세요(docs/en/deploy.md 참조). 첫 시도에서 "Github API Limit Exceeded"가 표시되면 몇 분 기다렸다가 다시 시도하세요.
방법 2: GitHub Action (셀프 호스팅 포크)
포크에서 docs/templates/workflows/deploy-cloudflare.yml을 .github/workflows/에 복사한 뒤 Actions의 Deploy to Cloudflare를 실행하면 리소스 프로비저닝, Worker 배포, 인증 시크릿 동기화가 한 번에 이루어집니다. push만으로는 배포되지 않습니다. docs/en/github-action-deploy.md를 참조하세요.
방법 3: AI 에이전트로 배포 (권장)
터미널 명령을 실행할 수 있는 AI 에이전트(Claude Code, Cursor Agent, Codex 등)에게 저장소와 함께 docs/en/agent-deploy.md를 전달하세요:
"docs/en/agent-deploy.md 문서에 따라 내 Cloudflare 계정에 FlareMo를 배포해 줘."
방법 4: 3단계 수동 배포
1. Cloudflare 리소스 생성
pnpm exec wrangler whoami
pnpm exec wrangler d1 create flaremo
pnpm exec wrangler r2 bucket create flaremo-attachments
또는 pnpm provision:remote를 대신 실행하세요: 누락된 D1 / R2 / Queue / Vectorize 리소스를 생성하고 D1 database_id를 wrangler.jsonc에 대신 기록합니다. 멱등하게 동작하며 기존 리소스는 건너뜁니다.
2. 설정 및 시크릿 구성
cp wrangler.jsonc.example wrangler.jsonc
생성된 database_id를 채우고 FLAREMO_PUBLIC_URL을 프로덕션 도메인으로 설정하세요. 그다음 시크릿을 설정합니다:
pnpm exec wrangler secret put BETTER_AUTH_SECRET --config ./wrangler.jsonc
pnpm exec wrangler secret put FLAREMO_BOOTSTRAP_SECRET --config ./wrangler.jsonc
3. 배포
pnpm deploy:dry-run
pnpm deploy
(전체 pnpm verify 게이트는 유지관리자가 명시적으로 요청할 때만 실행됩니다.)
프로덕션 도메인의 /setup에 접속해 FLAREMO_BOOTSTRAP_SECRET을 입력하고 Owner 계정을 초기화하세요.
상세 가이드: 배포 가이드 · GitHub Action 배포 · 업데이트 가이드.
🧱 아키텍처 & 기술 스택
flowchart LR
Browser["FlareMo Web UI (React 19 / PWA)"] --> Worker["Cloudflare Worker"]
Clients["Scripts / MCP"] --> Worker
Worker --> Auth["Better Auth (Session / PAT)"]
Worker --> D1["Cloudflare D1 (Notes / Relations / Settings)"]
Access["Cloudflare Access (Optional Outer Perimeter)"] -.-> Worker
Worker --> R2["Cloudflare R2 (Attachments & Exports)"]
Worker --> Assets["Workers Static Assets"]
- 런타임: Cloudflare Workers
- 프론트엔드: React 19, Vite, TanStack Router, Tailwind CSS 4, Radix UI
- 데이터베이스: Cloudflare D1, Drizzle ORM
- 스토리지: Cloudflare R2
- 인증: Better Auth (HttpOnly 쿠키 세션 + 폐기 가능한
memos_pat_) - AI & 검색: Workers AI, Vectorize, SQLite FTS5
- 플러그인: 슬롯 기반 확장 플랫폼(표준, 가이드); 패키지는 R2에 저장되며 샌드박스 카드는 네트워크 접근 없이 실행됩니다
🌟 Star History
📄 라이선스
GNU AGPL-3.0 라이선스에 따라 오픈소스로 공개됩니다. Copyright (c) 2026 realchendahuang.




