Kuku: open source

Product Introduction

1. Definition: Kuku is a high-performance, local-first Markdown editor and AI-native Personal Knowledge Management (PKM) system. Built as an open-source "second brain" for the modern AI era, it functions as a desktop application (specifically optimized for macOS using the Tauri v2 framework) that manages plain text Markdown files while providing sophisticated organizational layers like bidirectional wikilinks, backlink panels, and force-directed graph visualizations.

2. Core Value Proposition: Kuku exists to solve the tension between AI-driven productivity and data sovereignty. Its primary purpose is to turn a local "vault" of notes into a reusable, machine-readable context without requiring users to surrender their data to closed-cloud ecosystems. By leveraging local-first principles, it ensures zero-latency performance and complete portable memory, allowing users to move their knowledge base across different tools and Large Language Models (LLMs) without vendor lock-in.

Main Features

1. Native Local-First Markdown Engine: Unlike many modern note-taking apps that rely on resource-heavy Electron wrappers, Kuku is built using Tauri v2, React 19, and ProseMirror. This technical stack ensures a native-level experience on macOS with significantly lower CPU and RAM overhead. The editor treats plain Markdown files as the "source of truth," meaning your data remains human-readable and accessible via any text editor even if the Kuku application is not running.

2. AI-Assisted Edits with Cursor-Style Diffs: Kuku integrates an AI Agent (currently supporting Google’s Gemini via Bring Your Own Key/BYOK) that can search, read, and edit the note vault. When the AI proposes changes—such as drafting OKRs, summarizing meeting notes, or updating project logs—it presents them as reviewable diffs. This "patching" system allows users to approve or reject specific modifications, mirroring the workflow of modern code editors like Cursor to ensure accuracy and human oversight in the writing process.

3. Bidirectional Linking and Knowledge Graph: The software implements a robust system for knowledge architecture including [[wikilinks]] for instant page creation and backlink tracking to reveal hidden connections between notes. It generates a dynamic, force-directed graph view that visualizes the density and clusters of information within a vault. This allows for non-linear thinking where notes become nodes in a larger, interconnected second brain rather than isolated files in a folder.

4. Local Intelligence and Transcription: Kuku features local speech-to-text capabilities powered by Whisper.cpp. This allows users to transcribe meetings or voice memos directly into their vault without sending audio data to the cloud. Additionally, the system uses local indexing to provide sub-second full-text search results across thousands of files, ensuring that retrieval is as fast as the user's train of thought.

Problems Solved

1. Data Privacy and Cloud Lock-in: Traditional AI note-taking apps often require users to upload their entire knowledge base to proprietary servers, creating a privacy risk and a "walled garden" effect. Kuku solves this by keeping all files local and providing an open-source server for those who wish to self-host their synchronization stack.

2. Fragmented Context for AI: One-off AI chats (like ChatGPT or Claude) lack the context of a user's past work. Kuku solves this by turning the entire Markdown vault into a "context window" for the AI. When you ask the assistant a question, it retrieves relevant notes from your local drive to provide grounded, personalized answers.

3. Target Audience:

• Developers and Software Engineers: Who appreciate the Tauri/React architecture, MIT licensing, and GitHub-centric workflow.
• Knowledge Workers and Researchers: Who need to manage thousands of interconnected documents with complex referencing needs.
• Privacy-Conscious Professionals: Who want the benefits of LLMs without exposing sensitive intellectual property to cloud providers.
• PKM Enthusiasts: Users looking for a faster, more AI-integrated alternative to Obsidian, Roam Research, or Logseq.

4. Use Cases:

• Building a Personal Knowledge Base: Capturing daily journals, reading notes, and technical snippets into a searchable web of information.
• Project and OKR Planning: Using the AI agent to cross-reference past team syncs and architecture docs to draft quarterly goals.
• Automated Meeting Minutes: Transcribing local audio files and using AI to extract action items and link them to existing project notes.

Unique Advantages

1. Performance-Driven Architecture: By choosing SolidJS and pure ProseMirror for its rebuild, Kuku achieves superior stability and speed compared to apps built on legacy web-tech wrappers. This makes it viable for extremely large vaults (100,000+ indexed nodes) where other tools might lag.

2. Open Source MIT License: Kuku’s commitment to "open source everything" (client, server, and infrastructure) differentiates it from "open core" or proprietary competitors. This transparency allows the community to audit the code, contribute plugins, and ensure the tool's longevity.

3. Portable AI Context: Kuku's unique innovation is the "Agent Mode" which treats the vault as a living database. It doesn't just search; it acts on the data, maintaining graph consistency by checking for orphaned nodes and automatically suggesting wikilinks to strengthen the knowledge network.

Frequently Asked Questions (FAQ)

1. Is Kuku a free alternative to Obsidian? Kuku is free for local use and offers a more native, AI-integrated experience than Obsidian. While both use local Markdown files, Kuku is built from the ground up for the AI era, featuring built-in AI diffing and agent capabilities that typically require complex third-party plugins in other apps.

2. How does Kuku handle data synchronization? Kuku offers three sync models: self-hosting the open-source server, using a "Bring Your Own" S3 bucket for encrypted storage, or utilizing the managed kuku.mom Pro service. All sync methods utilize zero-knowledge encryption to ensure that only the user can access their note content.

3. Can I use Kuku without an internet connection? Yes. Kuku is designed with an "offline-first" philosophy. All core editing, searching, wikilinking, and graph visualization functions happen locally on your machine. AI features require an internet connection if using cloud models like Gemini, but the roadmap includes support for fully local LLMs via Ollama.

4. What makes Kuku better than Electron-based note apps? By using Tauri, Kuku communicates directly with the OS's native webview and utilizes Rust for backend tasks. This results in a much smaller application binary, significantly lower memory usage, and a more responsive interface that feels like a true native macOS application.