v0.3.0.2

OpenBMB/UltraRAGv0.3.0.2Apr 9, 2026by xhd0728

AI Summary

This major release delivers an end-to-end memory system for UltraRAG with persistent user memory, project memory retrieval, and a dedicated memory-aware RAG demo. It also introduces SQLite-backed authentication, persistent chat sessions, nickname/model settings management, and knowledge base visibility controls. The frontend is substantially refreshed with React/Vite, a new Explore section, and mobile optimization.

Key Highlights

  • End-to-end memory system with persistent user memory and project memory retrieval
  • SQLite-backed authentication with persistent chat sessions and user settings management
  • Knowledge base visibility controls supporting public, private, and shared access
  • Frontend overhaul with React/Vite, new Explore section, and mobile responsiveness
  • Engineering fixes for async retriever initialization and FastMCP 3.x compatibility

New Features

  • Persistent user memory and project memory retrieval
  • Memory-aware RAG demo
  • SQLite-backed authentication system
  • Persistent chat sessions
  • Nickname and model settings management
  • Knowledge base visibility controls (public/private/shared)
  • React/Vite frontend refactor
  • Explore section
  • Mobile optimization
  • Source-detail interaction improvements
  • Async retriever initialization fix
  • FastMCP 3.x compatibility guards
  • CI smoke checks for SayHello pipeline and frontend build
  • Structured troubleshooting guide
  • Backend and frontend dependency updates

Full Release Notes

Release date: 2026.4.9

## Highlights

This release delivers a major end-to-end memory upgrade for UltraRAG, introducing persistent user memory, project memory retrieval, and a dedicated memory-aware RAG demo. It also makes the demo experience significantly more stateful and personalized with SQLite-backed authentication, persistent chat sessions, nickname and model settings management, and knowledge base visibility controls supporting public, private, and shared access.

The frontend is substantially refreshed through a React/Vite-based overhaul, the new Explore section, improved source-detail interactions, and a mobile optimization baseline. We also improve engineering robustness by fixing an async retriever initialization issue, adding compatibility guards for FastMCP 3.x-related builder changes and demo runtime cleanup, introducing CI smoke checks for the SayHello pipeline and frontend build, and adding a structured troubleshooting guide, alongside a broad round of backend and frontend dependency maintenance.

## What's Changed

1. Add an end-to-end memory system with persistent user memory, project memory retrieval, and a dedicated memory-aware RAG demo. by @mssssss123 in #379

2. Add SQLite-backed authentication, persistent chat sessions, nickname/model settings management, and knowledge base visibility controls. by @mssssss123 in #379

3. Refactor the frontend with React/Vite, add the Explore section, and improve mobile responsiveness and source-detail interactions. by @mssssss123 in #379

4. Fix async retriever initialization by awaiting retriever_init(...) during startup. by @xhd0728 in #385

5. Fix builder compatibility issues caused by FastMCP 3.x API changes, and harden demo runtime handling around closed-event-loop cleanup noise and backend overrides. by @xhd0728 in #388

6. Add CI smoke checks for the SayHello pipeline and frontend build, then refine the workflow tooling and installation examples. by @xhd0728 in #389 and #390

7. Add a structured troubleshooting guide for UltraRAG workflows. by @onestardao in #352

8. Update README publications and model references. by @xhd0728 in #359

9. Refresh backend and frontend dependencies, including Gradio, vLLM, pypdf, pyjwt, cbor2, cryptography, aiohttp, requests, authlib, orjson, tornado, NLTK, and several frontend packages. by @dependabot in #354, #355, #357, #360, #366, #368, #369, #371, #373, #376, #377, #380, #381, #382, #383, #384, #386, and #387