Its goal is to provide all the niceties of modern GUI-based debuggers in a more lightweight and keyboard-friendly package. PuDB allows you to debug code right where you write and test it–in a terminal.
Here are some screenshots:
Light theme
Dark theme
You may watch screencasts too:
Features
Syntax-highlighted source, the stack, breakpoints and variables are all visible at once and continuously updated. This helps you be more aware of what’s going on in your program. Variable displays can be expanded, collapsed and have various customization options.
Pre-bundled themes, including dark themes via “Ctrl-P”. Could set a custom theme also.
Simple, keyboard-based navigation using single keystrokes makes debugging quick and easy. PuDB understands cursor-keys and Vi shortcuts for navigation. Other keys are inspired by the corresponding pdb commands.
Use search to find relevant source code, or use “m” to invoke the module browser that shows loaded modules, lets you load new ones and reload existing ones.
Breakpoints can be set just by pointing at a source line and hitting “b” and then edited visually in the breakpoints window. Or hit “t” to run to the line under the cursor.
Drop to a Python shell in the current environment by pressing “!”. Or open a command prompt alongside the source-code via “Ctrl-X”.
PuDB places special emphasis on exception handling. A post-mortem mode makes it easy to retrace a crashing program’s last steps.
Ability to control the debugger from a separate terminal.
IPython integration (see wiki)
Should work with Python 3.6 and newer. (Versions 2019.2 and older continue to support Python 2.7.)
Links
PuDB also has a mailing list that you may use to submit patches and requests for help. You can also send a pull request to the GitHub repository
Development Version
You may obtain the development version using the Git version control tool.:
git clone https://github.com/inducer/pudb.git
You may also browse the code online.
1 maintainer
Release files for pudb 2025.1.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pudb-2025.1.5.tar.gz | 225.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pudb-2025.1.5-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 318.4 kB
Release files / pudb-2025.1.5.tar.gz
| Download URL | pudb-2025.1.5.tar.gz |
|---|---|
| Size | 225.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e6dedb81fc3c8cdcd66cf62e86337cb913570ebb2c994c9ab52012d059e086ad
|
|
BLAKE2b-256 checksum How to use checksums |
f5690c52c6058da586e173e48ef8f9c45bc805d9df78d5ad4d69467ff68694b5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Dec 6, 2025.
Transparency logRelease files / pudb-2025.1.5-py3-none-any.whl
| Download URL | pudb-2025.1.5-py3-none-any.whl |
|---|---|
| Size | 92.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e40c69f102d534cc7b86020c0217e3d424ee81b14a229d068ac122089c301f59
|
|
BLAKE2b-256 checksum How to use checksums |
b6af42f4877e71728dd59ed7080205f29eba16406f5783c29cdc850200138c80
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Dec 6, 2025.
Transparency log
