DebugAI is a lightning-fast CLI tool that uses Google's Gemini 2.5 Flash to instantly explain and fix your terminal errors. Stop wasting time Googling stack traces—just type fix and get back to coding.
- 🚀 Instant Fixes: Get a one-sentence solution for any terminal error in seconds.
- 🧠 Powered by Gemini 2.5 Flash: Leverages the latest in multimodal AI for high-accuracy reasoning.
- 💻 Cross-Platform: Optimized for Windows, macOS, and Linux.
- ⚡ Minimalist CLI: No complex flags, just zero-friction debugging.
- 🔧 Easy Setup: Install via pip and you're ready to go.
Install DebugAI directly from your project directory:
pip install -e .Set up your Gemini API key to start using DebugAI:
$env:GEMINI_API_KEY="your_api_key_here"export GEMINI_API_KEY="your_api_key_here"Tip
Add the export command to your .bashrc or .zshrc to make it permanent!
Whenever you encounter an error in your terminal, simply wrap it in quotes and pass it to the fix command:
fix "SyntaxError: invalid syntax"Fix: Review your code for typos or incorrect indentation in the preceding lines.
Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Distributed under the MIT License. See LICENSE for more information.
Developed with ❤️ by Shihab