v4.5.0.0

Team SWIRL is delighted to announce the general availability of SWIRL 4.5! 

⭐ PLEASE STAR OUR REPO: https://github.com/swirlai/swirl-search
🌐 PLEASE VISIT OUR WEBSITE: https://www.swirlaiconnect.com/

---

This version of SWIRL Community adds support for multiple RAG LLMs and major updates to the Galaxy UI and SWIRL administrative console, including basic analytics and a bult-in log viewer.

## New Features

<img width="1903" height="1313" alt="SWIRL Community 4.5 featuring new UI and AI Insight generated by RAG via Claude Haiku" src="https://github.com/user-attachments/assets/322edfc1-04a8-4a3e-8183-d01197bedd5b" />

🔹 Support for executing RAG with most LLMs 

SWIRL Community now supports most LLMs for AI Insight generation, including OpenAI, Azure/OpenAI, Claude, Gemini, local models running ollama, and many more! The redesigned AI Summary block now includes a thinking indicator, citation favicons, and tighter result-card layout.

🔹 New MCP server

<img width="1600" height="819" alt="SWIRL Community MCP Server via the MCP inspector" src="https://github.com/user-attachments/assets/a55edb40-4e7a-45cc-83e5-ee0770ea821a" />

Drop SWIRL into Claude Desktop, Claude Code, Cursor, or any MCP client through the new [`swirl-mcp-server`](https://github.com/swirlai/swirl-mcp-server) adapter. One tool call (`search(query="...", rag=true)`) returns a generated answer with sources, federated across every connector you've configured — without any data leaving your network.

```json
{
  "mcpServers": {
    "swirl": {
      "command": "swirl-mcp",
      "env": {
        "SWIRL_BASE_URL": "http://localhost:8000",
        "SWIRL_USERNAME": "<your-swirl-username>",
        "SWIRL_PASSWORD": "<your-swirl-password>"
      }
    }
  }
}
```

🔹 You can now edit SearchProviders and AIProviders from the admin console

<img width="2556" height="1313" alt="SWIRL Community 4.5 admin console SearchProvider editing interface" src="https://github.com/user-attachments/assets/4b0fd05a-c776-43c8-bd2a-ae492510042e" />

The new form includes support for pasting JSON, bulk editing, and more!

🔹 You can now view logs right from the admin console

<img width="2552" height="1310" alt="SWIRL Community 4.5 admin console showing log viewer" src="https://github.com/user-attachments/assets/d85a8c18-837b-4d25-84ed-69e9f644157d" />

🔹 You can now view activity analytics from the admin console

<img width="2552" height="1310" alt="SWIRL Community 4.5 admin console showing activity analytics" src="https://github.com/user-attachments/assets/5f4f208b-72ae-4c31-bcee-5680a1b02d3d" />

## Improvements

🔹 The revised source selector now groups sources by tag, and shows the tag selected. 

<img width="350" height="641" alt="SWIRL Community source selector now shows tags and sources" src="https://github.com/user-attachments/assets/2364deb2-7144-43fd-ba29-dca50e1b60cd" />

🔹 Canonical SearchProvider naming

All shipped SearchProviders are now named with a consistent Type: "Source scheme - Articles" - arXiv, Web - Google PSE, Docs - SWIRL, Email - M365 Outlook, Code - GitHub, etc. Existing tag-prefix syntax (arxiv:, sharepoint:, github:, etc.) keeps working unchanged.

🔹 Updated re-ranking model with performance improvements
🔹 Better error handling during AI insight generation
🔹 Processing status displayed during RAG
🔹 Major overhaul of Galaxy 
🔹 Major overhaul of Administrative console

## Fixes

🔹 Security Vulnerabilities - CVEs addressed across base image + dependency upgrades

🔹 Galaxy UI: AI Summary no longer clobbers aiModel after handleRagResponse returns, notification-bell and AI-Provider 404 noise silenced in browser console, print-header 404 silenced, M365 bare-search default mixer correcte, several rendering and contrast fixes

🔹 Search & RAG: tag-prefix queries (Code:, Issues:, PRs:, HashID:, Wallet:, EPMC:, etc.) restored as first-class routing tags, Internet Archive no longer mishandles NOT queries (previous Web tag removed to fix this), rag_timeout URL-param plumbing tightened end-to-end

# Upgrading

⚠️ Version 4.5 introduces a database migration (0003_add_aiprovider) to support the new AIProvider admin. Run python swirl.py setup (or restart the Docker container, which runs setup automatically) to apply it.

If you have a long-running deployment with custom SearchProvider / AIProvider names, review swirl_sync.py before upgrading.

# Documentation
📘 SWIRL's [documentation site](https://docs.swirlaiconnect.com/) has been updated for 4.5, including the new [MCP Server Guide](https://docs.swirlaiconnect.com/mcp-guide), refreshed [SearchProviders reference](https://docs.swirlaiconnect.com/sp-guide), and a top-level [Troubleshooting](https://docs.swirlaiconnect.com/troubleshooting) page.