selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

FlareMo logo

Self-host FlareMo

v0.22.2

Cloudflare-native knowledge base with Memos API

ReleaseOpen SourceAGPL-3.0
Updated4 days ago
LanguageTypescript
Setup difficultyModerate
MobilePWA
ThemeDark mode
Stars
328
Requires
Cloudflare D1, Cloudflare Queues, Cloudflare R2, Cloudflare Vectorize
Install with Cloudflare Workers
FlareMo desktop light mode showing the timeline and note capture interfaceFlareMo desktop dark mode showing the same interface in dark themeFlareMo mobile responsive view showing the timeline on a phone screen

What is FlareMo?

FlareMo runs entirely on Cloudflare's edge network — Workers for compute, D1 for data, R2 for files — so there are no servers to manage. It offers a Memos-compatible API, AI long-term memory through MCP endpoints, projects with kanban boards, an offline-first PWA you can install on any device, a plugin system with sandboxed cards, and team workspaces with role-based access and three visibility levels. Deployment takes minutes on a free Cloudflare account. The free tier gives 5 GB D1 (roughly 2.5 million text notes) and 10 GB R2 (about 10,000 photos) with zero egress fees.

Should you self-host FlareMo?

FlareMo scores 51/100 on selfhost.directory (how scoring works) and ranks #19 of 42 in Knowledge Management. It has 328 GitHub stars.

It shipped 10 stable releases in the past year. The latest, v0.22.2, came out on 23 October 2026. New versions land roughly every 3 days.

Setup is moderate: expect some configuration beyond a single command. It is AGPL-3.0-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is Project N.O.M.A.D. (85/100, 41 107 stars). It scores higher overall, so compare the two before you pick. See FlareMo vs Project N.O.M.A.D. side by side.

Features

  • AI long-term memory (MCP)
  • Better Auth security
  • Bi-directional import/export
  • Daily review and random walk
  • Full-text search (FTS5)
  • Memos-compatible API
  • Plugin system (cards)
  • Project and task management
  • Reader seats
  • Revision History
  • Semantic vector search
  • Team collaboration with roles
  • Voice capture (ASR)
  • Web push notifications

FlareMo README

How to install FlareMo

Install FlareMo with Cloudflare Workers

Free Cloudflare account
Environment variables
FLAREMO_PUBLIC_URL, BETTER_AUTH_SECRET, FLAREMO_BOOTSTRAP_SECRET (as Worker secrets)

Deploy to Cloudflare

Clones the repository into your GitHub account and provisions D1, R2, Queues, and Vectorize automatically. After the initial deploy, set FLAREMO_PUBLIC_URL and secrets (see docs/en/deploy.md).

Community-supported button flow; first attempt may fail with "Github API Limit Exceeded" — wait and retry.

How to configure FlareMo

  • BETTER_AUTH_SECRETBetter Auth secret for session encryption (set as Worker secret, not in wrangler.jsonc).

    Better Auth secret for session encryption (set as Worker secret, not in wrangler.jsonc).

  • FLAREMO_ASR_MINIMAX_BASE_URLOptional MiniMax batch ASR base URL (defaults to mainland China site).

    Optional MiniMax batch ASR base URL (defaults to mainland China site).

  • FLAREMO_ASR_MODELASR model to use (blank uses provider default).

    ASR model to use (blank uses provider default).

  • FLAREMO_ASR_PROVIDERdashscopeOptional voice capture provider: `dashscope` or `tencent`. Blank uses provider default.

    Optional voice capture provider: `dashscope` or `tencent`. Blank uses provider default.

    values: dashscope, tencent

  • FLAREMO_ASR_TENCENT_APP_IDTencent ASR app ID.

    Tencent ASR app ID.

  • FLAREMO_ASR_TENCENT_HOTWORD_IDOptional Tencent accuracy hint (console vocabulary ID).

    Optional Tencent accuracy hint (console vocabulary ID).

  • FLAREMO_BOOTSTRAP_SECRETOne-time bootstrap secret for initializing the Owner account at /setup (set as Worker secret).

    One-time bootstrap secret for initializing the Owner account at /setup (set as Worker secret).

  • FLAREMO_EMBEDDING_DIMENSIONS1024Embedding dimensions for the vector index.

    Embedding dimensions for the vector index.

  • FLAREMO_EMBEDDING_MODEL@cf/qwen/qwen3-embedding-0.6bEmbedding model to use when provider is workers-ai or http.

    Embedding model to use when provider is workers-ai or http.

  • FLAREMO_EMBEDDING_PROVIDERworkers-aiSemantic-search embedding provider: `workers-ai` (Cloudflare's model), `http` (external REST), or `none` (disables semantic search, falls back to FTS5).

    Semantic-search embedding provider: `workers-ai` (Cloudflare's model), `http` (external REST), or `none` (disables semantic search, falls back to FTS5).

    values: workers-ai, http, none

  • FLAREMO_MEMO_FILTER_SCAN_LIMIT5000CEL memo filters that cannot fully translate to SQL scan up to this many candidate rows in JS (D1 read quota).

    CEL memo filters that cannot fully translate to SQL scan up to this many candidate rows in JS (D1 read quota).

  • FLAREMO_PUBLIC_URLCanonical origin used by Better Auth for callback and cookie checks. Set this to your public origin; keep secrets out of this file.

    Canonical origin used by Better Auth for callback and cookie checks. Set this to your public origin; keep secrets out of this file.

  • FLAREMO_SINGLE_USER_EMAILowner@flaremo.localEmail for the single-user bootstrap owner account.

    Email for the single-user bootstrap owner account.

  • FLAREMO_SINGLE_USER_NAMEFlareMo OwnerDisplay name for the single-user bootstrap owner account.

    Display name for the single-user bootstrap owner account.

  • FLAREMO_TRUSTED_ORIGINSOptional comma-separated additional browser origins for trusted clients.

    Optional comma-separated additional browser origins for trusted clients.

  • FLAREMO_VAPID_PRIVATE_KEYOptional Web Push private key for reminders. Omitting either disables push.

    Optional Web Push private key for reminders. Omitting either disables push.

  • FLAREMO_VAPID_PUBLIC_KEYOptional Web Push public key for reminders (daily review, overdue tasks). Generate with `npx web-push generate-vapid-keys`.

    Optional Web Push public key for reminders (daily review, overdue tasks). Generate with `npx web-push generate-vapid-keys`.

  • FLAREMO_VECTORIZE_QUERIED_LIMIT30000000Self-measured vector usage limit for queried dimensions per month (default: Workers Free Vectorize allowance).

    Self-measured vector usage limit for queried dimensions per month (default: Workers Free Vectorize allowance).

  • FLAREMO_VECTORIZE_STORED_LIMIT5000000Self-measured vector usage limit for stored dimensions per month (default: Workers Free Vectorize allowance).

    Self-measured vector usage limit for stored dimensions per month (default: Workers Free Vectorize allowance).

FlareMo releases & version history

FAQ

How does single-user differ from team mode?

By default, it is a quiet single-user sanctuary. When team mode is enabled, admins invite members via one-time activation links. Memos can be private, team-visible, or public.

Do third-party apps and scripts still work?

Yes, FlareMo implements the Memos /api/v1 endpoint surface and personal access tokens (PAT). Popular iOS/Android clients like Moe Memos connect directly.

Can I migrate from Memos or flomo?

Yes, FlareMo imports ZIP or JSON export bundles from Memos and flomo, preserving timestamps, tags, and content while allowing custom conflict resolution.

How safe is my data?

Data is stored on Cloudflare's enterprise-grade distributed infrastructure with multi-region replication. FlareMo also supports one-click exports to standard Memos bundles for regular offline archiving.

Is the free tier really enough?

Yes, Cloudflare's free tier provides 5GB D1 database (~2.5 million text memos) and 10GB R2 storage (~10,000 compressed photos). Writing 100 memos daily would take 68 years to fill.

More in Knowledge Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…