📸 LMStudio Proxy (Screenshot Fix)

VSCode Marketplace Version

The missing link between AI Coding Assistants (KiloCode, Cline, Roo-Code) and LMStudio.

This extension fixes the common error:

[Server Error] 'url' field must be a base64 encoded image

If you use LMStudio with local vision models, you've likely hit this wall. AI agents often send image paths (e.g., /tmp/screenshot.png) or WebP files, but LMStudio requires base64-encoded strings.

This extension sits in the middle, transparently converting everything for you.

🚀 Key Features

✅ Fixes the "Base64" Error: Automatically converts internal file paths to data URIs.
🖼️ WebP Support: Solves the issue where LMStudio rejects WebP screenshots (default in many agents).
⚡️ Zero-Config: Runs in the background automatically.
🔍 Debug Mode: See exactly what your AI agent is sending to LMStudio.

📥 Installation

Open VSCode Extensions (Cmd+Shift+X).
Search for "LMStudio Proxy".
Install the extension by Webzler Solutions Inc.
That's it! It runs automatically.

🛠 Usage

Verify it's Running:
- Look for $(radio-tower) Proxy: ON in your VSCode Status Bar (bottom right).
Configure Your AI Assistant:
- Point your AI tool (KiloCode, Cline, Roo-Code, etc.) to the proxy port.
- Proxy URL: http://localhost:1235
- (Original LMStudio is at :1234, Proxy is at :1235)
Enjoy:
- Take screenshots in your AI chat. They will now work perfectly with your local vision model.

⚙️ Configuration

You can customize settings in VSCode (Cmd+,) under "LMStudio Proxy":

Setting	Default	Description
`lmstudioProxy.port`	`1235`	The port the proxy listens on.
`lmstudioProxy.targetUrl`	`http://localhost:1234`	Your actual LMStudio server address.
`lmstudioProxy.autoStart`	`true`	Automatically start the proxy when VSCode opens.

📐 Architecture

graph LR
    A[KiloCode / Cline] -->|POST /chat/completions| B(VSCode Extension Proxy :1235)
    B -->|Convert WebP -> PNG| B
    B -->|Forward Request| C[LMStudio Server :1234]
    C -->|Response| B
    B -->|Response| A

🐛 Troubleshooting

"Proxy Failed to Start"

Check if port 1235 is already in use. Change the port in Settings.
View Logs: Run command LMStudio Proxy: Show Proxy Logs (Cmd+Shift+P).

"Images still failing"

Ensure your AI tool is actually pointing to :1235, not :1234.
Check the Output channel logs to see if the request is hitting the proxy.

👤 Author

Amit Rathiesh (Webzler Solutions Inc.)

Email: amitrathiesh@webzler.com
Website: www.webzler.com
GitHub: @amitrathiesh

🤝 Contributing

Contributions are welcome!

Fork the repo
Create feature branch (git checkout -b feature/amazing-feature)
Commit changes (git commit -m 'Add amazing feature')
Push to branch (git push origin feature/amazing-feature)
Open a Pull Request

LMStudio Proxy (Screenshot Fix)

Webzler Solutions Inc.