Skip to main content

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.

PyPI Python License Status


🚀 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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

voxie-0.1.1.tar.gz (10.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

voxie-0.1.1-py3-none-any.whl (12.7 kB view details)

Uploaded Python 3

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

Hashes for voxie-0.1.1.tar.gz
Algorithm Hash digest
SHA256 f92c9a0631e0e67ca56ae9576fcc1c8bc34821e31f8285f8eb8e32ce5776bcbc
MD5 394e5e1e8e86069da5b2c1f2a03b564d
BLAKE2b-256 2c84ed293f3aface8e2dbbdf5fcb36af165961fc32c240fde5d8223f13fb1d5e

See more details on using hashes here.

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

Hashes for voxie-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 2da7b10c4e4660d757523b80d3f6fa380ab0580b8e40c20c765fb000b4e00f0f
MD5 e026d4d8e2ca7744494b9a3172589807
BLAKE2b-256 5e4a1adb1ad65cb3f773c89adf22c9be5262fc167032b2864dc7fefa6b56eca6

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page