Thanks to visit codestin.com
Credit goes to github.com

Skip to content

lokus-ai/lokus

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
Lokus

Lokus

The Open Source Note-Taking App for People Who Own Their Data

Local-first. Privacy-focused. Blazing fast.

Website · Documentation · Changelog


GitHub Stars License Release Downloads



Why Lokus?

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.

Features

Editor

  • Rich text with live markdown preview
  • Wiki links with [[autocomplete]]
  • LaTeX math rendering (KaTeX)
  • 100+ language syntax highlighting
  • Tables with resize & sort
  • Task lists with 18 states
  • Smart paste (HTML → Markdown)

Organization

  • Graph view (2D & 3D)
  • Infinite canvas (TLDraw)
  • Database views (Notion-style)
  • Template system (90+ features)
  • Daily notes
  • Full-text search
  • Tags & folders

Integration

  • MCP server for AI assistants
  • Plugin marketplace
  • Theme customization
  • Keyboard-first design
  • 40+ slash commands

Privacy

  • Zero telemetry
  • No account required
  • Works 100% offline
  • Standard markdown files
  • P2P sync (coming soon)

Installation

macOS
macOS
Download .dmg
Intel & Apple Silicon

Windows
Download .exe
Windows 10/11 x64
Linux
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 build

Quick Start

1. 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.


Tech Stack

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

Development

Prerequisites

  • Node.js 18+
  • Rust (via rustup)
  • Platform-specific dependencies (see docs)

Setup

# 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 test

Project Structure

lokus/
├── 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

Roadmap

Current (v1.0.0-beta)

  • Rich markdown editor
  • Wiki links & graph view
  • Canvas & database views
  • Template system
  • Plugin marketplace
  • MCP server integration

Next

  • P2P sync (Iroh)
  • Mobile apps (iOS & Android)
  • Collaborative editing
  • End-to-end encryption
  • Calendar view for databases

Contributing

We welcome contributions of all kinds:

  • Bug reportsOpen an issue
  • Feature requestsStart a discussion
  • Code contributions — Fork, code, submit PR
  • Documentation — Help us improve the docs

See CONTRIBUTING.md for guidelines.


Community


Support

If you find Lokus useful, consider:


License

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.