spyder-ai-chat 0.3.2

OpenAI-compatible AI chat pane + FIM completion for Spyder 6

Spyder IDE AI Chat Plugin

An OpenAI-compatible AI chat panel for Spyder 6.x. Connect to 12 providers — OpenAI, Groq, Mistral, DeepSeek, Together AI, Fireworks AI, OpenRouter, Azure OpenAI, Ollama, LM Studio, vLLM, or any custom OpenAI-compatible endpoint — all from inside your IDE, without switching windows.

© 2026 Maciej Piecko — MIT License

---

What's new in 0.3.2

• Plugin entry-point renamed to ai_chat_plugin (spyder.plugins) and ai_fim_provider (spyder.completions) for clarity
• NAME / CONF_SECTION in AIChatPlugin updated to "ai_chat_plugin"; COMPLETION_PROVIDER_NAME / CONF_SECTION in AiFimProvider updated to "ai_fim_provider" / "ai_chat_plugin"

What's new in 0.3.1

• Settings → ⚡ Auto-complete tab redesigned as a step-by-step wizard: enable → set provider/URL → Load Models → pick model + backend; backend probe validates response body to avoid false-positive matches
• Model list and backend list persist after save and reopen — no need to re-run Load Models every time
• Test Connection button in the Connection tab — probes GET /models with an OpenAI-SDK-style User-Agent (fixes Cloudflare 403 / error 1010 on Groq and similar providers)
• System Prompts tab: Edit button removed; selecting a prompt immediately opens it for editing; Save activates only when content changes
• Commands tab: Edit button removed; selecting a command immediately opens it for editing; Save activates only when content changes
• Settings window wider (+10%); tabs stretch edge-to-edge; "🖊 Editor" tab renamed to "🖊 Dialogs"
• FIM cursor-offset bug fixed: completions are now correct for files with \r\n line endings

What's new in 0.3.0

• AI auto-complete (FIM) — fill-in-middle ghost-text completions in the code editor
• Tab to accept, Escape to dismiss, Alt+\ for manual trigger
• Supports Ollama, LM Studio, vLLM, DeepSeek, Codestral/Mistral, OpenRouter, custom endpoints
• Trigger modes: auto (debounce), after new line, manual

---

Features

	Feature	Details
🗨️	Chat panel	Scrollable conversation with colour-coded user / assistant messages
⚡	Streaming	Token-by-token streaming so you see the reply as it is generated
🔁	Model selector	Dropdown populated live from the API — switch models instantly
🔧	12 providers	OpenAI, Groq, Mistral, DeepSeek, Together, Fireworks, OpenRouter, Azure, Ollama, LM Studio, vLLM, Custom
⚙	Inference params	Per-chat hyperparameters popup — provider-aware, resets on New Chat
🔑	Optional API key	Leave blank for local models that need no authentication
🧠	System prompt	Custom prompt field, or select from a saved prompts library
💬	Saved system prompts	Define reusable prompts; manage via Settings → System Prompts tab
⏹	Stop	Cancel a streaming reply at any time
🗑	New Chat	Start a fresh conversation; current one saved automatically
📋	Chat history	Browse, load, and delete saved chats; active chat highlighted in green
📎	File context	Attach whole files or selected text from the editor as context
🖊️	Markdown rendering	Headings, bold, italic, tables, code blocks, blockquotes, links, strikethrough
🗂	Nested lists	Arbitrarily deep bullet & numbered lists, mixed types at any level
🧠	Thinking blocks	<think> tags rendered as a collapsible scrollable box (DeepSeek-R1, QwQ, …)
📋	Copy to editor	Insert any code block or full response at the cursor in the active file
🗑	Delete exchange	Remove any exchange with a 3-second undo window
🔄	Regenerate	Re-run the last assistant response with one click
↔	Horizontal scroll	Wide code blocks scroll horizontally instead of clipping
⚙	Settings	Tabbed dialog: provider + Test Connection, dialog font sizes, history, system prompts, commands, auto-complete
/	Commands	Slash-command aliases with picker dropdown; expand to full prompts before sending
✍️	AI auto-complete	FIM ghost-text completions in the editor — Tab to accept, Escape to dismiss

---

Requirements

• Python ≥ 3.9
• Spyder ≥ 6.0
• No additional Python packages — HTTP via urllib (stdlib), UI via Qt (bundled with Spyder)

---

Installation

From PyPI

pip install spyder-ai-chat

From source / development build

Clone the source code from the repository:

https://sourceforge.net/p/spyder-ai-chat-plugin/code/ci/master/tree/

Then install in editable mode:

cd spyder_ai_chat
pip install -e .

Important: install into the same Python environment that Spyder uses.

After installation, restart Spyder. The panel appears automatically. If not visible: Window → Panes → AI Chat.

---

Quick start

1. Open Settings (⚙ button in the panel toolbar).
2. On the Connection tab, select your Provider from the dropdown.
3. Fill in the API URL and key as needed (pre-filled for known providers).
4. Click Test Connection to verify credentials, then click OK.
5. Click ⟳ to load the model list and pick a model.
6. Type a message and press Ctrl+Enter or click Send.

To enable AI auto-complete in the editor:

1. Open Settings → ⚡ Auto-complete.
2. Check Enable AI auto-completion in the editor.
3. Select a provider and API URL, then click Load Models.
4. Choose a model and backend type, adjust parameters if needed, and click OK.

---

License

MIT — see the LICENSE file included in the package.