vinoSearch

Filename search finds signing-keys.md when you remember it's called that. vinoSearch finds it when you remember what it says. It also finds IMG_2041.jpg from "dog watching the sunset", because it reads the pixels, not the name.

• Text and images, searched from one box. Markdown and plain text, plus photos, documents and source code when you turn them on. Code is searched apart, with code: in front of the query.
• On the NPU. Indexing runs at ~28.6 chunks/s and 3% of one core, so it doesn't fight you for the CPU. A warm query takes 26 ms (p50).
• Where you already search. KRunner and GNOME Shell's overview. A CLI too.
• Stays current. inotify picks up changes within seconds, and an hourly check catches anything it missed.
• Private. The only network calls download the model and the runtime, and each model file is checked against a pinned SHA-256.

Requirements

• Linux with an Intel NPU (Core Ultra or newer) and the NPU driver. No NPU (AMD, older Intel)? install.sh runs it on the CPU, just slower; --device CPU does the same explicitly.
• KDE Plasma or GNOME on Wayland. Sway, Hyprland, COSMIC and other Wayland desktops work through vinosearch menu and a dmenu-style launcher (fuzzel, wofi, rofi, tofi or bemenu). The settings window is Wayland only.
• Rust, a C compiler and OpenSSL's headers, only to build from source.

Install

curl -fsSL https://github.com/karanshukla/vinoSearch/releases/latest/download/install.sh | bash -s -- --index ~/Documents

That downloads the latest release, checks it against its .sha256, installs the prebuilt binaries into ~/.local/bin (x86_64, glibc 2.39 or newer), fetches OpenVINO and the 340 MB model, indexes the folders you name (--index is repeatable, or it asks), and registers vinoSearch with the running desktop's search (KRunner on Plasma, GNOME Shell on GNOME) as a service started at login. No sudo: everything goes in your home. If something is missing (the NPU driver, say), it stops with one line saying what.

To upgrade, use Check for updates on the settings window's About page, or run vinosearch-upgrade (a release tag like vinosearch-upgrade v6 installs that one). It skips whatever is already done and restarts the service.

curl -fsSL https://github.com/karanshukla/vinoSearch/releases/latest/download/install.sh | bash -s -- --uninstall removes the service, the KRunner and GNOME files and the binaries, and deletes the models and their compiled cache. Your index and settings stay; add --purge to also delete the index and the OpenVINO runtime. To delete only the models, use Delete… on the settings window's Model page, or vinosearch delete-model.

Needs Rust and a C compiler. The same script builds the binaries with cargo into ~/.cargo/bin when run from a checkout, and git pull then a re-run upgrades:

git clone https://github.com/karanshukla/vinoSearch && cd vinoSearch
scripts/install.sh --index ~/Documents

Or step by step:

cargo install --path .                     # vinosearch into ~/.cargo/bin
cargo install --path crates/settings       # vinosearch-settings, the settings window (optional)
cargo install ovfetch                      # 0.6.0 or newer
scripts/install-runtime.sh                 # OpenVINO via ovfetch
vinosearch fetch-model                     # 340 MB, every file checked against a pinned SHA-256
vinosearch estimate ~/Development          # how long indexing would take, and which subfolders take longest
vinosearch index ~/Documents ~/Development # once per root; unchanged files are skipped on re-runs
vinosearch krunner --install               # the service (started now and at login), the app menu entry and the running desktop's search
vinosearch integrate gnome                 # or kde: add the other desktop's search; --off removes one

vinosearch doctor checks the NPU, driver and runtime, then compiles and runs a probe model.

The release download runs on x86_64 with glibc 2.39 or newer: Fedora 40+, Ubuntu 24.04+, Debian 13, Arch, openSUSE Tumbleweed, and the image-based Fedora Atomic (Silverblue, Kinoite, Bazzite) and openSUSE Aeon. On anything older (Debian 12, Ubuntu 22.04, openSUSE Leap 15) install.sh says so; build from source there.

Building needs Rust 1.95 or newer, which Debian's and Ubuntu's packaged Rust isn't, so get it from rustup. The C compiler and OpenSSL's headers (SQLCipher links the system's libcrypto) are sudo dnf install gcc openssl-devel on Fedora, sudo apt install build-essential libssl-dev on Debian and Ubuntu, sudo pacman -S --needed base-devel openssl on Arch and sudo zypper install gcc libopenssl-devel on openSUSE.

Image-based systems. Everything goes in your home: binaries in ~/.local/bin, the runtime, model and index under ~/.local, the service's autostart entry in ~/.config/autostart. Nothing touches /usr, so the release download needs no layering or reboot. The NPU driver is the one system package; layer it (rpm-ostree install on Fedora Atomic, transactional-update pkg install on Aeon) or use an image that ships it. To build from source instead, run install.sh inside a toolbox or distrobox whose release matches the host: the home directory is shared, so the host runs the same binaries and index. /var/home and a /home symlink are both fine; indexed paths are resolved to the real one.

여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗