This project is being split into 3 separate projects:

  • friendly_traceback,

  • friendly, and

  • friendly_idle.

The documentation does not reflect this change.

If you are a end-user, just install friendly until further notice.

Other repl

Most REPL handle tracebacks in their own ways. When that is the case, friendly cannot be “installed”. If you still wish to use friendly, you can start its console within a given REPL, using:

>>> from friendly import start_console
>>> start_console()

Future work


Determine if there would be interest in integrating friendly with ptpython. This might perhaps be done by monkey-patching _handle_exception or by having ptpython’s developer enable custom sys.excepthook.