Skip to content
Projects

madebyzan/knovum has 56 GitHub stars and 6 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 06:36 UTC. Last push 2026-11-13.

How these counts are measured

What you can do

  • Bring everything into one place. Collect notes, webpages, videos, recordings, PDFs, Office files, images, and code in a Space.
  • See how ideas connect. Arrange material on an infinite canvas, connect claims with evidence, and keep related questions and decisions close to their sources.
  • Ask questions and check the answer. Search by keyword or meaning, ask a connected AI model about your material, and follow citations back to the exact source location.
  • Create from what you know. Turn selected material into documents, images, videos, subtitles, or voice output, with a record of the inputs and model used.

Measured star growth

in 24h
0
in 7 days
Collecting history
in 15 days
Collecting history
in 1 month
Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

Local-first desktop AI workspace for research, learning, and creation. Organize your materials, ask questions with source-linked answers, and keep your knowledge on your device.

AI

README.md

Original
Knovum — a local-first AI knowledge workspace

Bring your knowledge together. Make it useful.
A local-first AI workspace for research, learning, and creation.

Latest release Quality CI GitHub stars macOS 14 or later, Apple Silicon and Intel Windows 10 version 2004 or later, x64 License: MIT

Download Knovum · What you can do · Privacy · FAQ · Build from source · 简体中文

What is Knovum?

Knovum is a local-first desktop workspace for gathering, exploring, and creating with your own knowledge.

Bring your notes, saved webpages and videos, meeting recordings, PDFs, Office documents, images, and code into one visual space. Organize them on an infinite canvas, discover connections, search across your library, and ask questions with answers that link back to the source passage, page, or timestamp.

Turn the material you have collected into documents and media without losing the trail back to the sources behind them.

Your library lives on your machine. There is no Knovum account or Knovum cloud. Search, transcription, OCR, and other supported AI capabilities can run locally; when you choose a cloud model for an answer or generation task, Knovum sends only the context needed for that task to the provider you selected.

Knovum desktop app showing sources, claims, evidence and a brief connected on an infinite canvas, alongside an answer with source citations.

What you can do

  • Bring everything into one place. Collect notes, webpages, videos, recordings, PDFs, Office files, images, and code in a Space.
  • See how ideas connect. Arrange material on an infinite canvas, connect claims with evidence, and keep related questions and decisions close to their sources.
  • Ask questions and check the answer. Search by keyword or meaning, ask a connected AI model about your material, and follow citations back to the exact source location.
  • Create from what you know. Turn selected material into documents, images, videos, subtitles, or voice output, with a record of the inputs and model used.
  • Keep control of your data and AI. Store your library locally, use supported on-device capabilities, and choose the model provider or compatible desktop Agent for each task.

How it works

A knowledge workflow: collect sources, connect ideas, ask questions, and create work you can trace back to its sources. From scattered sources to connected knowledge and work you can trace.
  1. Collect. Paste a link to save a webpage or a YouTube, Bilibili, TikTok, or Vimeo video. Add recordings, PDFs, Office files, images, code, and notes. Recordings can be transcribed locally with timestamps and speaker labels.
  2. Organize. Arrange material in sections and groups. Add claims, evidence, questions, and decisions as knowledge objects, then connect them with meaningful relationships.
  3. Explore. Search one Space or your whole library by keyword or meaning. Ask questions about your sources and follow each citation to its original location.
  4. Create. Select the material you need and create a document, image, video, or voice track. Export your work while keeping a record of the sources and revisions behind it.

Explore the features

Spaces: one canvas for all kinds of material

Rich notes, Markdown, webpages, PDFs, Office documents, images, audio, video, code, and ordinary files share one infinite canvas. Organize content with sections, groups, tags, and Saved Views; navigate with an outline; and undo the last 100 edits. A system Inbox gives new material a place to land before you organize it.

Knovum supports the open JSON Canvas format (.canvas) for exchanging canvases with compatible tools. You can also move a complete Space — including its content, assets, relations, derivations, and citations — as a portable .knovumspace package.

Ask questions and follow the sources

Ask questions about your own material with a connected model. Answers cite the passages they rely on, and each citation keeps its location in the source: a page in a PDF, a time range in a recording, or a heading in a note.

Citations are tied to the source revision they quote. When a source changes, a citation can become detached instead of silently pointing to content that has moved. A PDF citation opens the original in the built-in reader at the relevant page, with the passage highlighted.

Find information across your library

Hybrid keyword and vector search runs on your machine using Qwen3 embeddings and LanceDB. Search within one Space or across all Spaces, and find related material by meaning as well as exact terms.

Connect ideas into structured knowledge

Use six built-in knowledge object types — Concept, Question, Claim, Evidence, Experiment, and Decision — or create your own. Connect them with relationships such as supports, contradicts, answers, depends on, supersedes, and derives from.

Knowledge checks can surface unsupported or contested claims, evidence without grounding, answered questions, and notes whose sources have changed. You can use as much or as little structure as your work needs.

Create from selection, with a record of where it came from

Turn a selection into a new resource without losing its context. Create documents, generate images or videos, remove backgrounds, split image layers, or add subtitles. Each run records the engine, model, inputs, and input revisions, so you can trace a result back to the material used to create it.

Work with documents, media, and voice

  • Editors: Rich notes and Markdown with tables, images, find and replace, and inline citations.
  • Export: Notes and captures to DOCX, PDF, PPTX, HTML, Markdown, and TXT; image and audio conversion.
  • Video workbench: An absolute-time timeline, proxy playback, and burned-in subtitles.
  • Speech studio: Audiobooks with roles and a pronunciation lexicon, narration, dubbing, vocal/accompaniment separation, voice cloning, and voice design.
  • System-wide dictation: Hold a global shortcut, speak, and release. Whisper transcribes locally and inserts the text into the app currently in front.

Connect compatible AI agents

Knovum includes a Builtin Agent that can plan with todos, research your Space read-only, and make changes through validated, atomic change sets. You can also use desktop Agents already installed on your machine through the Agent Client Protocol (ACP), with their own sign-in and tools.

Knovum exposes your Space to compatible desktop Agents through a loopback-only MCP server, and can connect outbound MCP servers as Agent extensions. Skills, plugins, connectors, and apps can be managed in one place.

Local-first by design

Your knowledge library is stored on your device: Spaces, files, extracted text, search indexes, and backups stay in local application data. Knovum does not require an account and does not run a Knovum cloud service.

The distinction between local and cloud AI is explicit:

  • Local by default for supported capabilities. Editing, keyword and semantic search, transcription, speaker recognition, OCR, speech synthesis, and the listed image tools run on your machine after their models are downloaded.
  • Your choice for answers and generation. Connect a provider you already use, run a compatible local endpoint, or hand a task to a desktop Agent.
  • Only the task context is sent to a cloud provider. When you choose a cloud model, the action sends the selection and context it needs to the provider you chose. Provider-side handling is governed by that provider's terms and settings.

Model files are downloaded only when a feature needs them, verified against pinned SHA-256 digests, and can be removed from Settings. Download progress and cancellation are available in the Task Center.

Use your own AI provider

Canvas editing, keyword and semantic search, transcription, and the on-device capabilities below work without an AI account.

For AI answers and generation, connect a provider you already use:

OpenAI · Anthropic · Google Gemini · DeepSeek · Qwen · Zhipu · Moonshot · Doubao · MiniMax · StepFun · SiliconFlow · Mistral · Groq · Grok · Together · OpenRouter · Kling · Ollama · any OpenAI-compatible endpoint

You can also hand a task to a desktop Agent that brings its own credentials. Keys are stored in a dedicated local secrets database and are never written to logs.

Download and get started

Platform Requirement Installer
macOS macOS 14 or later, Apple Silicon Knovum_<version>_aarch64.dmg
macOS macOS 14 or later, Intel Knovum_<version>_x64.dmg
Windows Windows 10 version 2004 or later, x64 Knovum_<version>_x64-setup.exe

Download the latest release

Builds are not yet notarized by Apple or Authenticode-signed, so macOS and Windows ask you to confirm the first launch. Updates after that are delivered in the app and verified against the release signature. Linux and Windows on ARM are not supported yet.

A simple way to start: create a Space, add two or three sources you are already working with, and write down one question you want to answer. Add an AI connection in Settings when you want AI-generated answers or content.

FAQ

Does Knovum work offline?

Yes. Editing, organizing, keyword and semantic search, transcription, speaker recognition, OCR, speech synthesis, and the listed image tools run on your machine once their models are downloaded. Only actions you send to a cloud model need an internet connection.

Where is my data stored? Does anything get uploaded?

Your library is stored in local application data: SQLite keeps the structure, LanceDB stores the semantic index, and managed files store assets. A separate local database stores secrets. Content is not uploaded to a Knovum cloud. When you ask a cloud model to perform an action, only the context needed for that action is sent to the provider you selected.

Do I need an AI account to use Knovum?

No account is needed to use Knovum or its local editing, organization, search, transcription, OCR, and other listed on-device capabilities. AI answers and generation require a model connection, which can be a cloud provider or a compatible local endpoint.

How is Knovum different from NotebookLM, Obsidian Canvas, or Heptabase?

Knovum brings source-grounded AI answers, a visual canvas for thinking, and structured knowledge into one local-first desktop workspace. It also works with audio and video, supports on-device AI capabilities, and keeps track of the sources and revisions behind generated results.

Can I use local models with Ollama?

Yes. Ollama and any OpenAI-compatible endpoint can be connected as a model for answers and the Builtin Agent. The on-device capabilities listed below do not need Ollama or another model server.

What should I do if local model downloads fail or time out?

On-device capabilities such as OCR, Whisper transcription, and image processing download their model weights on first use. If your network has restricted access to huggingface.co, configure the standard HF_ENDPOINT environment variable to use a mirror, for example https://hf-mirror.com.

  • Windows: Set a persistent user environment variable. Press Win + R, enter sysdm.cpl, then open Advanced → Environment Variables. Add HF_ENDPOINT with the value https://hf-mirror.com. Alternatively, run setx HF_ENDPOINT "https://hf-mirror.com" in Command Prompt and restart Knovum.
  • macOS / Linux: Add the following to your shell configuration, such as ~/.zshrc or ~/.bashrc:
echo 'export HF_ENDPOINT="https://hf-mirror.com"' >> ~/.zshrc
source ~/.zshrc

Downloaded model files are verified against pinned SHA-256 digests.

Can I bring in my existing notes and canvases?

Import Markdown, documents, and media files directly. Import and export canvases through the open JSON Canvas format (.canvas). A complete Space can also be exported as a portable .knovumspace package.

Is Knovum open source and free?

Yes. Knovum is free and open-source software under the MIT License. You can use, read, build, modify, and distribute it under the terms of the license.

On-device AI capabilities

The following capabilities run locally. Models are downloaded on first use, verified against pinned SHA-256 digests, and can be removed from Settings.

Capability Model Runtime
Speech transcription Whisper (default) / Qwen3-ASR 1.7B + Silero VAD whisper.cpp / audio.cpp
Speaker diarization Pyannote 3.0 + ERes2Net sherpa-onnx
Vocal / accompaniment separation HTDemucs audio.cpp
Speech synthesis, voice cloning & design MOSS-TTS-Nano, VoxCPM2, IndexTTS2, Qwen3-TTS, Fun-CosyVoice3 audio.cpp
Word-level transcript alignment Qwen3 Forced Aligner audio.cpp
Semantic-search embeddings Qwen3-Embedding-0.6B Candle
Background removal BiRefNet, BEN2, IS-Net Anime ONNX Runtime
Image upscaling Real-ESRGAN ONNX Runtime
Inpainting / repair Big LaMa ONNX Runtime
Smart selection MobileSAM, SAM 2.1 Hiera-Tiny ONNX Runtime
Relative depth Depth Anything V2 ONNX Runtime
Text recognition (scans, screenshots) PP-OCRv6 small ONNX Runtime

Embeddings and transcription use Metal on Apple Silicon. None of the capabilities above requires Ollama or another model server.

Build from source

You need Node.js 22.13+ with Corepack, the Rust toolchain pinned in rust-toolchain.toml, and the native tooling used by the desktop build: uv, CMake, Protobuf, and LLVM/libclang. See docs/installation.md for exact versions.

git clone https://github.com/madebyzan/knovum.git
cd knovum
corepack enable
pnpm install --frozen-lockfile
pnpm desktop:dev

The first build compiles the native inference worker and takes longer; later starts are faster.

Command Purpose
pnpm desktop:dev Run the desktop app with the Agent environment prepared
pnpm check Full quality gate: web, Rust, and Python
pnpm check:web Typecheck, oxlint, dependency-cruiser, Vitest, knip, jscpd, and oxfmt
pnpm check:rust cargo fmt, clippy (-D warnings), and workspace tests
pnpm check:python ruff, mypy (strict), and pytest for the Agent runtime
pnpm e2e WebdriverIO end-to-end run against a debug build
pnpm package Build desktop bundles for the current platform

CI runs these checks on macOS (Apple Silicon and Intel) and Windows. Pushing a v* tag builds the macOS and Windows packages into a draft GitHub Release.

Architecture

A Rust core owns data, inference, and OS integration; a Vue 3 renderer owns interaction; generated contracts connect the two. Local models run in a separate inference worker, and the Builtin Agent runs in a bundled Python runtime.

Tauri 2 · Rust · Vue 3 · TypeScript · SQLite (sqlx) · LanceDB · Candle · ONNX Runtime · whisper.cpp · Konva · Tailwind CSS v4

Read more in docs/system-architecture.md, the documentation map, and the product design contract in DESIGN.md.

Contributing

Bug reports, focused feature proposals, translations, and documentation fixes are welcome. See CONTRIBUTING.md and the Code of Conduct.

When opening an issue, include your platform, Knovum version, and steps to reproduce. Remove credentials from logs. Report security issues privately as described in SECURITY.md.

If Knovum is useful to you, a ⭐ helps other people find it.

License

Knovum is released under the MIT License. Third-party components retain their own licenses.

Star history