Guide · EmbeddingGemma 2

How DigUp uses EmbeddingGemma 2 for on-device multimodal search

Photos, PDF pages, documents, audio windows, video frames, and optional code share one ranking space. DigUp embeds them with Google DeepMind’s EmbeddingGemma 2 through llama.cpp on your machine. Based on DigUp (MIT). Not affiliated. DigUp is not Google-official.

One query · many modalitiesWindows search UI: results sidebar grouped by VIDEO / IMAGES / AUDIO / DOCUMENTS, preview pane for content match — still from DigUp demo.gif.
Still from DigUp demo.gif (MIT) — VIDEO / IMAGES / AUDIO / DOCUMENTS together.

Sourced snapshot (2026-10-15)

FactValueSource
EmbeddingGemma 2~740M params · unified 768-d multimodal space · Apache 2.0 weightsGoogle AI docs
DigUp package~865 MB Q8 GGUF (~310 MB text + ~555 MB mmproj)DigUp README / ModelFiles
Runtimellama.cpp · Metal (Mac) · CPU/Vulkan (Win/Linux)DigUp README
VersionsMac 0.6.1 · Win/Linux 0.7.0-beta.1GitHub Releases
Stars~3,768 · forks ~254GitHub API

Pipeline DigUp documents

StageWhat happensWhere it runs
1. Folders you chooseReaders turn files into pictures, text, soundYour disk only
2. EmbeddingGemma 2llama.cpp helper embeds chunks; quits when doneOn-device GPU/CPU
3. SQLite indexVector per image/page/passage/frame/30s audio + keywordsApplication Support / XDG
4. Your queryText tower embeds words → nearest vectors + exact-word boostMilliseconds on device

Modality checklist

ModalityDigUp behavior (README)Try querying
ImagesBy what they show; Mac screenshot OCR for text“dog on the beach”
PDFsPage by page; scans included; first 30 pages fast“clause about pets in the lease”
Docstxt/md/rtf/docx/odt/html (+ Mac .doc)Concept phrases
AudioOverlapping ~30s windows“where they talk about sleep”
VideoFrames every few seconds + soundtrack“zebra in a video”
Code (opt-in)code: prefix; separate indexcode: retry with backoff

Numbered setup

  1. Download DigUp: Mac DMG, Windows, or Linux .deb / AppImage.
  2. Launch and finish EmbeddingGemma 2 (~865 MB). If Hugging Face is blocked, Settings → Storage → Use Files… (#25).
  3. Pick folders. DigUp never downloads cloud-only files.
  4. Read the first-pass time estimate from the local speed check.
  5. Hotkey: ⇧⌘Space (Mac) or Ctrl+Shift+Space (Win/Linux). Describe meaning.
  6. Optional: enable code search; query with code:.
  7. If results stay empty: 0 files indexed. If fans roar: battery & hours.

FAQ-style cause → fix

CauseFix
Model download stuckUse Files… with the two GGUFs DigUp checksums — FAQ
Cloud placeholdersDownload Now in Finder/Explorer first
Code never appearsEnable code folders + code: prefix (#21)
CPU-only photo crawl slow (Win/Linux)Expected; check speed.log for gpu vs cpu — beta guide

Role playbooks

Same model, different jobs — browse DigUp use cases by role (developers, clerks, accountants, students, lawyers, and more).