pyfzf

What it is and what it does

pyfzf is a thin Python wrapper around fzf, the command-line fuzzy finder. It lets you call fzf from Python code to present an interactive selection dialog to users, passing in a list of items and getting back the user's choice. The wrapper handles writing items to a temporary file, invoking the fzf binary, and parsing the result.

The package has no Python runtime dependencies—it only requires that fzf itself be installed and available on your system PATH (or you can specify a custom path). It's designed for console applications and terminal-based workflows where you want to let users interactively pick from a list rather than typing or passing arguments.

Use it for:

• Build a CLI tool that lets users interactively select from a list of files, branches, or options
• Add fuzzy search to a Python script that needs user input in an interactive terminal session
• Create a system administration or DevOps tool that presents filtered choices to operators
• Implement fuzzy filtering in a terminal-based menu or configuration utility

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

pyfzf wraps the fzf command-line fuzzy finder, letting you invoke interactive selection dialogs from Python code by passing lists of items to a prompt function.

Yes, if you need interactive fuzzy selection in a terminal application and fzf is already part of your environment. The package is lightweight, has no Python dependencies, and works as advertised for its narrow purpose. The dormant maintenance status is not a blocker—the code is simple and stable—but verify compatibility with your Python version and fzf version before relying on it in production.

Install

pyfzf on PyPI

pip install pyfzf

uv add pyfzf

poetry add pyfzf

Installing pyfzf

Before you install

Low install friction—a pure Python wheel with no runtime dependencies. Maintenance is dormant; the last release was 2022-03-01, though the repository remains active and the package is stable for its narrow scope.

License in practice

MIT license is permissive; you can use this package freely in commercial and private projects with minimal restrictions.

Quickstart

pip install pyfzf

from pyfzf.pyfzf import FzfPrompt
fzf = FzfPrompt()
selected = fzf.prompt(range(0, 10))

fzf must be installed and available on PATH, or you must pass its location explicitly to FzfPrompt().

Verify before relying

• Whether the package works correctly with modern Python versions beyond 3.6, given the time since last release
• Current compatibility with recent fzf versions and whether Windows support remains functional

Package facts

Evidence: pyfzf-0.3.1-py3-none-any.whl

Tags

More Terminals packages