v1.0.0

[github-actions[bot]]

📦 Open-WebUI-Functions v1.0.0

Warning

Parts of these release notes were generated with AI and may contain mistakes or inaccuracies. Please verify important details against the actual commits, pull requests, and source changes.

Open-WebUI-Functions v1.0.0 introduces a robust set of modular Python pipelines, filters, and integrations that significantly extend the capabilities of Open WebUI. This first stable release delivers seamless connectivity to external AI providers—including Azure OpenAI, Google Gemini, Infomaniak AI Tools, and N8N—alongside advanced features like native citation support, multimodal processing, secure secret management, and detailed agent tool usage display. The architecture is designed for flexibility, streaming and non-streaming data flows, and granular authentication, empowering administrators and developers to automate workflows and enhance frontend transparency.

✨ New Features

• Added modular pipelines for Azure OpenAI, Google Gemini, Infomaniak AI Tools, and N8N, enabling customizable request/response processing, model inference, and event emission.
• Introduced Azure AI Search integration with native citation support, including structured events for frontend citation cards and relevance scoring.
• Integrated Google Gemini pipeline with multimodal (image/video) generation, configurable aspect ratio/resolution, and support for Veo models.
• Enabled N8N workflow automation with detailed AI agent tool usage display, configurable verbosity, and session handling.
• Implemented flexible authentication options, including support for Cloudflare Access and encrypted API key management.
• Added streaming support across pipelines, allowing real-time data processing and prompt-feedback handling.
• Provided native tool calling and Google search grounding for enhanced RAG (Retrieval Augmented Generation) scenarios.
• Supported conversation history inclusion in N8N requests for improved context-aware automation.
• Emitted structured events for citation linking, tool usage transparency, and chat lifecycle, facilitating advanced frontend features.

🚀 Improvements

• Enhanced Google Gemini pipeline with improved model compatibility, thinking level validation, and configurable thinking budgets.
• Refactored video generation event emission to a dedicated function for cleaner code and better error handling.
• Improved Azure AI and Gemini pipelines with better model handling, usage data extraction, and optional event emitter integration for Infomaniak API.
• Added model whitelist and additional model support to Gemini pipeline for granular control over available models.
• Updated password input handling and usage tracking across pipelines for improved security and analytics.
• Optimized citation handling in Azure AI pipeline, including normalization, markdown link conversion, and XSS protection via html.escape.
• Improved logging efficiency by avoiding unnecessary JSON serialization and providing comprehensive debug logs for citation events.
• Enhanced streaming response handling in Infomaniak pipeline with error suppression during cleanup.
• Updated API endpoints and versioning for Infomaniak integration to support v2.1.0.
• Added support for Enterprise Web Search on Vertex AI, expanding search capabilities.
• Improved score matching and normalization logic for Azure AI Search citations, ensuring accurate relevance display.
• Refactored system prompt hierarchy and fallback logic in Gemini pipeline for more reliable prompt management.

🔧 Bug Fixes

• Corrected badge URLs and removed outdated badges in README.md for accurate project status display.
• Fixed image generation model filtering and default value handling in Gemini pipeline.
• Addressed incorrect file retrieval from S3 and undefined variable errors in Azure AI pipeline.
• Resolved citation structure issues, including event emission per source and proper OpenWebUI display.
• Fixed streaming parsing and buffer handling for N8N responses.
• Corrected merge issues, excluded private methods, and improved code review compliance.
• Fixed thinking config, copilot recommendations, and prompt-feedback streaming in Gemini pipeline.
• Resolved NoneType errors and improved handling of null citation fields.
• Fixed multi-image upload handling for image generation models.
• Streamlined Azure OpenAI endpoint checks and removed unnecessary imports.

🔄 Migration Notes

• For users upgrading from custom prototypes or earlier forks, ensure environment variables and pipeline configurations are updated to reflect new authentication options and event emitter logic.
• Citation event structure has changed: now emits separate events per source with unique names and markdown links. Update any custom frontend handlers to match the new format:

  # Example: Citation event structure
  event = {
      "type": "citation",
      "source": "[doc1]",
      "url": "https://example.com/doc1",
      "distances": [0.85, 0.92],
      ...
  }

• Gemini pipeline system prompt logic now prioritizes chat controls, model defaults, and user overrides. If you previously relied on environment variables for prompt injection, review the new hierarchy and adjust accordingly.

⚠️ Breaking Changes

• Removed deprecated valves (e.g., AZURE_AI_ENHANCE_CITATIONS, AZURE_AI_OPENWEBUI_CITATIONS, AZURE_AI_LINK_CITATIONS) and simplified citation handling; update any scripts referencing these valves.
• Changed Gemini pipeline configuration: replaced THINKING_ENABLED with INCLUDE_THOUGHTS for thought output. Update environment variables to match:

  # Old
  THINKING_ENABLED=true
  # New
  INCLUDE_THOUGHTS=true

• Citation event format and linking have been overhauled; custom integrations must adapt to markdown link structure and new event emission patterns.

📦 Dependencies

• Upgraded Google Gemini pipeline to version 1.11.1, Infomaniak API interface to v2.1.0, and Azure AI Foundry pipeline to latest supported version.
• Switched to the newer python-genai SDK for Google Gemini, enabling Vertex AI support.
• Added minimum Open WebUI version requirements across multiple pipelines for compatibility.

🔒 Security

• Implemented automatic encryption for API keys and sensitive secrets, ensuring secure storage and transmission.
• Enhanced XSS protection in citation tag names via html escaping.
• Added support for Cloudflare Access authentication, improving access control for administrator endpoints.
• Replaced deprecated decryption methods and improved password input handling.

🏗️ Infrastructure & CI/CD

• Added GitHub workflows for automated releases and versioning, streamlining deployment and release management.
• Updated badge URLs and issue templates for improved project documentation and contributor guidance.

📝 Other Changes

• Revised README.md for clarity, structure, and updated feature descriptions.
• Added detailed integration documentation, including index schema and field mapping for Azure AI citations.
• Enhanced code comments, type annotations, and efficiency improvements per code review feedback.
• Removed dead code and unused functions for maintainability.
• Added technical spike documentation and improved Copilot prompts.

---

📋 Release Information

• Application: Open-WebUI-Functions
• Version: 1.0.0
• Repository: owndev/Open-WebUI-Functions
• Commit: a2154885d69f206b9b9d412e0e9cb59f7f3f6985
• Release Type: ✅ Stable Release
• Environment: Production
• Created: 2026-03-16T08:33:54+01:00

📋 Version Information

• Full Version: 1.0.0
• Assembly Version: 1.0.0.60000
• Informational Version: 1.0.0+Branch.main.Sha.a2154885d69f206b9b9d412e0e9cb59f7f3f6985
• Pre-release Tag: None
• Pre-release Number: 0
• Commits Since Version: 0
• Weighted Pre-release Number: 60000

🔗 Links

• Repository: owndev/Open-WebUI-Functions
• Issues: owndev/Open-WebUI-Functions/issues
• Discussions: owndev/Open-WebUI-Functions/discussions

🛠️ Build Information

• Workflow: 🏷️ GitHub Release
• Run ID: 23132851093
• Actor: @owndev

🐛 Support & Feedback

📋 Need Help?	🔗 Resource
🐛 Report Issues	owndev/Open-WebUI-Functions/issues
💬 Discussions	owndev/Open-WebUI-Functions/discussions
📚 Documentation	owndev/Open-WebUI-Functions/wiki

What's Changed

• [FIX] Support Including Model Name in Request Body for Single-Deployment Endpoints by @guoanhu12146 in [FIX] Support Including Model Name in Request Body for Single-Deployment Endpoints #3
• Add all azure models as pipes() by @LionsAd in Add all azure models as pipes() #5
• Remove azure_ai_foundry_deepseek.py (no longer needed) by @Phlogi in Remove azure_ai_foundry_deepseek.py (no longer needed) #9
• Add new function for Infomaniak AI Tools by @owndev in Add new function for Infomaniak AI Tools #8
• Add encryption for API Keys by @owndev in Add encryption for API Keys #11
• Add new Models by @ssweber in Add new Models #13
• 18 feature request multiple model support by @owndev in 18 feature request multiple model support #19
• 21 feature request reasoning effort and chain of thought with o4 mini by @owndev in 21 feature request reasoning effort and chain of thought with o4 mini #22
• 20 time tracker with log analytics azure by @owndev in 20 time tracker with log analytics azure #23
• Add event_emitter to Azure AI Foundry Pipeline by @ssweber in Add event_emitter to Azure AI Foundry Pipeline #29
• Add deepseek v3 0324 by @ssweber in Add deepseek v3 0324 #30
• Switch to the newer python-genai SDK and enable Vertex AI support by @olivier-lacroix in Switch to the newer python-genai SDK and enable Vertex AI support #32
• Fix copilot comments and format with ruff by @olivier-lacroix in Fix copilot comments and format with ruff #33
• pixi init, format and lint all by @olivier-lacroix in pixi init, format and lint all #34
• Add google search grounding by @olivier-lacroix in Add google search grounding #36
• Add native tool calling by @olivier-lacroix in Add native tool calling #37
• Hardcode frozen_kwargs to handle the case where bound_callable is already 'wrapped' by @olivier-lacroix in Hardcode frozen_kwargs to handle the case where bound_callable is already 'wrapped' #38
• Fix TypeError in generation config: incorrect tuple used in dict merge by @codeMonkey-shin in Fix TypeError in generation config: incorrect tuple used in dict merge #41
• Add in-text citations by @olivier-lacroix in Add in-text citations #39
• fix: Streaming in azure_ai_foundry.py by @owndev in fix: Streaming in azure_ai_foundry.py #55
• Added image generation to google_gemini.py by @owndev in Added image generation to google_gemini.py #57
• Added handling of PROHIBITED_CONTENT for image generation by @owndev in Added handling of PROHIBITED_CONTENT for image generation #58
• Add Azure Search / RAG Integration Support to Azure AI Foundry Pipeline by @Copilot in Add Azure Search / RAG Integration Support to Azure AI Foundry Pipeline #49
• fix: Multi-image uploads are ignored when using models identified as image generation capable by @owndev in fix: Multi-image uploads are ignored when using models identified as image generation capable #63
• Add ability to forward user headers and change gemini base url by @owndev in Add ability to forward user headers and change gemini base url #68
• fix: When using Azure AI Search, openwebui does not show citations/sources by @owndev in fix: When using Azure AI Search, openwebui does not show citations/sources #66
• Added streaming support to n8n by @owndev in Added streaming support to n8n #60
• feat(google/gemini): add THINKING/STREAMING env toggles by @owndev in feat(google/gemini): add THINKING/STREAMING env toggles #79
• UI display for N8N AI Agent tool usage in n8n.py (N8P Pipeline) by @owndev in UI display for N8N AI Agent tool usage in n8n.py (N8P Pipeline) #76
• fix(google/gemini): Thinking != include_thoughts by @owndev in fix(google/gemini): Thinking != include_thoughts #83
• Fix Azure AI Foundry citations: filter unreferenced, handle empty fields by @Copilot in Fix Azure AI Foundry citations: filter unreferenced, handle empty fields #85
• Remove tool wrapper by @olivier-lacroix in Remove tool wrapper #88
• Fix native mode detection by @olivier-lacroix in Fix native mode detection #89
• Fix merge issue and exclude private methods by @olivier-lacroix in Fix merge issue and exclude private methods #90
• Add Vertex AI Search grounding by @aug6th in Add Vertex AI Search grounding #94
• Add thinking levels and budgets support for Gemini models by @Copilot in Add thinking levels and budgets support for Gemini models #107
• Add default system prompt and per-chat reasoning effort override to Google Gemini pipeline by @Copilot in Add default system prompt and per-chat reasoning effort override to Google Gemini pipeline #108
• Fix streaming prompt-feedback handling by @nahoj in Fix streaming prompt-feedback handling #110
• Add user info headers forwarding option by @rahxam in Add user info headers forwarding option #111
• Add user info headers forwarding option by @owndev in Add user info headers forwarding option #113
• Fix Gemini streaming response not persisted when leaving chat by @Copilot in Fix Gemini streaming response not persisted when leaving chat #114
• Add URL context to google search by @olivier-lacroix in Add URL context to google search #115
• Some dead code removal by @olivier-lacroix in Some dead code removal #116
• fix: fix the incorrect file retrieval method to obtain files from S3 by @ShirasawaSama in fix: fix the incorrect file retrieval method to obtain files from S3 #118
• Add configurable aspect ratio and resolution for Gemini 3 image generation by @Copilot in Add configurable aspect ratio and resolution for Gemini 3 image generation #120
• Add native OpenWebUI citation support for Azure AI Search responses by @Copilot in Add native OpenWebUI citation support for Azure AI Search responses #101
• Add a model whitelist Valve by @olivier-lacroix in Add a model whitelist Valve #125
• fix(infomaniak.py): update version to 2.1.0 and adjust API URL endpoints by @owndev in fix(infomaniak.py): update version to 2.1.0 and adjust API URL endpoints #128
• fix: update version numbers and improve logging level handling by @owndev in fix: update version numbers and improve logging level handling #130
• Add MODEL_ADDITIONAL and MODEL_WHITELIST for Google Gemini pipeline by @Copilot in Add MODEL_ADDITIONAL and MODEL_WHITELIST for Google Gemini pipeline #132
• fix(google_gemini.py): Update thinking level options to include 'minimal' and 'medium' by @owndev in fix(google_gemini.py): Update thinking level options to include 'minimal' and 'medium' #134
• Open WebUI v0.8.x enhancements by @owndev in Open WebUI v0.8.x enhancements #146
• Add support for Gemini Veo models by @owndev in Add support for Gemini Veo models #147
• Support for Enterprise Web Search Grounding in Google Gemini Pipeline by @olivier-lacroix in Support for Enterprise Web Search Grounding in Google Gemini Pipeline #148
• Enhance Google Gemini pipeline for model compatibility and validation by @owndev in Enhance Google Gemini pipeline for model compatibility and validation #151
• Enhance GitHub workflows and update issue templates and README by @owndev in Enhance GitHub workflows and update issue templates and README #153

New Contributors

• @guoanhu12146 made their first contribution in [FIX] Support Including Model Name in Request Body for Single-Deployment Endpoints #3
• @LionsAd made their first contribution in Add all azure models as pipes() #5
• @Phlogi made their first contribution in Remove azure_ai_foundry_deepseek.py (no longer needed) #9
• @owndev made their first contribution in Add new function for Infomaniak AI Tools #8
• @ssweber made their first contribution in Add new Models #13
• @olivier-lacroix made their first contribution in Switch to the newer python-genai SDK and enable Vertex AI support #32
• @codeMonkey-shin made their first contribution in Fix TypeError in generation config: incorrect tuple used in dict merge #41
• @Copilot made their first contribution in Add Azure Search / RAG Integration Support to Azure AI Foundry Pipeline #49
• @aug6th made their first contribution in Add Vertex AI Search grounding #94
• @nahoj made their first contribution in Fix streaming prompt-feedback handling #110
• @ShirasawaSama made their first contribution in fix: fix the incorrect file retrieval method to obtain files from S3 #118

Full Changelog: https://github.com/owndev/Open-WebUI-Functions/commits/v1.0.0

---

This discussion was created from the release v1.0.0.