VisionDebug 🐞

AI-powered Python debugger for Visual Studio Code using a local AI model via Ollama.

VisionDebug analyzes Python code, detects errors automatically, explains them in plain English, and suggests fixes directly inside your editor. All processing runs fully locally on your machine.

✨ Features

🔍 Automatic Bug Detection Detects runtime, syntax, and logic errors in Python code.

⚙️ Function-Level Testing Tests each function independently to uncover hidden bugs — even ones that don't crash the full program.

🤖 AI Explanations Uses the DeepSeek Coder model to explain issues clearly and suggest fixes.

⚡ AI Fix Suggestions Generates improved versions of your code with suggested fixes applied.

📁 Project-Wide Scanning Analyze every Python file in your workspace.

🔒 Runs Fully Local No cloud APIs. No API keys. Your code never leaves your machine.

🧠 Architecture

VS Code Extension
       ↓
VisionDebug Server
       ↓
Ollama
       ↓
DeepSeek Coder Model

Built with

• Visual Studio Code Extension API
• FastAPI
• Uvicorn
• Ollama

📦 Installation

1️⃣ Install Ollama

Download and install Ollama from: https://ollama.com

2️⃣ Download the AI Model

ollama pull deepseek-coder:6.7b

3️⃣ Install Python

Download from: https://www.python.org/downloads

⚠️ During installation, check "Add Python to PATH".

4️⃣ Install VisionDebug Server

Download and run VisionDebug-Server.exe from the GitHub releases page.

5️⃣ Install the VS Code Extension

Option A — Marketplace (Recommended)

code --install-extension visiondebug

Option B — Manual (.VSIX)

1. Open Extensions panel in VS Code
2. Click ⋯ (More Actions)
3. Select Install from VSIX...
4. Choose VisionDebug.vsix

🚀 Running VisionDebug

Double-click VisionDebug-Server.exe to start the backend server at http://127.0.0.1:8000.

⚠️ Keep this window open while using VisionDebug in VS Code.

🧪 How to Use

1. Open a Python file in VS Code
2. Click 🐞 Debug with VisionDebug at the top of the editor
3. Review detected issues in the VisionDebug AI panel
4. Apply the suggested fixes

⚙️ Extension Commands

Open the Command Palette with Ctrl + Shift + P:

🛠 Requirements

• Python 3.x (must be installed and added to PATH)
• Ollama
• deepseek-coder:6.7b model
• VisionDebug backend running on 127.0.0.1:8000
• Visual Studio Code

🔒 Privacy

VisionDebug runs completely locally.

• No cloud APIs
• No telemetry
• Your code never leaves your machine

📄 License

MIT License