Open WebUI: zo begin je thuis zonder gedoe

Open WebUI 0.9.1 fixt twee zware startfouten

open WebUI 0.9.1 lost twee fouten op die bij het opstarten voor problemen konden zorgen. het gaat om de missende aiosqlite en asyncpg afhankelijkheid. De release staat hier: https://github.com/open-webui/open-webui/releases/tag/v0.9.1

Als je Open webui via pip of uv installeert, kon het gebeuren dat het programma meteen stopte met een fout. Dan zag je iets als: ModuleNotFoundError: No module named 'aiosqlite'.Dat probleem is nu opgelost door aiosqlite toe te voegen aan pyproject.toml.

Ook voor mensen die PostgreSQL gebruiken was er hetzelfde soort startfout. Daarvoor is asyncpg nu ook toegevoegd aan pyproject.toml. Twee simpele missers, maar wel missers die hard konden bijten. 🫣

Wat was het probleem?

De bron zegt dat deze pakketten wel in requirements.txt stonden, maar niet in de gepubliceerde package-info. Daardoor werden ze niet vanzelf meegeïnstalleerd. Open WebUI miste ze dus bij het opstarten.

Dat is voor een gebruiker vooral vervelend op één heel duidelijk punt: je zet de app aan, maar hij komt niet goed op gang. In plaats van een scherm met Open WebUI krijg je een crash of foutmelding.

Wat zag je dan op je scherm?

Meestal zag je niet een nette app,maar een melding dat een module niet gevonden werd. De bron noemt deze fout heel letterlijk voor één van de gevallen: ModuleNotFoundError: No module named 'aiosqlite'.

Dat is lastig, maar de uitleg is simpel:

  • de app zoekt een hulpprogramma;
  • dat hulpprogramma is niet meegekomen;
  • het starten stopt meteen.

Waarom is deze update handig?

Deze update helpt vooral mensen die Open WebUI thuis zelf willen starten op een pc of laptop. Je hoeft dan minder te puzzelen met spullen die “wel in een lijst staan” maar toch niet echt worden geïnstalleerd.

Dat voelt klein, maar het scheelt veel gedoe.Je wilt gewoon dat de app start en werkt. Niet eerst in foutmeldingen graven als een bever in een natte oever.

Ook PostgreSQL-gebruikers zijn hiermee geholpen. Voor hen was asyncpg de missende schakel. Nu staat dat pakket wel goed in de package-info.

Zo probeer je het zelf

Je hoeft voor deze update geen ingewikkeld experiment te doen. Het gaat vooral om opnieuw installeren of updaten en dan kijken of Open WebUI weer normaal start.

Een simpele aanpak:

  1. Werk Open WebUI bij naar versie 0.9.1.
  2. Start het daarna opnieuw.
  3. Kijk of de app zonder startfout opent.
  4. Gebruik je PostgreSQL? Check dan ook of die start nu doorloopt.

Als alles goed gaat, zie je gewoon het normale scherm van open WebUI. Geen crashmelding, geen “module not found”, maar gewoon de app die verder wil.

voor wie is dit vooral bedoeld?

Deze fix is vooral voor mensen die Open WebUI zelf installeren met pip of uv. De bron noemt die twee manieren, dus daar zit ook het probleem.

Handig om even grof te bekijken:

SituatieWat was het risico?Wat doet 0.9.1?
Installatie via pipStart kon crashen door missende aiosqliteaiosqlite is toegevoegd
Installatie via uvStart kon crashen door missende aiosqliteaiosqlite is toegevoegd
PostgreSQL gebruikStart kon crashen door missende asyncpgasyncpg is toegevoegd

Zo zie je snel waar deze update helpt. Het zijn geen nieuwe snufjes, maar wel belangrijke herstelpunten.

Kleine test die je thuis kunt doen

Als je wilt checken of de update werkt, houd het dan simpel. Je hebt geen bijzondere tools nodig.

Mini-stappenplan

  • Open je gewone terminal.
  • Update naar Open WebUI 0.9.1.
  • Start de app opnieuw.
  • Kijk of je direct verder komt zonder foutmelding.
  • Gebruik je PostgreSQL, test dan ook die verbinding of start.

Zie je nog steeds een fout? Dan zit het probleem mogelijk ergens anders. Maar deze release haalt in elk geval deze twee bekende startproblemen weg.

Dit ging er mis in de pakketlijst

De bron legt iets belangrijks uit: de pakketten stonden wel in requirements.txt, maar niet in de gepubliceerde package metadata.In gewone taal: de lijst voor ontwikkelaars kende ze wel, maar het pakket dat mensen installeren niet goed genoeg.

daardoor kon open WebUI denken dat alles klaar stond,terwijl dat in de praktijk niet zo was. De update zet dat nu recht in pyproject.toml.

Dat is niet spannend om naar te kijken, maar wel belangrijk. Want vaak gaat software niet stuk door iets groots,maar door zo’n klein hiaat in de voorbereiding.

Nog even dit

Dit is geen nieuwe functie-update, maar een stevige foutfix. en dat is soms precies wat je nodig hebt. Een scherm dat gewoon opent,voelt veel fijner dan een tool die meteen struikelt over een missend pakket.

Voor thuisgebruik is dit dus vooral fijn als je open WebUI zelf draait en je vastliep bij het starten. Werk bij naar 0.9.1, start opnieuw en kijk of de fout weg is. Klein stapje, groot verschil. 🦫

Wil je hier nog even mee verder spelen? Kijk dan ook eens naar Open WebUI thuis proberen: lokale AI in je browser.

Bevers gedachte

Soms is de beste update niet iets dat erbij komt, maar iets dat eindelijk gewoon goed staat. Open WebUI 0.9.1 zorgt ervoor dat twee missende onderdelen echt mee worden genomen,zodat het starten minder snel misgaat.

Dat scheelt gezoek, scheelt foutmeldingen en scheelt een hoop “waarom doet hij dit nou?”. en daar worden mensen thuis blij van.