Eidos Lite turns an ordinary folder into a fast, versioned workspace
powered by open SQLite-based .eidos files.
Important
Eidos Lite is now the primary Eidos product direction and the recommended desktop target for new development and testing. The original Electron application is preserved as Eidos Desktop Legacy for existing users and maintenance. Public Lite distribution is still being prepared; contributors can run and package it today.
Eidos Lite starts with a simple model: a Space is an ordinary folder you own. That folder can contain multiple .eidos files, and every .eidos file is a standard SQLite database that remains useful outside the app.
- Local first — open and edit local data immediately. Version history and cloud status become available progressively and do not define whether your files are usable.
- Open files — inspect
.eidosdatabases with standard SQLite tools, import CSV data, and export your tables when you need them elsewhere. - Built-in versions — review row-aware changes, add a meaningful version note, and restore a Space from local history.
- Optional Sync — connect a Space to the hosted service when you want another copy or another device. Local work remains available when you are offline or signed out.
- Focused desktop experience — Lite is independent from the Legacy app's web server, Markdown, AI, browser, terminal, and extension subsystems.
- Designed for real datasets — paged queries, virtualized tables, bounded change previews, and performance gates cover large SQLite files.
| Product | Status | Best for | Location |
|---|---|---|---|
| Eidos Lite | Primary · active development | Local-first Spaces, .eidos files, versions, and optional Sync |
apps/eidos-lite-desktop |
| Eidos File Web | Active | Opening one .eidos file in a browser |
apps/eidos-file-web · editor.eidos.space |
| Eidos CLI | Active | Inspecting and automating .eidos files from a terminal |
apps/cli |
| Eidos Desktop Legacy | Legacy maintenance | Existing workspaces that depend on documents, AI, extensions, and the original web-app architecture | apps/desktop |
Requirements: Node.js 22.23.1 (pinned in .node-version) and Corepack.
git clone https://github.com/mayneyao/eidos.git
cd eidos
corepack enable
pnpm install --frozen-lockfile
pnpm dev:eidos-liteBuild an unsigned local app for hands-on testing:
pnpm build:eidos-lite:devRun the focused Lite verification suites:
pnpm test:eidos-lite
pnpm test:eidos-lite:performance
pnpm smoke:eidos-lite-packagedSee the Eidos Lite development guide for its process model, security boundaries, Sync architecture, packaging gates, and operational checks.
Working on Eidos Desktop Legacy?
The original Desktop application reuses apps/web-app, runs a local HTTP service, and supports the earlier document, AI, and extension model. It remains in the repository for maintenance, but it is no longer the default desktop path.
pnpm install:sqlite-ext
pnpm dev:desktopRead the Legacy Desktop architecture guide before making changes.
Eidos remains an extensible personal data framework. The repository includes the shared data engine, React bindings, browser editor, CLI, and the Legacy extension ecosystem. Start with the documentation or explore the repository map in AGENTS.md.
This project is licensed under AGPL v3. Specific packages are released under MIT to facilitate integration and ecosystem growth:
All extensions under extensions/ are also released under the MIT License.