Why Local-First Architecture Matters: Building Lifelong Intellectual Assets

“Cloud-first” has become the default architecture for reading and note-taking apps: your documents are in the cloud, your highlights are in the cloud, and your reading analytics are in the cloud. While this delivers convenience, it incurs an under-discussed cost: your intellectual labor no longer truly belongs to you.

Reading data carries an intimate privacy profile. Unlike public status updates, it directly mirrors your internal cognitive process: raw skepticism toward authority, tentative hypotheses, and cross-disciplinary connections. Entrusting them to centralized cloud vendors exposes your mental models to third-party scraping, AI training pipelines, or total loss upon service shutdown.

Yomitomo takes a fundamentally different path: Local-First Architecture.

Local-First Architecture & Data Flow

Component	User Input & Operations	System Internal Processing	Storage & Output	Security & Data Boundaries
Document Library	Import EPUB, PDF, or capture web articles	Local parsing, cleaning, and persistence	Local SQLite relational database	Zero proxy servers; no centralized telemetry collecting reading text
Annotations & Threads	Highlights (`A`), thoughts, discussion threads	Physical anchor binding; categorization; full-text indexing	Local structured graph and instant search index	Fully functional offline without internet access
AI Model Credentials	BYOK API Keys (OpenAI / Claude / DeepSeek / Ollama)	Encrypted storage via OS Keyring (macOS Keychain / Windows Credential Manager)	Local SQLite stores only provider metadata & key handles	Direct HTTPS requests from desktop client to model endpoints
Distillation & Backup	Aggregate highlights into Markdown cards	One-click standard SQLite database cold backup & Markdown exports	Local `.sqlite` file and standard `.md` documents	Standard open formats; zero proprietary binary lock-in

Four Core Pillars of Local-First Reading

1. Data Sovereignty: 100% Stored Locally on Your Machine

All your documents, highlights, thoughts, AI debate histories, distillation articles, and reading statistics live inside your local application directory:

No registration or login required: Start reading immediately upon download without tying to any account system;
Zero forced obsolescence: Immune to external terms-of-service changes, pricing hikes, or server shutdowns;
Zero surveillance: No telemetry tracking your reading speed, habits, or intellectual leanings.

2. Hardware-Level Credential Protection: OS Keyring Integration

Yomitomo supports Bring Your Own Key (BYOK) for any OpenAI-compatible provider or local engine. Your keys are never stored in plaintext config files.

macOS: Written directly into Keychain;
Windows: Written directly into Credential Manager.

Even if your database file is copied, plaintext API keys cannot be extracted. All AI requests connect directly to official endpoints without intermediaries.

3. True Offline Autonomy: Network as an Enhancement, Not a Requirement

While cloud apps fail or show blank screens offline, Yomitomo’s core engine—parsing, PDF/EPUB rendering, multi-tier annotations, discussion logs, and distillation drafting—works flawlessly with no network connection. When paired with local Ollama models, you can perform private AI-assisted deep reading during flights or in secure environments.

4. Open Standards: Zero Format Lock-In

Your notes are saved in standard SQLite relational tables and clean Markdown. If you ever choose to leave Yomitomo, you can extract every highlight, thought, and distillation card with any standard SQL viewer or file manager.

Target Audience & Usage Boundaries

Who This Is For

Academics, legal professionals, analysts, engineers, and privacy-conscious thinkers handling sensitive or proprietary texts;
Rational software users weary of SaaS lock-in, recurring subscriptions, and platform shutdowns;
Readers who frequently study in offline environments (commutes, flights, offline research labs);
Advanced users who maintain personal API keys or local Ollama / vLLM instances.

What This Is Not For

Real-time multi-user collaborative editing: Yomitomo is engineered for personal deep thinking, not multi-seat live co-editing;
Pre-packaged bundled cloud AI subscriptions: Yomitomo does not resell compute credits; users configure their own API keys or local models.

Frequently Asked Questions (FAQ)

Q1: Does local-first mean I cannot sync between my laptop and desktop?

Answer: Yomitomo provides one-click database export and import under Settings > General. You can place the exported .sqlite backup into your trusted private cloud storage (e.g., iCloud Drive, Dropbox, Syncthing) to migrate seamlessly between devices.

Q2: Can Yomitomo developers access my OpenAI or DeepSeek API Keys?

Answer: Never. Yomitomo is a pure desktop client without intermediate proxy servers. API keys are stored in your OS Keyring, and all API calls are made directly from your computer to model endpoints over HTTPS.

Q3: What happens to my reading history if Yomitomo ceases development?

Answer: Your data remains completely accessible and functional forever. Because data resides in a standard local SQLite database, you can open and export it anytime using standard database tools.