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

#ai #python #learning #opensource

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.