Skip to content

filippostanghellini/DocFinder

Repository files navigation

DocFinder

CI CodeQL License: AGPL v3 Python Release Downloads

DocFinder Logo

Local-first semantic search for your PDF documents.
Everything runs on your machine — no cloud, no accounts, complete privacy.

Search Index

Features

  • Semantic search — find documents by meaning, not just keywords
  • 100% local — your files never leave your machine
  • GPU accelerated — auto-detects Apple Silicon (Metal), NVIDIA (CUDA), AMD (ROCm)
  • Cross-platform — native apps for macOS, Windows, and Linux
  • Global shortcut — bring DocFinder to front from anywhere with a configurable hotkey

Download

Platform Installer
macOS DocFinder-macOS.dmg
Windows DocFinder-Windows-Setup.exe
Linux DocFinder-Linux-x86_64.AppImage

macOS — open the DMG, drag DocFinder to Applications, then right-click → Open on first launch (Gatekeeper warning — normal for unsigned open-source apps).

Windows — run the installer; if SmartScreen appears choose More info → Run anyway.

Linux

chmod +x DocFinder-Linux-x86_64.AppImage && ./DocFinder-Linux-x86_64.AppImage

Run from Source

Requires Python 3.10+ and make.

git clone https://github.com/filippostanghellini/DocFinder.git
cd DocFinder
make setup   # create .venv and install all dependencies
make run     # desktop GUI
make run-web # web interface at http://127.0.0.1:8000

Contributing

Contributions are welcome, feel free to open an issue or submit a pull request.

License

Licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).

DocFinder was originally released under the MIT License. Starting from version 1.1.1 the license was changed to AGPL-3.0 to comply with the PyMuPDF licensing requirements, as PyMuPDF itself is AGPL-3.0 licensed.

About

DocFinder is a local-first indexing and searching PDF documents using semantic embeddings stored in SQLite. Everything runs on your machine, no external services required.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors