Error Translator
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.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file error_translator_cli_v2-3.1.0.tar.gz.
File metadata
- Download URL: error_translator_cli_v2-3.1.0.tar.gz
- Upload date:
- Size: 49.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e4277787916804ed6ac42a3ef55d3ce7d9ee86160a8730c375b92641a2f35c12
|
|
| MD5 |
1e9cd1e38cc5227b5139d3e9053e2a62
|
|
| BLAKE2b-256 |
6b3e77474a2cbd21632005d11441708ea642310dbb02f903db05d43bf3680484
|
File details
Details for the file error_translator_cli_v2-3.1.0-cp313-cp313-win_amd64.whl.
File metadata
- Download URL: error_translator_cli_v2-3.1.0-cp313-cp313-win_amd64.whl
- Upload date:
- Size: 51.0 kB
- Tags: CPython 3.13, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
219e06ef85469755f9dd9303136889c7f1dc8673cee36a01fe4e05345a0926f2
|
|
| MD5 |
f13b6360879f8e8277a4359870e36652
|
|
| BLAKE2b-256 |
795f688b062b351a3c1c118ac35d4fd440bc6d1d182ae91ef0d421ccc5d9e200
|
File details
Details for the file error_translator_cli_v2-3.1.0-cp313-cp313-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl.
File metadata
- Download URL: error_translator_cli_v2-3.1.0-cp313-cp313-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Upload date:
- Size: 55.9 kB
- Tags: CPython 3.13, manylinux: glibc 2.17+ x86-64, manylinux: glibc 2.5+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
668947121cd942a83973d5161de774665003df35bfa873a5b88f9799b6cb1287
|
|
| MD5 |
9741c710b9381adb60a97eee04011099
|
|
| BLAKE2b-256 |
b602ed0fef8067b00268d9438f51a7146f511816ce1bab6ba132378d61c05d7e
|
File details
Details for the file error_translator_cli_v2-3.1.0-cp313-cp313-macosx_11_0_arm64.whl.
File metadata
- Download URL: error_translator_cli_v2-3.1.0-cp313-cp313-macosx_11_0_arm64.whl
- Upload date:
- Size: 49.1 kB
- Tags: CPython 3.13, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
71bb2fdf7c707de677e281f5611c37794f37480593958da3e587adff2f1e0a48
|
|
| MD5 |
f5a89f519cb2f731830455d61c5b7701
|
|
| BLAKE2b-256 |
a4723a4a4fb68ddeebc36b8154b8d0102672420cf2021f9763b2f92ac537134f
|
File details
Details for the file error_translator_cli_v2-3.1.0-cp313-cp313-macosx_10_13_x86_64.whl.
File metadata
- Download URL: error_translator_cli_v2-3.1.0-cp313-cp313-macosx_10_13_x86_64.whl
- Upload date:
- Size: 48.7 kB
- Tags: CPython 3.13, macOS 10.13+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0342b83e6f5ab82cc4fcce704afb3c8704d8f7be9ba66fa09bdaada518bafa9a
|
|
| MD5 |
18f39624af59613ad9b99833e0f5ed9a
|
|
| BLAKE2b-256 |
1db3e3a1a553805f4ef0b15979c27a76c1d7f352fcc74624f3b61196507fd203
|
File details
Details for the file error_translator_cli_v2-3.1.0-cp312-cp312-win_amd64.whl.
File metadata
- Download URL: error_translator_cli_v2-3.1.0-cp312-cp312-win_amd64.whl
- Upload date:
- Size: 51.0 kB
- Tags: CPython 3.12, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e61025c6ec61c84287cd3db9ed29f1cb5befcc1e0ca4778db486f16f995a41b6
|
|
| MD5 |
a5778b4c22c35c17860839f088c09a8a
|
|
| BLAKE2b-256 |
e374963ffeff8de93915ad7ce84e56dfc90623635baaeca709607cc56e607bfd
|
File details
Details for the file error_translator_cli_v2-3.1.0-cp312-cp312-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl.
File metadata
- Download URL: error_translator_cli_v2-3.1.0-cp312-cp312-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Upload date:
- Size: 56.0 kB
- Tags: CPython 3.12, manylinux: glibc 2.17+ x86-64, manylinux: glibc 2.5+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
74588c4914bf9c010d56aca1189c0dbb433d96da30faf680605500d3be59ee03
|
|
| MD5 |
02365ec793b812ed5dd4814bf92bed20
|
|
| BLAKE2b-256 |
2dff2f044503b52b48410578678f02e95c2ef79c84a4f559951d99416e332d3a
|
File details
Details for the file error_translator_cli_v2-3.1.0-cp312-cp312-macosx_11_0_arm64.whl.
File metadata
- Download URL: error_translator_cli_v2-3.1.0-cp312-cp312-macosx_11_0_arm64.whl
- Upload date:
- Size: 49.1 kB
- Tags: CPython 3.12, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d90e568df7dba78ac8ceeaaff814c31be57c2158d7df8cecf0b7fb13e0c3f315
|
|
| MD5 |
e2a65d972e6b7fb6db2b0cc54b330541
|
|
| BLAKE2b-256 |
be5dc005dae600ecd590830564bd58cbeea20316f97525eb5bf1e54e2fdab88e
|
File details
Details for the file error_translator_cli_v2-3.1.0-cp312-cp312-macosx_10_13_x86_64.whl.
File metadata
- Download URL: error_translator_cli_v2-3.1.0-cp312-cp312-macosx_10_13_x86_64.whl
- Upload date:
- Size: 48.7 kB
- Tags: CPython 3.12, macOS 10.13+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2c37c74de47682f657d5060c94c4ea82ed3e2a1bfe817fee67417e40163be8d9
|
|
| MD5 |
4c810cb7dffb83b4860638942801b709
|
|
| BLAKE2b-256 |
71b70be1858b26f12e036547ec3b9d182b6b9be87bfbda725a247a3dad2d0d86
|
File details
Details for the file error_translator_cli_v2-3.1.0-cp311-cp311-win_amd64.whl.
File metadata
- Download URL: error_translator_cli_v2-3.1.0-cp311-cp311-win_amd64.whl
- Upload date:
- Size: 51.0 kB
- Tags: CPython 3.11, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
404ea57a838f16a0d85ad3f3a01647a4db9a6c7fe5134f382e8e3122e3206368
|
|
| MD5 |
06427fbf49bb21374c67d1171c9fcff1
|
|
| BLAKE2b-256 |
10cc2c997208f44ade2dc05ca2c960b60e4b06fa2a51092d55c7754dab024622
|
File details
Details for the file error_translator_cli_v2-3.1.0-cp311-cp311-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl.
File metadata
- Download URL: error_translator_cli_v2-3.1.0-cp311-cp311-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Upload date:
- Size: 55.8 kB
- Tags: CPython 3.11, manylinux: glibc 2.17+ x86-64, manylinux: glibc 2.5+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1eb43f14028ada07c8ec8bab91a7c44e15d66f94d96364b51aa598cf3271bc55
|
|
| MD5 |
4cb77a4a667b8a23e13c1dfdd619ab01
|
|
| BLAKE2b-256 |
2252b2c136acdd05cbc531423387ee070872a64e51f3bad004f81127ec2086b7
|
File details
Details for the file error_translator_cli_v2-3.1.0-cp311-cp311-macosx_11_0_arm64.whl.
File metadata
- Download URL: error_translator_cli_v2-3.1.0-cp311-cp311-macosx_11_0_arm64.whl
- Upload date:
- Size: 49.1 kB
- Tags: CPython 3.11, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a75c36e29b89a866c56bb899a3ab051ef0bd9156dff43cd607406f6e637d2148
|
|
| MD5 |
8b4ec29314923e038a716090b4d3d97c
|
|
| BLAKE2b-256 |
62b6cd89ea7cf1ebaa802ed92f0aaeb0d8fff58b64f1a6c62f79fda082349d6a
|
File details
Details for the file error_translator_cli_v2-3.1.0-cp311-cp311-macosx_10_9_x86_64.whl.
File metadata
- Download URL: error_translator_cli_v2-3.1.0-cp311-cp311-macosx_10_9_x86_64.whl
- Upload date:
- Size: 48.7 kB
- Tags: CPython 3.11, macOS 10.9+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2afd76908b7d8de311edfcb8e6f2b6558c577cdb34491a091cc3f96463b5d876
|
|
| MD5 |
674c14c57059080b35299c6ad0232da7
|
|
| BLAKE2b-256 |
7d321190dfe534d1f820440dd01b6eba364a2ff59c7cc48b1ac6e097d8e4a84b
|
File details
Details for the file error_translator_cli_v2-3.1.0-cp310-cp310-win_amd64.whl.
File metadata
- Download URL: error_translator_cli_v2-3.1.0-cp310-cp310-win_amd64.whl
- Upload date:
- Size: 51.0 kB
- Tags: CPython 3.10, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
998855fc86d121fcf696ca4cad530c0dc1949c99f8fca4c032cb20d7b6daf99d
|
|
| MD5 |
72d73aafe01cdc495458e1c3e1408936
|
|
| BLAKE2b-256 |
930c041980a695df917a93626c19a98f638f23da41369858507348d55b48325f
|
File details
Details for the file error_translator_cli_v2-3.1.0-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl.
File metadata
- Download URL: error_translator_cli_v2-3.1.0-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Upload date:
- Size: 55.8 kB
- Tags: CPython 3.10, manylinux: glibc 2.17+ x86-64, manylinux: glibc 2.5+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bfaf9e19ddd6dd1d39800846d85d3decd8b785edbddd46a7606bfec0d3d02b9c
|
|
| MD5 |
07e56fe6868da9dc4cd2a1995f84c1a8
|
|
| BLAKE2b-256 |
46196462e57ecca8dd5833bc9d26da46ed8f3169288e64b278cf5187c44ce397
|
File details
Details for the file error_translator_cli_v2-3.1.0-cp310-cp310-macosx_11_0_arm64.whl.
File metadata
- Download URL: error_translator_cli_v2-3.1.0-cp310-cp310-macosx_11_0_arm64.whl
- Upload date:
- Size: 49.1 kB
- Tags: CPython 3.10, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e050423eebd730b8d5442f005809aa3852148071150bbcc5c8113438c4db14d6
|
|
| MD5 |
f8204686aea2095cc26d1b331644b6ce
|
|
| BLAKE2b-256 |
95f657a954ec0efdd148e7c5d1e0c149a7baa00fb1afba8b067307934282aefc
|
File details
Details for the file error_translator_cli_v2-3.1.0-cp310-cp310-macosx_10_9_x86_64.whl.
File metadata
- Download URL: error_translator_cli_v2-3.1.0-cp310-cp310-macosx_10_9_x86_64.whl
- Upload date:
- Size: 48.7 kB
- Tags: CPython 3.10, macOS 10.9+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c51f6d9152d1a58f0f5c8fff9ee71ed426ef6221b1b23585bd65be857c978d0b
|
|
| MD5 |
0649c50dd2bb02a3ddbd2c9ecb8161c4
|
|
| BLAKE2b-256 |
07aee8d8308bf6ad9894e7bc08ec158085d85f9657a19c5f6467e982ac940812
|
File details
Details for the file error_translator_cli_v2-3.1.0-cp39-cp39-win_amd64.whl.
File metadata
- Download URL: error_translator_cli_v2-3.1.0-cp39-cp39-win_amd64.whl
- Upload date:
- Size: 51.0 kB
- Tags: CPython 3.9, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
afcbef73640e836f5ec9c3b5b71f671655cd88a942c101d05355e0927a2db9cc
|
|
| MD5 |
0f0ddba0230cdee9fcf2a5a8bdb1f24d
|
|
| BLAKE2b-256 |
ecd6f0bcce40d0fa1c8d5a2d14df62d69a93983b8d5cf1609b7e9266e3f29645
|
File details
Details for the file error_translator_cli_v2-3.1.0-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl.
File metadata
- Download URL: error_translator_cli_v2-3.1.0-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Upload date:
- Size: 55.5 kB
- Tags: CPython 3.9, manylinux: glibc 2.17+ x86-64, manylinux: glibc 2.5+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cd2544b4606d5ee7cf2cc7cf22273b559743c52102d657b4c118cf75764308ae
|
|
| MD5 |
9c4e21ed214b21e30b70ab3ac8e423c3
|
|
| BLAKE2b-256 |
3f0aea9a8100d9eff873d8e63441af8289885d1e89161fa6aedb3d1e0bb2fe38
|
File details
Details for the file error_translator_cli_v2-3.1.0-cp39-cp39-macosx_11_0_arm64.whl.
File metadata
- Download URL: error_translator_cli_v2-3.1.0-cp39-cp39-macosx_11_0_arm64.whl
- Upload date:
- Size: 49.1 kB
- Tags: CPython 3.9, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7a17aa3165fcbd9d5aa62acc78803b6bf5769e8dd9b5298d205192f545c9be77
|
|
| MD5 |
27dce31fc11d714599cf7b75cb338b57
|
|
| BLAKE2b-256 |
382ee334d65ad08ba0440c56e71f59f9f6bd8514d9bd4c3a9389b4bf61db06ac
|
File details
Details for the file error_translator_cli_v2-3.1.0-cp39-cp39-macosx_10_9_x86_64.whl.
File metadata
- Download URL: error_translator_cli_v2-3.1.0-cp39-cp39-macosx_10_9_x86_64.whl
- Upload date:
- Size: 48.7 kB
- Tags: CPython 3.9, macOS 10.9+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
43148f0d64527b2343c4e50c5c55503da4af412767ecb2260b966a552ff7c4b9
|
|
| MD5 |
b3566a7455dd9fbd46b0973193174f76
|
|
| BLAKE2b-256 |
ea3038facfe369eab9b274670694141a46fe1fcdb4e3380ba6abe82130a8e552
|
