mirror of
https://github.com/open-webui/open-webui.git
synced 2026-05-06 19:08:59 -05:00
[GH-ISSUE #16556] issue: Dependency conflict with @tiptap/core prevents clean installation without --force #33486
Reference in New Issue
Block a user
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?
Originally created by @Miensoap on GitHub (Aug 13, 2025).
Original GitHub issue: https://github.com/open-webui/open-webui/issues/16556
Check Existing Issues
Installation Method
Git Clone
Open WebUI Version
v0.6.22
Ollama Version (if applicable)
No response
Operating System
macOS sequoia
Browser (if applicable)
No response
Confirmation
README.md.Expected Behavior
When running npm ci or npm install in the project's root directory for local development,
the command should complete successfully without any dependency resolution errors.
Actual Behavior
The npm ci command fails with an ERESOLVE error due to a peer dependency conflict with @tiptap/core.
The conflict arises because most @tiptap/* packages (like @tiptap/starter-kit) require @tiptap/core@^3.0.7, while @tiptap/extension-bubble-menu requires an older, incompatible version (@tiptap/core@^2.7.0).
This forces local developers to use --force or --legacy-peer-deps to install dependencies, which can lead to a potentially unstable setup. The official Docker build bypasses this issue by using the --force flag, but this hides the underlying dependency problem.
Steps to Reproduce
Clone the repository: git clone https://github.com/open-webui/open-webui.git
Navigate to the project directory: cd open-webui
Attempt to install dependencies cleanly: npm ci
Observe the ERESOLVE error in the console.
Logs & Screenshots
Additional Information
This issue appears to be a leftover from the migration from Tiptap v2 to v3.
Updating @tiptap/extension-bubble-menu to a version compatible with @tiptap/core@^3.0.0 should resolve this conflict and allow for a clean installation.
For example, running npm install @tiptap/extension-bubble-menu@latest resolves the conflict locally.
It would be beneficial to update this in the project's package.json for all developers.
@tjbck commented on GitHub (Aug 13, 2025):
PLEASE check for existing issue before creating a new one #15880