The Open Source Note-Taking App for People Who Own Their Data
Local-first. Privacy-focused. Blazing fast.
Website · Documentation · Changelog
Most note-taking apps fall into two categories: powerful but closed-source (Obsidian) or open but cloud-dependent (Notion). Lokus is neither.
- Truly Open Source — BSL 1.1 licensed. Read every line. Fork it. Make it yours.
- Local-First — Your notes are markdown files on YOUR device. No proprietary format.
- Fast — Built with Tauri & Rust. ~50MB RAM vs 300MB+ for Electron apps.
- No Subscription — Free forever. No $10/month sync tax.
|
|
|
|
|
macOS Download .dmg Intel & Apple Silicon |
Windows Download .exe Windows 10/11 x64 |
Linux Download .AppImage .deb and .rpm also available |
# Or build from source
git clone https://github.com/lokus-ai/lokus.git
cd lokus && npm install && npm run tauri build1. Download and install Lokus
2. Create a new workspace (or open existing markdown folder)
3. Start writing
Coming from Obsidian? Just point Lokus at your vault. It works with your existing notes.
| Layer | Technology |
|---|---|
| Frontend | React 19, TipTap 3, Tailwind CSS, Vite 7 |
| Backend | Rust, Tauri 2.0, Tokio |
| Editor | TipTap (ProseMirror), KaTeX, Shiki |
| Canvas | TLDraw |
| Graph | Three.js, D3-force |
| Testing | Vitest, Playwright |
- Node.js 18+
- Rust (via rustup)
- Platform-specific dependencies (see docs)
# Clone the repository
git clone https://github.com/lokus-ai/lokus.git
cd lokus
# Install dependencies
npm install
# Start development server
npm run tauri dev
# Run tests
npm testlokus/
├── src/ # React frontend
│ ├── components/ # UI components
│ ├── core/ # Core functionality
│ ├── editor/ # TipTap editor
│ └── views/ # Main views
├── src-tauri/ # Rust backend
│ └── src/ # Tauri commands
├── tests/ # Test suites
└── docs/ # Documentation
- Rich markdown editor
- Wiki links & graph view
- Canvas & database views
- Template system
- Plugin marketplace
- MCP server integration
- P2P sync (Iroh)
- Mobile apps (iOS & Android)
- Collaborative editing
- End-to-end encryption
- Calendar view for databases
We welcome contributions of all kinds:
- Bug reports — Open an issue
- Feature requests — Start a discussion
- Code contributions — Fork, code, submit PR
- Documentation — Help us improve the docs
See CONTRIBUTING.md for guidelines.
- GitHub Discussions — Questions & ideas
- Discord — Real-time chat
- Twitter — Updates & news
If you find Lokus useful, consider:
- Starring this repository
- Sponsoring on Open Collective
- Spreading the word
Lokus is licensed under the Business Source License 1.1.
- Free for personal use — Always
- Free for small teams — Under 10 users
- Enterprise licensing — Contact us for larger deployments
The license converts to MIT after 4 years.
Download Lokus · Read the Docs · Join Discord
Built with care by the Lokus team and contributors.