Error Translator¶
Error Translator parses raw Python tracebacks and converts them into readable explanations with actionable fixes. Built for local-first development workflows, it uses a deterministic, offline regex-matching engine that powers a CLI, Python API, auto-hook mode, Jupyter notebooks, and a FastAPI service.
If this project is useful to you, support it with a GitHub star: https://github.com/gourabanandad/error-translator-cli-v2
Quick links: - GitHub Repository: https://github.com/gourabanandad/error-translator-cli-v2 - PyPI Package: https://pypi.org/project/error-translator-cli-v2/ - Issues / Feature Requests: https://github.com/gourabanandad/error-translator-cli-v2/issues
Core Design Principles¶
- Privacy-First (Offline): Your stack traces and source code snippets never leave your machine. The regex and AST engines operate entirely locally.
- Deterministic Matching: Regex rules are compiled once and reused, ensuring consistent outputs for the same error text.
Quickstart¶
Installation¶
Requires Python 3.9 or newer. Install globally via pip:
Basic Usage¶
Run a Python script and translate unhandled exceptions:
Provide an error string directly:
For more advanced integrations (Jupyter, FastAPI, Import Hooks), please refer to the Features & Integrations guide.
Documentation Navigation¶
- Features & Integrations: Comprehensive guide on all usage modes (CLI, Jupyter, FastAPI, etc.).
- Real-World Examples: Practical demonstrations comparing raw tracebacks with translated outputs.
- Architecture & Internals: Technical breakdown of the engine, rule pipeline, and native acceleration.
- Contributing Guidelines: Guidelines for adding rules and using the AI-Powered Rule Builder.