Skip to content

zero-gate-org/Knowte

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

57 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Knowte

Knowte Logo

Transform lecture audio into structured learning materials β€” completely private, fully offline.

Knowte is a desktop application that turns lecture recordings into structured notes, interactive quizzes, flashcards, mind maps, and related research papers. All processing happens locally on your machine using Ollama for LLM inference and Whisper for transcription. No data ever leaves your device.


Demo

Knowte Demo

Features

  • πŸŽ™οΈ Audio & Video Input β€” Upload audio/video files or record directly from your microphone. Supports MP3, WAV, M4A, OGG, WebM, MP4, MKV, and more.
  • πŸ“Ί YouTube Import β€” Paste a YouTube URL and Knowte downloads and transcribes the audio using yt-dlp.
  • πŸ“ Transcription β€” Local speech-to-text using Whisper.cpp with model sizes from tiny (~75 MB) to large (~3 GB).
  • πŸ“– Structured Notes β€” LLM-generated notes organised into topics, key points, examples, key terms, and takeaways.
  • βœ… Interactive Quiz β€” Auto-generated multiple choice, true/false, and short-answer questions with explanations and score tracking.
  • πŸƒ Flashcards β€” Anki-style flashcards with card-flip animations, three-pile study mode, and Anki .apkg / .txt export.
  • 🧠 Mind Map β€” Visual tree of lecture concepts using React Flow, with PNG and SVG export.
  • πŸ”¬ Research Papers β€” Related academic papers via the Semantic Scholar API (optional, requires internet).
  • πŸ’‘ Explain This β€” Select any text and get a contextual AI explanation, with "simpler" / "deeper" controls.
  • πŸ“š Lecture Library β€” Persistent SQLite-backed history of all lectures with full-text search.
  • πŸ”’ 100% Local & Private β€” No cloud API calls (except the optional Semantic Scholar paper search). Audio and transcripts never leave your machine.

Prerequisites

1. Ollama

Ollama runs language models locally. Download and install it from ollama.ai, then pull a model:

# Recommended β€” good balance of quality and speed (~4.7 GB)
ollama pull llama3.1:8b

# Lightweight option (~2.3 GB)
ollama pull phi3:mini

Verify it's running:

curl http://localhost:11434/api/tags

2. ffmpeg

Knowte bundles platform-specific ffmpeg and yt-dlp binaries. For development see CONTRIBUTING.md.


Quick Start

  1. Install prerequisites (Ollama + a model β€” see above)
  2. Download Knowte from the Releases page and install it
  3. On first launch, the setup wizard guides you through:
    • Verifying Ollama is running
    • Choosing a language model
    • Downloading a Whisper transcription model
    • Setting your academic level for personalised outputs
  4. Upload a lecture β€” drag and drop an audio/video file, or paste a YouTube URL
  5. Click "Process Knowte" β€” Knowte transcribes and generates all materials automatically

Building from Source

Requirements

Tool Version Install
Rust stable curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
Bun β‰₯ 1.0 curl -fsSL https://bun.sh/install | bash
Tauri CLI v2 included in devDependencies
Ollama any ollama.ai

Development

git clone https://github.com/GxAditya/Knowte.git
cd knowte
bun install
bun run tauri dev

Production Build

npx tsc --noEmit       # Type-check
bun run tauri build    # Build installer

Build artefacts are in src-tauri/target/release/bundle/:

Platform Formats
Linux .deb, .AppImage, .rpm
macOS .dmg
Windows .msi, .exe (NSIS)

Tech Stack

Tauri Rust React TypeScript Tailwind CSS Zustand React Router Vite Bun
SQLite whisper.cpp Ollama React Flow yt-dlp ffmpeg

Data & Privacy

All user data β€” audio files, transcripts, notes, quizzes, flashcards β€” lives in SQLite in the platform app data directory:

Platform Path
Linux ~/.local/share/com.knowte.app/
macOS ~/Library/Application Support/com.knowte.app/
Windows %APPDATA%\com.knowte.app\

The only optional external network call is to Semantic Scholar for related paper search (disable in Settings β†’ Research).


License

GPL 3.0 License β€” see LICENSE for details.


Contributing

See CONTRIBUTING.md for details.