{"id":5798,"library":"pyfzf","title":"pyfzf - Python FZF Wrapper","description":"pyfzf is a Python wrapper for junegunn's fuzzyfinder (fzf), enabling Python applications to leverage fzf's interactive filtering capabilities directly from Python. The library is actively maintained, with its latest version 0.3.1 released in March 2022, and typically sees updates for feature enhancements and platform compatibility.","status":"active","version":"0.3.1","language":"en","source_language":"en","source_url":"https://github.com/nk412/pyfzf","tags":["fuzzy-finder","cli","terminal","utility","fzf"],"install":[{"cmd":"pip install pyfzf","lang":"bash","label":"Install stable version"}],"dependencies":[{"reason":"pyfzf is a wrapper around the fzf command-line tool, which must be installed and available in your system's PATH.","package":"fzf","optional":false}],"imports":[{"symbol":"FzfPrompt","correct":"from pyfzf.pyfzf import FzfPrompt"}],"quickstart":{"code":"from pyfzf.pyfzf import FzfPrompt\n\nfzf = FzfPrompt()\noptions = ['apple', 'banana', 'cherry', 'date']\nselected_items = fzf.prompt(options, '--multi')\n\nif selected_items:\n    print(f\"You selected: {', '.join(selected_items)}\")\nelse:\n    print(\"No item selected.\")","lang":"python","description":"Initializes FzfPrompt and displays a list of options using fzf, allowing for multi-selection. The selected items are returned as a list. You can pass additional fzf command-line arguments as a second argument to the `prompt` method."},"warnings":[{"fix":"Ensure your environment uses Python 3.6 or newer.","message":"pyfzf officially requires Python 3.6+. Older versions (prior to 0.2.1) might have supported Python 2, but modern usage expects Python 3.6+.","severity":"breaking","affected_versions":"<0.2.1"},{"fix":"If `plumbum` functionality is still needed, install it explicitly (`pip install plumbum`) or refactor your code to use standard Python `subprocess` module.","message":"The `plumbum` dependency was removed in version 0.3.0. If your application indirectly relied on `plumbum` through pyfzf, it will no longer be available.","severity":"breaking","affected_versions":"<0.3.0"},{"fix":"Install fzf (e.g., `brew install fzf` on macOS, `sudo apt install fzf` on Debian/Ubuntu) or initialize `FzfPrompt('/path/to/fzf')`.","message":"The `fzf` binary (junegunn's fuzzy-finder) must be installed on your system and accessible via the system PATH. pyfzf is a wrapper and does not bundle the fzf executable itself. If not found, `FzfPrompt` can be initialized with the full path to the `fzf` binary.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Upgrade to pyfzf 0.3.1 or newer: `pip install --upgrade pyfzf`.","message":"Unicode support on Windows was improved significantly in version 0.3.1. Users on Windows experiencing issues with non-ASCII characters should upgrade.","severity":"gotcha","affected_versions":"<0.3.1"}],"env_vars":null,"last_verified":"2026-04-14T00:00:00.000Z","next_check":"2026-07-13T00:00:00.000Z"}