Error Translator

PyPI Version Python 3.9+ GitHub Stars PyPI Downloads License Build Status

Error Translator CLI V2 demo banner


Error Translator is an offline Python traceback translator and exception explainer that converts raw errors into crystal-clear explanations and immediately actionable fixes. Built for local-first development workflows, it supports direct CLI usage, an automatic import hook, a programmatic Python API, and a FastAPI integration.

If this project saves you debugging time, please consider starring it on GitHub: https://github.com/gourabanandad/error-translator-cli-v2

Why Developers Like It

  • Fast Feedback Loop: Turn stack traces into direct next actions in seconds.
  • Works Offline: No telemetry dependency for core translation behavior.
  • Beginner-Friendly Output: Explanations are clear enough for learners, practical enough for teams.
  • Multiple Entry Points: CLI, import hook, Python API, and FastAPI all share one deterministic engine.

Features & Usage

Error Translator is packed with features designed for a seamless debugging experience, including:

  • CLI-First Architecture with a rich terminal UI.
  • Automatic Integration Mode via import hooks.
  • Jupyter Notebook Integration for interactive debugging.
  • FastAPI Service for remote translation.
  • Deterministic Rules Engine with optional C extension acceleration.

For a comprehensive list of features and detailed usage instructions for all integration modes, please check our Features & Usage Guide.

Installation

Python requirement: 3.9 or newer.

Install the latest stable release directly from PyPI:

pip install error-translator-cli-v2

Verify the installation:

explain-error --version

Documentation

Detailed documentation is located in the docs/ directory:

  • Features & Usage Guide: Comprehensive list of features, and usage instructions across various platforms.
  • Real-World Examples: Practical demonstrations comparing raw tracebacks with their translated counterparts.
  • Architecture & Internals: Comprehensive teardown of the regex engine, AST integration, and internal design philosophy.
  • Contributing Guidelines: Standards, PR checklists, and instructions for utilizing our AI-Powered Rule Builder.

Maintainers

This project is actively developed and maintained by Gourabananda Datta alongside our open-source contributors.

Project links

Data verified by PyPI on Sep 1, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (3.1.4)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for gourabanandad from gravatar.com gourabanandad

Credits

PyPI data
Data sourced directly from PyPI's database.

Author: Gourabananda Datta

License

MIT License (MIT)

Requires

Python >=3.9

Provides Extra

server docs dev jupyter

Tags

python python error translator traceback translator python traceback analyzer python exception explainer error explainer error handling debugging developer tools stack-trace cli terminal offline fastapi human-readable

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

error_translator_cli_v2-3.1.3.tar.gz (51.3 kB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

error_translator_cli_v2-3.1.3-cp313-cp313-win_amd64.whl (52.4 kB view details)

Uploaded CPython 3.13Windows x86-64

error_translator_cli_v2-3.1.3-cp313-cp313-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl (57.3 kB view details)

Uploaded CPython 3.13manylinux: glibc 2.17+ x86-64manylinux: glibc 2.5+ x86-64

error_translator_cli_v2-3.1.3-cp313-cp313-macosx_11_0_arm64.whl (50.5 kB view details)

Uploaded CPython 3.13macOS 11.0+ ARM64

error_translator_cli_v2-3.1.3-cp313-cp313-macosx_10_13_x86_64.whl (50.1 kB view details)

Uploaded CPython 3.13macOS 10.13+ x86-64

error_translator_cli_v2-3.1.3-cp312-cp312-win_amd64.whl (52.4 kB view details)

Uploaded CPython 3.12Windows x86-64

error_translator_cli_v2-3.1.3-cp312-cp312-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl (57.3 kB view details)

Uploaded CPython 3.12manylinux: glibc 2.17+ x86-64manylinux: glibc 2.5+ x86-64

error_translator_cli_v2-3.1.3-cp312-cp312-macosx_11_0_arm64.whl (50.5 kB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

error_translator_cli_v2-3.1.3-cp312-cp312-macosx_10_13_x86_64.whl (50.0 kB view details)

Uploaded CPython 3.12macOS 10.13+ x86-64

error_translator_cli_v2-3.1.3-cp311-cp311-win_amd64.whl (52.3 kB view details)

Uploaded CPython 3.11Windows x86-64

error_translator_cli_v2-3.1.3-cp311-cp311-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl (57.2 kB view details)

Uploaded CPython 3.11manylinux: glibc 2.17+ x86-64manylinux: glibc 2.5+ x86-64

error_translator_cli_v2-3.1.3-cp311-cp311-macosx_11_0_arm64.whl (50.5 kB view details)

Uploaded CPython 3.11macOS 11.0+ ARM64

error_translator_cli_v2-3.1.3-cp311-cp311-macosx_10_9_x86_64.whl (50.0 kB view details)

Uploaded CPython 3.11macOS 10.9+ x86-64

error_translator_cli_v2-3.1.3-cp310-cp310-win_amd64.whl (52.3 kB view details)

Uploaded CPython 3.10Windows x86-64

error_translator_cli_v2-3.1.3-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl (57.1 kB view details)

Uploaded CPython 3.10manylinux: glibc 2.17+ x86-64manylinux: glibc 2.5+ x86-64

error_translator_cli_v2-3.1.3-cp310-cp310-macosx_11_0_arm64.whl (50.5 kB view details)

Uploaded CPython 3.10macOS 11.0+ ARM64

error_translator_cli_v2-3.1.3-cp310-cp310-macosx_10_9_x86_64.whl (50.0 kB view details)

Uploaded CPython 3.10macOS 10.9+ x86-64

error_translator_cli_v2-3.1.3-cp39-cp39-win_amd64.whl (52.3 kB view details)

Uploaded CPython 3.9Windows x86-64

error_translator_cli_v2-3.1.3-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl (56.9 kB view details)

Uploaded CPython 3.9manylinux: glibc 2.17+ x86-64manylinux: glibc 2.5+ x86-64

error_translator_cli_v2-3.1.3-cp39-cp39-macosx_11_0_arm64.whl (50.5 kB view details)

Uploaded CPython 3.9macOS 11.0+ ARM64

error_translator_cli_v2-3.1.3-cp39-cp39-macosx_10_9_x86_64.whl (50.0 kB view details)

Uploaded CPython 3.9macOS 10.9+ x86-64

File details

Details for the file error_translator_cli_v2-3.1.3.tar.gz.

File metadata

  • Download URL: error_translator_cli_v2-3.1.3.tar.gz
  • Upload date:
  • Size: 51.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for error_translator_cli_v2-3.1.3.tar.gz
Algorithm Hash digest
SHA256 4a0b0495e5499fbc1639dfc656907a3bc1e6034de0481a777f7d5432952dc46c
MD5 235988852886edf6fe2c01ac25e47eff
BLAKE2b-256 39cfd74914811827a8e125a6714a660236e5bab60f03b496545c8e0524bdadd9

See more details on using hashes here.

File details

Details for the file error_translator_cli_v2-3.1.3-cp313-cp313-win_amd64.whl.

File metadata

File hashes

Hashes for error_translator_cli_v2-3.1.3-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 069941a7aadc8f7d801ad3d6c2f008aff6f22706f566f2d278cf317bbba57945
MD5 1822c3e46e4846a6c4bb1fe4d2c9491d
BLAKE2b-256 ea2685f5eb86d4ced0707dd92d0fae80819fa34c04a1d4fc20c71d7bbdf9b7f9

See more details on using hashes here.

File details

Details for the file error_translator_cli_v2-3.1.3-cp313-cp313-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for error_translator_cli_v2-3.1.3-cp313-cp313-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 f2c91d4d13216452d7cc3afc3a8d79247fa58a39f08dd76871be3d604f282932
MD5 25cda533bda6406ac8199b4c3cf952a7
BLAKE2b-256 8f7bb44311d233ca86f4f998d9a7bdc17d61dd6933715d53e75ed9189dcc79de

See more details on using hashes here.

File details

Details for the file error_translator_cli_v2-3.1.3-cp313-cp313-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for error_translator_cli_v2-3.1.3-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 6833e9510c28a94678660568802343c743f5d72e750eea9b2ae777528602880e
MD5 ca5613cfbcf601e3ee10f986441c99da
BLAKE2b-256 fe7fb64e16d718d31aed65df1c933b8b05e9ac9755424af946393da02dfcac1d

See more details on using hashes here.

File details

Details for the file error_translator_cli_v2-3.1.3-cp313-cp313-macosx_10_13_x86_64.whl.

File metadata

File hashes

Hashes for error_translator_cli_v2-3.1.3-cp313-cp313-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 8ea4189d3e2fae5af17db788cea5436f1676a80c46d61743862ac897e19a2638
MD5 c08c72296bd772d0f4cf0cbbfc013887
BLAKE2b-256 b3f3a751768576fefc8b224c1f91bb1ae536b6c47c6201af4347a59d83ed0be3

See more details on using hashes here.

File details

Details for the file error_translator_cli_v2-3.1.3-cp312-cp312-win_amd64.whl.

File metadata

File hashes

Hashes for error_translator_cli_v2-3.1.3-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 834e5659771a1937dffeb0ec87a4bd295a21ab34a2356b8c024e41762b6deb1c
MD5 45d9b00ab11a1d3638d8dff029a6527c
BLAKE2b-256 a85210ab84a02a27a3f32207c6d95657aa8231459a41cd1675dd1f744140d822

See more details on using hashes here.

File details

Details for the file error_translator_cli_v2-3.1.3-cp312-cp312-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for error_translator_cli_v2-3.1.3-cp312-cp312-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 f7939aed7f5f6a331c4a5cce65116699b21421f16f95c48fc6ca9a0d71cd55d2
MD5 6e2be97e0e6593a81d8b58416c2e1693
BLAKE2b-256 377bcad8ec4b53e7de2f6cb3dda1944b9f63f195918aab7899edfa69a7ca3cd9

See more details on using hashes here.

File details

Details for the file error_translator_cli_v2-3.1.3-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for error_translator_cli_v2-3.1.3-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 38e1f4a5b71defc4e9da270e07a8908dd47d9456a1b7e10da71d5d2a8f4be255
MD5 8eb6c38f104e9cc5d52cea7ae3796c43
BLAKE2b-256 59b8f9c602cb01029ec867684af8766b51ffd9986959cfaeda9808628a1392b6

See more details on using hashes here.

File details

Details for the file error_translator_cli_v2-3.1.3-cp312-cp312-macosx_10_13_x86_64.whl.

File metadata

File hashes

Hashes for error_translator_cli_v2-3.1.3-cp312-cp312-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 d0cc8b59e8f6d6e537ef14630af8d775da32a1f695a832e46f84050513c97219
MD5 632f93024470b57d6db2687c7db33aa4
BLAKE2b-256 41a7897a5ac7ea00c2684f94b974dd0e36d1de0b5ad4ff8f310186eed8f410bf

See more details on using hashes here.

File details

Details for the file error_translator_cli_v2-3.1.3-cp311-cp311-win_amd64.whl.

File metadata

File hashes

Hashes for error_translator_cli_v2-3.1.3-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 51c0e30fef50ab1284e46ed71cebbbc4f97c4dc4f00be4e31a4b611351cd0d25
MD5 74c4fc368723b09e4189f0b796de8c21
BLAKE2b-256 84c7ef44f93dcc7ba1388f2a79f86356631921f0631e65f127062fd130101a30

See more details on using hashes here.

File details

Details for the file error_translator_cli_v2-3.1.3-cp311-cp311-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for error_translator_cli_v2-3.1.3-cp311-cp311-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 4cd6df84bea26ccd8d72cbd183934870b32ea4fe2e527ad11f620ad23ae5434f
MD5 08972216b5ef2ab079fcdefdd57b55cb
BLAKE2b-256 c1e459702c709292d061758a8824d6e6b5669b18f8180087abe3c3de2e1a3674

See more details on using hashes here.

File details

Details for the file error_translator_cli_v2-3.1.3-cp311-cp311-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for error_translator_cli_v2-3.1.3-cp311-cp311-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 e5026eae002fa2b2992a44eeb377e0e29601b2a69ebf57953d4abca131d68a30
MD5 e62d8c379ad51ada4d174c920b7cdb2e
BLAKE2b-256 83d2ba62ef042d1949ca7e27a497e0c4966870b42a0e0eccd8a67ef171c85887

See more details on using hashes here.

File details

Details for the file error_translator_cli_v2-3.1.3-cp311-cp311-macosx_10_9_x86_64.whl.

File metadata

File hashes

Hashes for error_translator_cli_v2-3.1.3-cp311-cp311-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 379016a3b277c92d7e980adf14806de2bfc15fb0ca7a5bd625e674475bed4b19
MD5 6e4616c2fe3cd35fc5e7d8eb0546ee47
BLAKE2b-256 e3b82e42d6c827dfb5d7662bad4def309e131d6f99fb4e7a479f7d63950d8ca9

See more details on using hashes here.

File details

Details for the file error_translator_cli_v2-3.1.3-cp310-cp310-win_amd64.whl.

File metadata

File hashes

Hashes for error_translator_cli_v2-3.1.3-cp310-cp310-win_amd64.whl
Algorithm Hash digest
SHA256 35d5e064dd781d9e0d9f7cc14c1def209fc45ba2eeefb78704ca7c046f309604
MD5 8ff24ce6726ab9cd55dbb065019f026a
BLAKE2b-256 1e42478b8a4a2084b7f88373c7ac14fec38fc9651c354c27e7723f4f6e2642fb

See more details on using hashes here.

File details

Details for the file error_translator_cli_v2-3.1.3-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for error_translator_cli_v2-3.1.3-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 bb2d42c71b58a21b464523707f401ddbed70178f425cef42d989659b7d86fd32
MD5 72c835a660399e2532d0009e6fb558ba
BLAKE2b-256 723bbf22f4a9779af35f6ce91e7ccf07f450467b7c78be8b06cb8166e87d7095

See more details on using hashes here.

File details

Details for the file error_translator_cli_v2-3.1.3-cp310-cp310-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for error_translator_cli_v2-3.1.3-cp310-cp310-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 22c87722c357c340c692d32500acf31bb71caa9d18782e326b6272e728073ed3
MD5 a75b189727a3f27d3858a42a4163bf50
BLAKE2b-256 322c39763463fd0f40c0d0881f2eea5226a6ecdcaa47415404efddfb5a939430

See more details on using hashes here.

File details

Details for the file error_translator_cli_v2-3.1.3-cp310-cp310-macosx_10_9_x86_64.whl.

File metadata

File hashes

Hashes for error_translator_cli_v2-3.1.3-cp310-cp310-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 b72377801107b74881372edb4792635d0e2cfec450c82a9682a800bf4d74ee93
MD5 211416f7202c672c0b0c6249c223af50
BLAKE2b-256 f879dcb79fa35b0c0e3642f117828c84f46a35dee31c6f8171cca5b33b1e2eea

See more details on using hashes here.

File details

Details for the file error_translator_cli_v2-3.1.3-cp39-cp39-win_amd64.whl.

File metadata

File hashes

Hashes for error_translator_cli_v2-3.1.3-cp39-cp39-win_amd64.whl
Algorithm Hash digest
SHA256 41f30176b37d5878a7d865e3d2d3de65ea96bdcf724b01699e63f6e6986731c0
MD5 c1f032fe926398cb5ecb4939a8853554
BLAKE2b-256 4279a9c772d1c7f1341da4a523a5cdb4defb235be56f5d5ccbc2b219777b98e3

See more details on using hashes here.

File details

Details for the file error_translator_cli_v2-3.1.3-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for error_translator_cli_v2-3.1.3-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 3b71fa9bcece8b75eabeff15ad54ba280923cc9e17118ac8832c42765c6ddcdd
MD5 2df455160730b22391271287f93abda1
BLAKE2b-256 daabe6448a1e8aeb33a9f19c7c7c81f264e7725cb7faa92f23c58fd83df2d97d

See more details on using hashes here.

File details

Details for the file error_translator_cli_v2-3.1.3-cp39-cp39-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for error_translator_cli_v2-3.1.3-cp39-cp39-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 0e0ef77b776280ca17c41676edf1f09307fc806a88292bdb7179c6b2539baf0c
MD5 4f79b4c774be39e209f9772dd9007a03
BLAKE2b-256 dacf090b9989bd1de8b430b7e619b539097f194d8078feab349d200649f37755

See more details on using hashes here.

File details

Details for the file error_translator_cli_v2-3.1.3-cp39-cp39-macosx_10_9_x86_64.whl.

File metadata

File hashes

Hashes for error_translator_cli_v2-3.1.3-cp39-cp39-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 dd531f2388fb5f60ec2bf1634ccb86d07337ebc7667fd06fc332662f5215ff36
MD5 26f1e6bc7ce4c5a6e6ee29bd27d9eec6
BLAKE2b-256 bf8ac4a0ff26c22b39b57e8b2cd478fc000b55e965781ba942d12e01e718797f

See more details on using hashes here.

Release history Release notifications | RSS feed

3.1.4

21 files

This release

3.1.3 This release

21 files

3.1.0

21 files

3.0.6

21 files

3.0.5

21 files

Pre-release

3.0.4.dev5

21 files

3.0.2

1 file

2.0.0

2 files

1.1.5

2 files

1.1.4

2 files

1.1.3

2 files

1.1.2

2 files

1.1.1

2 files

1.1.0

2 files

1.0.9

2 files

1.0.8

2 files

1.0.7

2 files

1.0.6

2 files

1.0.5

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page