---
id: gnureadline
version: "8.3.3"
license: GPL-3.0-or-later
license_treatment: copyleft
maintenance: aging
---

# gnureadline — The standard Python readline extension statically linked against the GNU readline library.

License: copyleft · Maintenance: aging · Downloads: 362.4K/mo

## What it is and what it does

gnureadline bundles the GNU Readline library and compiles it statically into a Python extension module, providing proper readline support on systems like macOS that ship with libedit instead. It solves the problem that libedit, while mostly compatible, is not fully equivalent to GNU Readline, leading to subtle differences in command-line editing behavior and history handling.

The package offers two main use patterns: direct import override (try gnureadline first, fall back to readline) for scripts that need explicit readline control, and a site-customization hook via the override_readline script to fix tab completion in the interactive Python shell itself. It has no runtime dependencies and is available as pre-built wheels for Python 3.10–3.13 on macOS and Linux.

Use it for:

- Fix tab completion in the interactive Python shell on macOS when the default readline is actually libedit.
- Override readline in scripts to ensure GNU Readline behavior across platforms without conditional imports.
- Maintain consistent command history and editing experience in Python REPL across macOS and Linux systems.
- Enable proper readline functionality in virtualenvs or python-build-standalone distributions where libedit is the default.
- Restore readline behavior on Python 3.13+ if the new interactive interpreter's reimplementation causes unexpected differences.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides GNU Readline library support for Python interactive shells and scripts on platforms that ship with libedit instead, enabling proper command-line editing and history.

Yes, but with conditions. Install if you are on macOS or a POSIX system where Python's readline is actually libedit and you need GNU Readline's full feature set. The GPLv3 copyleft license is a blocker for proprietary software. Medium install friction (compiled wheels) is acceptable for most developers. No known vulnerabilities. Maintenance is aging but stable; the package does one thing well and rarely needs updates.

## Install

pip install gnureadline
uv add gnureadline
poetry add gnureadline

## Installing gnureadline

Before you install: Medium install friction due to compiled wheels for specific Python versions and architectures (cp310–cp313, x86_64 and aarch64). Last release 220 days ago; repository active and maintained but aging status suggests infrequent updates.

License in practice: GPL-3.0-or-later copyleft license means any code linking this package must comply with GPLv3 terms. Acceptable for open-source projects and internal use, but problematic for proprietary software distribution.

Quickstart:

pip install gnureadline

# In your script or shell startup:
try:
    import gnureadline as readline
except ImportError:
    import readline

# Or fix the interactive shell:
python -m override_readline

Requires pre-built wheel for your Python version (3.10–3.13) and architecture (x86_64 or aarch64); no source distribution available for other versions.

Verify before relying:

- Whether the package works correctly with Python 3.14 and 3.15 on all listed platforms despite classifier support claims.
- Compatibility with the new Python 3.13 interactive interpreter and whether PYTHON_BASIC_REPL=1 workaround is reliable.

## Package facts

- License: GPL-3.0-or-later (copyleft)
- Python support: unspecified
- Install friction: medium
- Maintenance: aging
- Downloads: 362.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

gnu readline python, readline tab completion, python shell editing, libedit replacement, command line history, interactive python repl, readline, shell-repl, macos-compat

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