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

• 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.

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.

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

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.

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