I built a Python tool that explains errors like you’re 5 (English + Russian, OSS)

BB6 — Mon, 07 Jul 2025 06:24:11 +0000

Tired of vague Python errors at 2 AM?

You know how it goes:
You’re debugging your code late at night, and Python hits you with:

ZeroDivisionError: division by zero

Sure, it’s readable… but not really helpful, especially when you’re stuck, tired, or new to the topic.

So I built something small but useful:

🔧 Meet Error Narrator

A lightweight open-source tool that explains Python exceptions in plain English and Russian, like you’re 5.

🚀 Features:
• Human-friendly explanations for common and not-so-common Python errors
• Shows the exact file and line where the error happened
• Suggests actual code fixes with diffs
• Explains the concept behind the error, so you don’t just fix it — you learn
• Works with OpenAI or HuggingFace models (via Gradio)
• Caches repeated errors to reduce API calls

🤖 How does it work?

It reads your traceback, sends it through an LLM, and returns a simplified, translated breakdown — not just what went wrong, but why.

You can use it in the terminal or plug it into your existing debugging setup.

📦 Install:
pip install error-narrator

💻 GitHub:

https://github.com/Zahabsbs/Error-Narrator

🧠 Why I built this

I’ve seen too many beginners — and even experienced devs — get frustrated with cryptic error messages.

I built this for myself, to save time. But I realized others could use it too.

I’m still improving it — any feedback, suggestions, or contributors are more than welcome!

Thanks for reading! 🙌

Forem: BB6

I built a Python tool that explains errors like you’re 5 (English + Russian, OSS)