---
id: pyfzf
version: "0.3.1"
license: MIT
license_treatment: permissive
maintenance: dormant
---

# pyfzf — Python wrapper for junegunn's fuzzyfinder (fzf)

License: permissive · Maintenance: dormant · Downloads: 420.5K/mo

## 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 above — 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

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

- License: MIT (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: dormant
- Downloads: 420.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

fuzzy finder python wrapper, interactive list selection, fzf python binding, command-line fuzzy search, terminal selection prompt, cli-tool, interactive-selection

[View on SkillFed](https://skillfed.io/packages/pyfzf) · [View on PyPI](https://pypi.org/project/pyfzf/)