Skip to content

Install

github-actions[bot] edited this page Sep 26, 2026 · 13 revisions

Install

curl installer (macOS, Linux)

curl -fsSL https://raw.githubusercontent.com/acamarata/findplus/main/install.sh | bash

Installs Find+ into ~/.local/share/findplus/ and links findplus into ~/.local/bin/. Requires Python 3.12, 3.13 or 3.14. Pass --yes to skip the confirmation prompt, or --uninstall to remove it (see Uninstall for what that keeps and what it removes).

~/.local/bin is not on the default PATH on macOS, and on Debian and Ubuntu ~/.profile adds it only if the directory already existed when you logged in. If it is not on yours, the installer says so and prints the line to add; until you add it, ~/.local/bin/findplus works by full path.

On Debian and Ubuntu the venv module ships separately from python3. If it is missing the installer names the exact package to install (sudo apt install python3.12-venv) rather than the Python version.

Re-running the installer upgrades an existing install. If its virtualenv was broken by an OS upgrade or a removed Python, re-running rebuilds it.

pipx

Find+ is not published to PyPI. Install the wheel from the latest release instead. Download the findplus-<version>-py3-none-any.whl from the Releases page (for example, v1.1.2):

pipx install https://github.com/acamarata/findplus/releases/download/v1.1.2/findplus-1.1.2-py3-none-any.whl

Or install from the latest release directly:

gh release download --repo acamarata/findplus --pattern '*.whl' && pipx install findplus-*.whl

pip install with the same URL works inside an existing virtualenv.

Homebrew (macOS)

brew install acamarata/tap/findplus

brew upgrade findplus picks up each new release once the tap formula is updated.

macOS app (dmg)

Download FindPlus-<version>-aarch64.dmg from the Releases page. Open the dmg and drag Find+ to Applications. The app bundles the daemon, so no separate CLI install is required.

The app is built for Apple Silicon only. On an Intel Mac, install with Homebrew or the curl installer above and open the dashboard in your browser at http://127.0.0.1:8647.

Post-install

Run findplus setup for a guided walkthrough (or findplus auth then findplus start for the two-command path), then continue with First run.

To remove Find+ later, see Uninstall.


Home

Clone this wiki locally