github-starred/open-webui
2
0
Fork 0
mirror of https://github.com/open-webui/open-webui.git synced 2026-05-06 02:48:13 -05:00
Code Issues 1.1k Packages Projects Releases 126 Wiki Activity

[GH-ISSUE #23063] issue: Update openwebui -> now Error on start "bs4 module missing" [python 3.12] #19877

New Issue
Closed
opened 2026-04-20 02:24:30 -05:00 by GiteaMirror · 5 comments
GiteaMirror commented 2026-04-20 02:24:30 -05:00
Owner
Copy Link

Originally created by @4lexRed on GitHub (Mar 26, 2026).
Original GitHub issue: https://github.com/open-webui/open-webui/issues/23063

Check Existing Issues

  • I have searched for any existing and/or related issues.
  • I have searched for any existing and/or related discussions.
  • I have also searched in the CLOSED issues AND CLOSED discussions and found no related items (your issue might already be addressed on the development branch!).
  • I am using the latest version of Open WebUI.

Installation Method

Other

Open WebUI Version

0.8.11

Ollama Version (if applicable)

No response

Operating System

Ubuntu 22.04

Browser (if applicable)

No response

Confirmation

  • I have read and followed all instructions in README.md.
  • I am using the latest version of both Open WebUI and Ollama.
  • I have included the browser console logs.
  • I have included the Docker container logs.
  • I have provided every relevant configuration, setting, and environment variable used in my setup.
  • I have clearly listed every relevant configuration, custom setting, environment variable, and command-line option that influences my setup (such as Docker Compose overrides, .env values, browser settings, authentication configurations, etc).
  • I have documented step-by-step reproduction instructions that are precise, sequential, and leave nothing to interpretation. My steps:
  • Start with the initial platform/version/OS and dependencies used,
  • Specify exact install/launch/configure commands,
  • List URLs visited, user input (incl. example values/emails/passwords if needed),
  • Describe all options and toggles enabled or changed,
  • Include any files or environmental changes,
  • Identify the expected and actual result at each stage,
  • Ensure any reasonably skilled user can follow and hit the same issue.

Expected Behavior

Running
DATA_DIR=~/.open-webui /home/MYUSER/.local/bin/uvx --python 3.12 open-webui@latest serve
starts the openwebui

Actual Behavior

I get an error messager saying
ModuleNotFoundError: No module named 'bs4'

referencing this file that requests the bs4 pacakge

/.cache/uv/archive-v0/sRH1ZqGL6AtKP5_1XHdtm/lib/python3.12/site-packages/open_web
│ ui/env.py:18 in
│
│ 15
│ 16
│ 17 import markdown
│ ❱ 18 from bs4 import BeautifulSoup
│ 19 from open_webui.constants import ERROR_MESSAGES
│ 20

Steps to Reproduce

I cleaned the UV cache.
Tried to start "the tool" with uv again
DATA_DIR=~/.open-webui /home/MYUSER/.local/bin/uvx --python 3.12 open-webui@latest serve
-> still the same error message.

Then reinstalling the tool with
uv tool install --python 3.12 --force open-webui@latest
(I had to force it, as open-webui was already installed)

shows that the bs4 (beautiful soup) is not integrated in the requirements of the openwebui-package.

Here is the alphabetical sorted list of packages starting with the letter B

  • azure-identity==1.25.2
  • azure-storage-blob==12.28.0
  • backoff==2.2.1
  • bcrypt==5.0.0
  • bidict==0.23.1
  • black==26.1.0
  • boto3==1.42.62
  • botocore==1.42.76
  • brotli==1.1.0
  • build==1.4.2
  • certifi==2026.2.25
  • cffi==2.0.0

Logs & Screenshots

Image

Additional Information

Seems like when bs4 was integrated into the openwebui uv-package, someone forgot to update the required package list for python 3.12

The workaround to install bs4 with pip systemwide is not working, as my python is managed by the OS.
I might be able to force the system to install bs4 by passing the --break-system-packages flag, but I rather see the package list for the uv-package fixed.

Originally created by @4lexRed on GitHub (Mar 26, 2026). Original GitHub issue: https://github.com/open-webui/open-webui/issues/23063 ### Check Existing Issues - [x] I have searched for any existing and/or related issues. - [x] I have searched for any existing and/or related discussions. - [x] I have also searched in the CLOSED issues AND CLOSED discussions and found no related items (your issue might already be addressed on the development branch!). - [x] I am using the latest version of Open WebUI. ### Installation Method Other ### Open WebUI Version 0.8.11 ### Ollama Version (if applicable) _No response_ ### Operating System Ubuntu 22.04 ### Browser (if applicable) _No response_ ### Confirmation - [x] I have read and followed all instructions in `README.md`. - [x] I am using the latest version of **both** Open WebUI and Ollama. - [x] I have included the browser console logs. - [x] I have included the Docker container logs. - [x] I have **provided every relevant configuration, setting, and environment variable used in my setup.** - [x] I have clearly **listed every relevant configuration, custom setting, environment variable, and command-line option that influences my setup** (such as Docker Compose overrides, .env values, browser settings, authentication configurations, etc). - [x] I have documented **step-by-step reproduction instructions that are precise, sequential, and leave nothing to interpretation**. My steps: - Start with the initial platform/version/OS and dependencies used, - Specify exact install/launch/configure commands, - List URLs visited, user input (incl. example values/emails/passwords if needed), - Describe all options and toggles enabled or changed, - Include any files or environmental changes, - Identify the expected and actual result at each stage, - Ensure any reasonably skilled user can follow and hit the same issue. ### Expected Behavior Running `DATA_DIR=~/.open-webui /home/MYUSER/.local/bin/uvx --python 3.12 open-webui@latest serve` starts the openwebui ### Actual Behavior I get an error messager saying ModuleNotFoundError: No module named 'bs4' referencing this file that requests the bs4 pacakge /.cache/uv/archive-v0/sRH1ZqGL6AtKP5_1XHdtm/lib/python3.12/site-packages/open_web │ ui/env.py:18 in <module> │ │ 15 │ 16 │ 17 import markdown │ ❱ 18 from bs4 import BeautifulSoup │ 19 from open_webui.constants import ERROR_MESSAGES │ 20 ### Steps to Reproduce I cleaned the UV cache. Tried to start "the tool" with uv again `DATA_DIR=~/.open-webui /home/MYUSER/.local/bin/uvx --python 3.12 open-webui@latest serve` -> still the same error message. Then reinstalling the tool with `uv tool install --python 3.12 --force open-webui@latest` (I had to force it, as open-webui was already installed) shows that the bs4 (beautiful soup) is not integrated in the requirements of the openwebui-package. Here is the alphabetical sorted list of packages starting with the letter B + azure-identity==1.25.2 + azure-storage-blob==12.28.0 + backoff==2.2.1 + bcrypt==5.0.0 + bidict==0.23.1 + black==26.1.0 + boto3==1.42.62 + botocore==1.42.76 + brotli==1.1.0 + build==1.4.2 + certifi==2026.2.25 + cffi==2.0.0 ### Logs & Screenshots <img width="945" height="959" alt="Image" src="https://github.com/user-attachments/assets/05f93e11-3343-47a5-9fea-0c7dd5738261" /> ### Additional Information Seems like when bs4 was integrated into the openwebui uv-package, someone forgot to update the required package list for python 3.12 The workaround to install bs4 with pip systemwide is not working, as my python is managed by the OS. I might be able to force the system to install bs4 by passing the --break-system-packages flag, but I rather see the package list for the uv-package fixed.
GiteaMirror added the bug label 2026-04-20 02:24:30 -05:00
GiteaMirror commented 2026-04-20 02:24:35 -05:00
Author
Owner
Copy Link

@4lexRed commented on GitHub (Mar 26, 2026):

Tried to downgrade by
uv tool install --python 3.12 open-webui@0.8.10

or

uv tool install --python 3.12 open-webui@0.8.9

both commands gave me this error message:

  × No solution found when resolving dependencies:
  ╰─▶ Because there is no version of ddgs==9.11.2 and open-webui==0.8.10 depends on ddgs==9.11.2,
      we can conclude that open-webui==0.8.10 cannot be used.
      And because you require open-webui==0.8.10, we can conclude that your requirements are
      unsatisfiable.

Only with
uv tool uninstall open-webui
uv cache clean
uv tool install --python 3.12 open-webui@0.8.8

I was able to get open-webui up and running again.

<!-- gh-comment-id:4132032010 --> @4lexRed commented on GitHub (Mar 26, 2026): Tried to downgrade by `uv tool install --python 3.12 open-webui@0.8.10` or `uv tool install --python 3.12 open-webui@0.8.9` both commands gave me this error message: ``` × No solution found when resolving dependencies: ╰─▶ Because there is no version of ddgs==9.11.2 and open-webui==0.8.10 depends on ddgs==9.11.2, we can conclude that open-webui==0.8.10 cannot be used. And because you require open-webui==0.8.10, we can conclude that your requirements are unsatisfiable. ``` - - - - Only with `uv tool uninstall open-webui` `uv cache clean` `uv tool install --python 3.12 open-webui@0.8.8` I was able to get open-webui up and running again.
GiteaMirror commented 2026-04-20 02:24:36 -05:00
Author
Owner
Copy Link

@Golotvinov commented on GitHub (Mar 26, 2026):

Can confirm I have the same problem when trying to start Open WebUI using uvx. Version 0.8.10 couldn't start because of a bad ddgs library version (?) and 0.8.11 doesn't start because of "bs4 module missing".

It's been almost 4 weeks since I was able to use OWUI ...

<!-- gh-comment-id:4136815629 --> @Golotvinov commented on GitHub (Mar 26, 2026): Can confirm I have the same problem when trying to start Open WebUI using uvx. Version 0.8.10 couldn't start because of a bad ddgs library version (?) and 0.8.11 doesn't start because of "bs4 module missing". It's been almost 4 weeks since I was able to use OWUI ...
GiteaMirror commented 2026-04-20 02:24:37 -05:00
Author
Owner
Copy Link

@Gabelloide commented on GitHub (Mar 26, 2026):

Same problem using uvx and python 3.11

<!-- gh-comment-id:4137184554 --> @Gabelloide commented on GitHub (Mar 26, 2026): Same problem using uvx and python 3.11
GiteaMirror commented 2026-04-20 02:24:37 -05:00
Author
Owner
Copy Link

@jvdneste commented on GitHub (Mar 26, 2026):

Same issue on ubuntu 24.04 in a Python 3.12.3 venv. I did pip install open-webui followed by open-webui serve

<!-- gh-comment-id:4138476716 --> @jvdneste commented on GitHub (Mar 26, 2026): Same issue on ubuntu 24.04 in a Python 3.12.3 venv. I did `pip install open-webui` followed by `open-webui serve`
GiteaMirror commented 2026-04-20 02:24:39 -05:00
Author
Owner
Copy Link

@Classic298 commented on GitHub (Mar 26, 2026):

fixed in dev

1994d65306

<!-- gh-comment-id:4138887392 --> @Classic298 commented on GitHub (Mar 26, 2026): fixed in dev https://github.com/open-webui/open-webui/commit/1994d65306bbcc7406584e1bfef82f5d353fc91c
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
bug
confirmed
confirmed issue
core
documentation
enhancement
good first issue
help wanted
non-core
pull-request
Mirrored from GitHub Pull Request
 python
question
testing wanted
No Label bug
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
GiteaMirror ninjasurge
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/open-webui#19877
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?