A professional Python error explainer CLI that converts tracebacks into human-friendly explanations.
Project description
Voxie 🚀
Voxie — A professional Python error explainer CLI
Turn confusing Python tracebacks into clear, beginner-friendly explanations.
🚀 What is Voxie?
Voxie is a command-line tool that transforms Python errors into easy-to-understand explanations.
It helps beginners and professionals debug faster by clearly explaining:
- ❌ What went wrong
- 📍 Where it happened
- 🛠️ How to fix it
- 🧠 Full traceback (optional)
✨ Features
| Mode | Output Type | Use Case |
|---|---|---|
| ✅ Standard | Friendly explanation | Default |
| 🔍 Verbose | Full traceback + explanation | Deep debugging |
| ⚡ Minimal | One-line error | Quick glance |
| 🚫 Off | Native Python traceback | Disable Voxie |
| 📄 Log | Save output to file | Sharing / reports |
💻 Installation
pip install voxie
🎯 Usage
✅ Standard Mode (default)
vox test.py
🔍 Verbose Mode
vox --verbose test.py
⚡ Minimal Mode
vox --minimal test.py
🚫 Off Mode (native Python output)
vox --off test.py
📄 Save Output to Log File
vox --log mylog.txt test.py
🧩 Example Output
🧠 Standard
❌ Voxie detected an error
What happened:
You used a name that Python does not recognize.
Where it happened:
File: test.py
Line: 1
Code: print(y)
🔍 Verbose
🧠 Full traceback:
NameError: name 'y' is not defined
🧠 How Voxie Works
Voxie intercepts Python exceptions and converts them into:
Friendly explanations
Exact error locations
Suggested fixes
This makes debugging faster, calmer, and beginner-friendly.
🛠️ Contributing
Contributions are welcome 🙌
Fork the repository
Create a new branch
Add a new explainer in vox/explainers/
Submit a pull request
📄 License
This project is licensed under the MIT License.
See the LICENSE
file for details.
⭐ Show Your Support
If Voxie helped you:
⭐ Star the repository
🔁 Share it with friends
🧑💻 Use it in your projects
<div align="center"> <strong>Made with ❤️ by <a href="https://github.com/krishh2530">krishh2530</a></strong> </div> ```
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
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 voxie-0.1.1.tar.gz.
File metadata
- Download URL: voxie-0.1.1.tar.gz
- Upload date:
- Size: 10.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f92c9a0631e0e67ca56ae9576fcc1c8bc34821e31f8285f8eb8e32ce5776bcbc
|
|
| MD5 |
394e5e1e8e86069da5b2c1f2a03b564d
|
|
| BLAKE2b-256 |
2c84ed293f3aface8e2dbbdf5fcb36af165961fc32c240fde5d8223f13fb1d5e
|
File details
Details for the file voxie-0.1.1-py3-none-any.whl.
File metadata
- Download URL: voxie-0.1.1-py3-none-any.whl
- Upload date:
- Size: 12.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2da7b10c4e4660d757523b80d3f6fa380ab0580b8e40c20c765fb000b4e00f0f
|
|
| MD5 |
e026d4d8e2ca7744494b9a3172589807
|
|
| BLAKE2b-256 |
5e4a1adb1ad65cb3f773c89adf22c9be5262fc167032b2864dc7fefa6b56eca6
|