github-actions[bot] commited on
Commit
e400ad0
0 Parent(s):

GitHub deploy: e3ca77d1dd9a06885e852bda35fc3003e93db267

Browse files
This view is limited to 50 files because it contains too many changes.   See raw diff
Files changed (50) hide show
  1. .dockerignore +20 -0
  2. .env.example +13 -0
  3. .eslintignore +13 -0
  4. .eslintrc.cjs +31 -0
  5. .gitattributes +3 -0
  6. .github/FUNDING.yml +1 -0
  7. .github/ISSUE_TEMPLATE/bug_report.md +80 -0
  8. .github/ISSUE_TEMPLATE/feature_request.md +35 -0
  9. .github/dependabot.yml +12 -0
  10. .github/pull_request_template.md +72 -0
  11. .github/workflows/build-release.yml +72 -0
  12. .github/workflows/deploy-to-hf-spaces.yml +63 -0
  13. .github/workflows/docker-build.yaml +477 -0
  14. .github/workflows/format-backend.yaml +39 -0
  15. .github/workflows/format-build-frontend.yaml +57 -0
  16. .github/workflows/integration-test.yml +253 -0
  17. .github/workflows/lint-backend.disabled +27 -0
  18. .github/workflows/lint-frontend.disabled +21 -0
  19. .github/workflows/release-pypi.yml +32 -0
  20. .gitignore +310 -0
  21. .npmrc +1 -0
  22. .prettierignore +316 -0
  23. .prettierrc +9 -0
  24. CHANGELOG.md +1314 -0
  25. CODE_OF_CONDUCT.md +77 -0
  26. Caddyfile.localhost +64 -0
  27. Dockerfile +176 -0
  28. INSTALLATION.md +35 -0
  29. LICENSE +21 -0
  30. Makefile +33 -0
  31. README.md +221 -0
  32. TROUBLESHOOTING.md +36 -0
  33. backend/.dockerignore +14 -0
  34. backend/.gitignore +12 -0
  35. backend/dev.sh +2 -0
  36. backend/open_webui/__init__.py +77 -0
  37. backend/open_webui/alembic.ini +114 -0
  38. backend/open_webui/apps/audio/main.py +713 -0
  39. backend/open_webui/apps/images/main.py +609 -0
  40. backend/open_webui/apps/images/utils/comfyui.py +186 -0
  41. backend/open_webui/apps/ollama/main.py +1326 -0
  42. backend/open_webui/apps/openai/main.py +720 -0
  43. backend/open_webui/apps/retrieval/loaders/main.py +190 -0
  44. backend/open_webui/apps/retrieval/loaders/youtube.py +98 -0
  45. backend/open_webui/apps/retrieval/main.py +1486 -0
  46. backend/open_webui/apps/retrieval/models/colbert.py +81 -0
  47. backend/open_webui/apps/retrieval/utils.py +572 -0
  48. backend/open_webui/apps/retrieval/vector/connector.py +22 -0
  49. backend/open_webui/apps/retrieval/vector/dbs/chroma.py +174 -0
  50. backend/open_webui/apps/retrieval/vector/dbs/milvus.py +286 -0
.dockerignore ADDED
@@ -0,0 +1,20 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ .github
2
+ .DS_Store
3
+ docs
4
+ kubernetes
5
+ node_modules
6
+ /.svelte-kit
7
+ /package
8
+ .env
9
+ .env.*
10
+ vite.config.js.timestamp-*
11
+ vite.config.ts.timestamp-*
12
+ __pycache__
13
+ .idea
14
+ venv
15
+ _old
16
+ uploads
17
+ .ipynb_checkpoints
18
+ **/*.db
19
+ _test
20
+ backend/data/*
.env.example ADDED
@@ -0,0 +1,13 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Ollama URL for the backend to connect
2
+ # The path '/ollama' will be redirected to the specified backend URL
3
+ OLLAMA_BASE_URL='http://localhost:11434'
4
+
5
+ OPENAI_API_BASE_URL=''
6
+ OPENAI_API_KEY=''
7
+
8
+ # AUTOMATIC1111_BASE_URL="http://localhost:7860"
9
+
10
+ # DO NOT TRACK
11
+ SCARF_NO_ANALYTICS=true
12
+ DO_NOT_TRACK=true
13
+ ANONYMIZED_TELEMETRY=false
.eslintignore ADDED
@@ -0,0 +1,13 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ .DS_Store
2
+ node_modules
3
+ /build
4
+ /.svelte-kit
5
+ /package
6
+ .env
7
+ .env.*
8
+ !.env.example
9
+
10
+ # Ignore files for PNPM, NPM and YARN
11
+ pnpm-lock.yaml
12
+ package-lock.json
13
+ yarn.lock
.eslintrc.cjs ADDED
@@ -0,0 +1,31 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ module.exports = {
2
+ root: true,
3
+ extends: [
4
+ 'eslint:recommended',
5
+ 'plugin:@typescript-eslint/recommended',
6
+ 'plugin:svelte/recommended',
7
+ 'plugin:cypress/recommended',
8
+ 'prettier'
9
+ ],
10
+ parser: '@typescript-eslint/parser',
11
+ plugins: ['@typescript-eslint'],
12
+ parserOptions: {
13
+ sourceType: 'module',
14
+ ecmaVersion: 2020,
15
+ extraFileExtensions: ['.svelte']
16
+ },
17
+ env: {
18
+ browser: true,
19
+ es2017: true,
20
+ node: true
21
+ },
22
+ overrides: [
23
+ {
24
+ files: ['*.svelte'],
25
+ parser: 'svelte-eslint-parser',
26
+ parserOptions: {
27
+ parser: '@typescript-eslint/parser'
28
+ }
29
+ }
30
+ ]
31
+ };
.gitattributes ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ *.sh text eol=lf
2
+ *.ttf filter=lfs diff=lfs merge=lfs -text
3
+ *.jpg filter=lfs diff=lfs merge=lfs -text
.github/FUNDING.yml ADDED
@@ -0,0 +1 @@
 
 
1
+ github: tjbck
.github/ISSUE_TEMPLATE/bug_report.md ADDED
@@ -0,0 +1,80 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ name: Bug report
3
+ about: Create a report to help us improve
4
+ title: ''
5
+ labels: ''
6
+ assignees: ''
7
+ ---
8
+
9
+ # Bug Report
10
+
11
+ ## Important Notes
12
+
13
+ - **Before submitting a bug report**: Please check the Issues or Discussions section to see if a similar issue or feature request has already been posted. It's likely we're already tracking it! If you’re unsure, start a discussion post first. This will help us efficiently focus on improving the project.
14
+
15
+ - **Collaborate respectfully**: We value a constructive attitude, so please be mindful of your communication. If negativity is part of your approach, our capacity to engage may be limited. We’re here to help if you’re open to learning and communicating positively. Remember, Open WebUI is a volunteer-driven project managed by a single maintainer and supported by contributors who also have full-time jobs. We appreciate your time and ask that you respect ours.
16
+
17
+ - **Contributing**: If you encounter an issue, we highly encourage you to submit a pull request or fork the project. We actively work to prevent contributor burnout to maintain the quality and continuity of Open WebUI.
18
+
19
+ - **Bug reproducibility**: If a bug cannot be reproduced with a `:main` or `:dev` Docker setup, or a pip install with Python 3.11, it may require additional help from the community. In such cases, we will move it to the "issues" Discussions section due to our limited resources. We encourage the community to assist with these issues. Remember, it’s not that the issue doesn’t exist; we need your help!
20
+
21
+ Note: Please remove the notes above when submitting your post. Thank you for your understanding and support!
22
+
23
+ ---
24
+
25
+ ## Installation Method
26
+
27
+ [Describe the method you used to install the project, e.g., git clone, Docker, pip, etc.]
28
+
29
+ ## Environment
30
+
31
+ - **Open WebUI Version:** [e.g., v0.3.11]
32
+ - **Ollama (if applicable):** [e.g., v0.2.0, v0.1.32-rc1]
33
+
34
+ - **Operating System:** [e.g., Windows 10, macOS Big Sur, Ubuntu 20.04]
35
+ - **Browser (if applicable):** [e.g., Chrome 100.0, Firefox 98.0]
36
+
37
+ **Confirmation:**
38
+
39
+ - [ ] I have read and followed all the instructions provided in the README.md.
40
+ - [ ] I am on the latest version of both Open WebUI and Ollama.
41
+ - [ ] I have included the browser console logs.
42
+ - [ ] I have included the Docker container logs.
43
+ - [ ] I have provided the exact steps to reproduce the bug in the "Steps to Reproduce" section below.
44
+
45
+ ## Expected Behavior:
46
+
47
+ [Describe what you expected to happen.]
48
+
49
+ ## Actual Behavior:
50
+
51
+ [Describe what actually happened.]
52
+
53
+ ## Description
54
+
55
+ **Bug Summary:**
56
+ [Provide a brief but clear summary of the bug]
57
+
58
+ ## Reproduction Details
59
+
60
+ **Steps to Reproduce:**
61
+ [Outline the steps to reproduce the bug. Be as detailed as possible.]
62
+
63
+ ## Logs and Screenshots
64
+
65
+ **Browser Console Logs:**
66
+ [Include relevant browser console logs, if applicable]
67
+
68
+ **Docker Container Logs:**
69
+ [Include relevant Docker container logs, if applicable]
70
+
71
+ **Screenshots/Screen Recordings (if applicable):**
72
+ [Attach any relevant screenshots to help illustrate the issue]
73
+
74
+ ## Additional Information
75
+
76
+ [Include any additional details that may help in understanding and reproducing the issue. This could include specific configurations, error messages, or anything else relevant to the bug.]
77
+
78
+ ## Note
79
+
80
+ If the bug report is incomplete or does not follow the provided instructions, it may not be addressed. Please ensure that you have followed the steps outlined in the README.md and troubleshooting.md documents, and provide all necessary information for us to reproduce and address the issue. Thank you!
.github/ISSUE_TEMPLATE/feature_request.md ADDED
@@ -0,0 +1,35 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ name: Feature request
3
+ about: Suggest an idea for this project
4
+ title: ''
5
+ labels: ''
6
+ assignees: ''
7
+ ---
8
+
9
+ # Feature Request
10
+
11
+ ## Important Notes
12
+
13
+ - **Before submitting a report**: Please check the Issues or Discussions section to see if a similar issue or feature request has already been posted. It's likely we're already tracking it! If you’re unsure, start a discussion post first. This will help us efficiently focus on improving the project.
14
+
15
+ - **Collaborate respectfully**: We value a constructive attitude, so please be mindful of your communication. If negativity is part of your approach, our capacity to engage may be limited. We’re here to help if you’re open to learning and communicating positively. Remember, Open WebUI is a volunteer-driven project managed by a single maintainer and supported by contributors who also have full-time jobs. We appreciate your time and ask that you respect ours.
16
+
17
+ - **Contributing**: If you encounter an issue, we highly encourage you to submit a pull request or fork the project. We actively work to prevent contributor burnout to maintain the quality and continuity of Open WebUI.
18
+
19
+ - **Bug reproducibility**: If a bug cannot be reproduced with a `:main` or `:dev` Docker setup, or a pip install with Python 3.11, it may require additional help from the community. In such cases, we will move it to the "issues" Discussions section due to our limited resources. We encourage the community to assist with these issues. Remember, it’s not that the issue doesn’t exist; we need your help!
20
+
21
+ Note: Please remove the notes above when submitting your post. Thank you for your understanding and support!
22
+
23
+ ---
24
+
25
+ **Is your feature request related to a problem? Please describe.**
26
+ A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
27
+
28
+ **Describe the solution you'd like**
29
+ A clear and concise description of what you want to happen.
30
+
31
+ **Describe alternatives you've considered**
32
+ A clear and concise description of any alternative solutions or features you've considered.
33
+
34
+ **Additional context**
35
+ Add any other context or screenshots about the feature request here.
.github/dependabot.yml ADDED
@@ -0,0 +1,12 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ version: 2
2
+ updates:
3
+ - package-ecosystem: pip
4
+ directory: '/backend'
5
+ schedule:
6
+ interval: monthly
7
+ target-branch: 'dev'
8
+ - package-ecosystem: 'github-actions'
9
+ directory: '/'
10
+ schedule:
11
+ # Check for updates to GitHub Actions every week
12
+ interval: monthly
.github/pull_request_template.md ADDED
@@ -0,0 +1,72 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Pull Request Checklist
2
+
3
+ ### Note to first-time contributors: Please open a discussion post in [Discussions](https://github.com/open-webui/open-webui/discussions) and describe your changes before submitting a pull request.
4
+
5
+ **Before submitting, make sure you've checked the following:**
6
+
7
+ - [ ] **Target branch:** Please verify that the pull request targets the `dev` branch.
8
+ - [ ] **Description:** Provide a concise description of the changes made in this pull request.
9
+ - [ ] **Changelog:** Ensure a changelog entry following the format of [Keep a Changelog](https://keepachangelog.com/) is added at the bottom of the PR description.
10
+ - [ ] **Documentation:** Have you updated relevant documentation [Open WebUI Docs](https://github.com/open-webui/docs), or other documentation sources?
11
+ - [ ] **Dependencies:** Are there any new dependencies? Have you updated the dependency versions in the documentation?
12
+ - [ ] **Testing:** Have you written and run sufficient tests for validating the changes?
13
+ - [ ] **Code review:** Have you performed a self-review of your code, addressing any coding standard issues and ensuring adherence to the project's coding standards?
14
+ - [ ] **Prefix:** To cleary categorize this pull request, prefix the pull request title, using one of the following:
15
+ - **BREAKING CHANGE**: Significant changes that may affect compatibility
16
+ - **build**: Changes that affect the build system or external dependencies
17
+ - **ci**: Changes to our continuous integration processes or workflows
18
+ - **chore**: Refactor, cleanup, or other non-functional code changes
19
+ - **docs**: Documentation update or addition
20
+ - **feat**: Introduces a new feature or enhancement to the codebase
21
+ - **fix**: Bug fix or error correction
22
+ - **i18n**: Internationalization or localization changes
23
+ - **perf**: Performance improvement
24
+ - **refactor**: Code restructuring for better maintainability, readability, or scalability
25
+ - **style**: Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc.)
26
+ - **test**: Adding missing tests or correcting existing tests
27
+ - **WIP**: Work in progress, a temporary label for incomplete or ongoing work
28
+
29
+ # Changelog Entry
30
+
31
+ ### Description
32
+
33
+ - [Concisely describe the changes made in this pull request, including any relevant motivation and impact (e.g., fixing a bug, adding a feature, or improving performance)]
34
+
35
+ ### Added
36
+
37
+ - [List any new features, functionalities, or additions]
38
+
39
+ ### Changed
40
+
41
+ - [List any changes, updates, refactorings, or optimizations]
42
+
43
+ ### Deprecated
44
+
45
+ - [List any deprecated functionality or features that have been removed]
46
+
47
+ ### Removed
48
+
49
+ - [List any removed features, files, or functionalities]
50
+
51
+ ### Fixed
52
+
53
+ - [List any fixes, corrections, or bug fixes]
54
+
55
+ ### Security
56
+
57
+ - [List any new or updated security-related changes, including vulnerability fixes]
58
+
59
+ ### Breaking Changes
60
+
61
+ - **BREAKING CHANGE**: [List any breaking changes affecting compatibility or functionality]
62
+
63
+ ---
64
+
65
+ ### Additional Information
66
+
67
+ - [Insert any additional context, notes, or explanations for the changes]
68
+ - [Reference any related issues, commits, or other relevant information]
69
+
70
+ ### Screenshots or Videos
71
+
72
+ - [Attach any relevant screenshots or videos demonstrating the changes]
.github/workflows/build-release.yml ADDED
@@ -0,0 +1,72 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ name: Release
2
+
3
+ on:
4
+ push:
5
+ branches:
6
+ - main # or whatever branch you want to use
7
+
8
+ jobs:
9
+ release:
10
+ runs-on: ubuntu-latest
11
+
12
+ steps:
13
+ - name: Checkout repository
14
+ uses: actions/checkout@v4
15
+
16
+ - name: Check for changes in package.json
17
+ run: |
18
+ git diff --cached --diff-filter=d package.json || {
19
+ echo "No changes to package.json"
20
+ exit 1
21
+ }
22
+
23
+ - name: Get version number from package.json
24
+ id: get_version
25
+ run: |
26
+ VERSION=$(jq -r '.version' package.json)
27
+ echo "::set-output name=version::$VERSION"
28
+
29
+ - name: Extract latest CHANGELOG entry
30
+ id: changelog
31
+ run: |
32
+ CHANGELOG_CONTENT=$(awk 'BEGIN {print_section=0;} /^## \[/ {if (print_section == 0) {print_section=1;} else {exit;}} print_section {print;}' CHANGELOG.md)
33
+ CHANGELOG_ESCAPED=$(echo "$CHANGELOG_CONTENT" | sed ':a;N;$!ba;s/\n/%0A/g')
34
+ echo "Extracted latest release notes from CHANGELOG.md:"
35
+ echo -e "$CHANGELOG_CONTENT"
36
+ echo "::set-output name=content::$CHANGELOG_ESCAPED"
37
+
38
+ - name: Create GitHub release
39
+ uses: actions/github-script@v7
40
+ with:
41
+ github-token: ${{ secrets.GITHUB_TOKEN }}
42
+ script: |
43
+ const changelog = `${{ steps.changelog.outputs.content }}`;
44
+ const release = await github.rest.repos.createRelease({
45
+ owner: context.repo.owner,
46
+ repo: context.repo.repo,
47
+ tag_name: `v${{ steps.get_version.outputs.version }}`,
48
+ name: `v${{ steps.get_version.outputs.version }}`,
49
+ body: changelog,
50
+ })
51
+ console.log(`Created release ${release.data.html_url}`)
52
+
53
+ - name: Upload package to GitHub release
54
+ uses: actions/upload-artifact@v4
55
+ with:
56
+ name: package
57
+ path: |
58
+ .
59
+ !.git
60
+ env:
61
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
62
+
63
+ - name: Trigger Docker build workflow
64
+ uses: actions/github-script@v7
65
+ with:
66
+ script: |
67
+ github.rest.actions.createWorkflowDispatch({
68
+ owner: context.repo.owner,
69
+ repo: context.repo.repo,
70
+ workflow_id: 'docker-build.yaml',
71
+ ref: 'v${{ steps.get_version.outputs.version }}',
72
+ })
.github/workflows/deploy-to-hf-spaces.yml ADDED
@@ -0,0 +1,63 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ name: Deploy to HuggingFace Spaces
2
+
3
+ on:
4
+ push:
5
+ branches:
6
+ - dev
7
+ - main
8
+ workflow_dispatch:
9
+
10
+ jobs:
11
+ check-secret:
12
+ runs-on: ubuntu-latest
13
+ outputs:
14
+ token-set: ${{ steps.check-key.outputs.defined }}
15
+ steps:
16
+ - id: check-key
17
+ env:
18
+ HF_TOKEN: ${{ secrets.HF_TOKEN }}
19
+ if: "${{ env.HF_TOKEN != '' }}"
20
+ run: echo "defined=true" >> $GITHUB_OUTPUT
21
+
22
+ deploy:
23
+ runs-on: ubuntu-latest
24
+ needs: [check-secret]
25
+ if: needs.check-secret.outputs.token-set == 'true'
26
+ env:
27
+ HF_TOKEN: ${{ secrets.HF_TOKEN }}
28
+ steps:
29
+ - name: Checkout repository
30
+ uses: actions/checkout@v4
31
+ with:
32
+ lfs: true
33
+
34
+ - name: Remove git history
35
+ run: rm -rf .git
36
+
37
+ - name: Prepend YAML front matter to README.md
38
+ run: |
39
+ echo "---" > temp_readme.md
40
+ echo "title: Open WebUI" >> temp_readme.md
41
+ echo "emoji: 🐳" >> temp_readme.md
42
+ echo "colorFrom: purple" >> temp_readme.md
43
+ echo "colorTo: gray" >> temp_readme.md
44
+ echo "sdk: docker" >> temp_readme.md
45
+ echo "app_port: 8080" >> temp_readme.md
46
+ echo "---" >> temp_readme.md
47
+ cat README.md >> temp_readme.md
48
+ mv temp_readme.md README.md
49
+
50
+ - name: Configure git
51
+ run: |
52
+ git config --global user.email "41898282+github-actions[bot]@users.noreply.github.com"
53
+ git config --global user.name "github-actions[bot]"
54
+ - name: Set up Git and push to Space
55
+ run: |
56
+ git init --initial-branch=main
57
+ git lfs install
58
+ git lfs track "*.ttf"
59
+ git lfs track "*.jpg"
60
+ rm demo.gif
61
+ git add .
62
+ git commit -m "GitHub deploy: ${{ github.sha }}"
63
+ git push --force https://arcticaurora:${HF_TOKEN}@huggingface.co/spaces/arcticaurora/ai main
.github/workflows/docker-build.yaml ADDED
@@ -0,0 +1,477 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ name: Create and publish Docker images with specific build args
2
+
3
+ on:
4
+ workflow_dispatch:
5
+ push:
6
+ branches:
7
+ - main
8
+ - dev
9
+ tags:
10
+ - v*
11
+
12
+ env:
13
+ REGISTRY: ghcr.io
14
+
15
+ jobs:
16
+ build-main-image:
17
+ runs-on: ubuntu-latest
18
+ permissions:
19
+ contents: read
20
+ packages: write
21
+ strategy:
22
+ fail-fast: false
23
+ matrix:
24
+ platform:
25
+ - linux/amd64
26
+ - linux/arm64
27
+
28
+ steps:
29
+ # GitHub Packages requires the entire repository name to be in lowercase
30
+ # although the repository owner has a lowercase username, this prevents some people from running actions after forking
31
+ - name: Set repository and image name to lowercase
32
+ run: |
33
+ echo "IMAGE_NAME=${IMAGE_NAME,,}" >>${GITHUB_ENV}
34
+ echo "FULL_IMAGE_NAME=ghcr.io/${IMAGE_NAME,,}" >>${GITHUB_ENV}
35
+ env:
36
+ IMAGE_NAME: '${{ github.repository }}'
37
+
38
+ - name: Prepare
39
+ run: |
40
+ platform=${{ matrix.platform }}
41
+ echo "PLATFORM_PAIR=${platform//\//-}" >> $GITHUB_ENV
42
+
43
+ - name: Checkout repository
44
+ uses: actions/checkout@v4
45
+
46
+ - name: Set up QEMU
47
+ uses: docker/setup-qemu-action@v3
48
+
49
+ - name: Set up Docker Buildx
50
+ uses: docker/setup-buildx-action@v3
51
+
52
+ - name: Log in to the Container registry
53
+ uses: docker/login-action@v3
54
+ with:
55
+ registry: ${{ env.REGISTRY }}
56
+ username: ${{ github.actor }}
57
+ password: ${{ secrets.GITHUB_TOKEN }}
58
+
59
+ - name: Extract metadata for Docker images (default latest tag)
60
+ id: meta
61
+ uses: docker/metadata-action@v5
62
+ with:
63
+ images: ${{ env.FULL_IMAGE_NAME }}
64
+ tags: |
65
+ type=ref,event=branch
66
+ type=ref,event=tag
67
+ type=sha,prefix=git-
68
+ type=semver,pattern={{version}}
69
+ type=semver,pattern={{major}}.{{minor}}
70
+ flavor: |
71
+ latest=${{ github.ref == 'refs/heads/main' }}
72
+
73
+ - name: Extract metadata for Docker cache
74
+ id: cache-meta
75
+ uses: docker/metadata-action@v5
76
+ with:
77
+ images: ${{ env.FULL_IMAGE_NAME }}
78
+ tags: |
79
+ type=ref,event=branch
80
+ ${{ github.ref_type == 'tag' && 'type=raw,value=main' || '' }}
81
+ flavor: |
82
+ prefix=cache-${{ matrix.platform }}-
83
+ latest=false
84
+
85
+ - name: Build Docker image (latest)
86
+ uses: docker/build-push-action@v5
87
+ id: build
88
+ with:
89
+ context: .
90
+ push: true
91
+ platforms: ${{ matrix.platform }}
92
+ labels: ${{ steps.meta.outputs.labels }}
93
+ outputs: type=image,name=${{ env.FULL_IMAGE_NAME }},push-by-digest=true,name-canonical=true,push=true
94
+ cache-from: type=registry,ref=${{ steps.cache-meta.outputs.tags }}
95
+ cache-to: type=registry,ref=${{ steps.cache-meta.outputs.tags }},mode=max
96
+ build-args: |
97
+ BUILD_HASH=${{ github.sha }}
98
+
99
+ - name: Export digest
100
+ run: |
101
+ mkdir -p /tmp/digests
102
+ digest="${{ steps.build.outputs.digest }}"
103
+ touch "/tmp/digests/${digest#sha256:}"
104
+
105
+ - name: Upload digest
106
+ uses: actions/upload-artifact@v4
107
+ with:
108
+ name: digests-main-${{ env.PLATFORM_PAIR }}
109
+ path: /tmp/digests/*
110
+ if-no-files-found: error
111
+ retention-days: 1
112
+
113
+ build-cuda-image:
114
+ runs-on: ubuntu-latest
115
+ permissions:
116
+ contents: read
117
+ packages: write
118
+ strategy:
119
+ fail-fast: false
120
+ matrix:
121
+ platform:
122
+ - linux/amd64
123
+ - linux/arm64
124
+
125
+ steps:
126
+ # GitHub Packages requires the entire repository name to be in lowercase
127
+ # although the repository owner has a lowercase username, this prevents some people from running actions after forking
128
+ - name: Set repository and image name to lowercase
129
+ run: |
130
+ echo "IMAGE_NAME=${IMAGE_NAME,,}" >>${GITHUB_ENV}
131
+ echo "FULL_IMAGE_NAME=ghcr.io/${IMAGE_NAME,,}" >>${GITHUB_ENV}
132
+ env:
133
+ IMAGE_NAME: '${{ github.repository }}'
134
+
135
+ - name: Prepare
136
+ run: |
137
+ platform=${{ matrix.platform }}
138
+ echo "PLATFORM_PAIR=${platform//\//-}" >> $GITHUB_ENV
139
+
140
+ - name: Checkout repository
141
+ uses: actions/checkout@v4
142
+
143
+ - name: Set up QEMU
144
+ uses: docker/setup-qemu-action@v3
145
+
146
+ - name: Set up Docker Buildx
147
+ uses: docker/setup-buildx-action@v3
148
+
149
+ - name: Log in to the Container registry
150
+ uses: docker/login-action@v3
151
+ with:
152
+ registry: ${{ env.REGISTRY }}
153
+ username: ${{ github.actor }}
154
+ password: ${{ secrets.GITHUB_TOKEN }}
155
+
156
+ - name: Extract metadata for Docker images (cuda tag)
157
+ id: meta
158
+ uses: docker/metadata-action@v5
159
+ with:
160
+ images: ${{ env.FULL_IMAGE_NAME }}
161
+ tags: |
162
+ type=ref,event=branch
163
+ type=ref,event=tag
164
+ type=sha,prefix=git-
165
+ type=semver,pattern={{version}}
166
+ type=semver,pattern={{major}}.{{minor}}
167
+ type=raw,enable=${{ github.ref == 'refs/heads/main' }},prefix=,suffix=,value=cuda
168
+ flavor: |
169
+ latest=${{ github.ref == 'refs/heads/main' }}
170
+ suffix=-cuda,onlatest=true
171
+
172
+ - name: Extract metadata for Docker cache
173
+ id: cache-meta
174
+ uses: docker/metadata-action@v5
175
+ with:
176
+ images: ${{ env.FULL_IMAGE_NAME }}
177
+ tags: |
178
+ type=ref,event=branch
179
+ ${{ github.ref_type == 'tag' && 'type=raw,value=main' || '' }}
180
+ flavor: |
181
+ prefix=cache-cuda-${{ matrix.platform }}-
182
+ latest=false
183
+
184
+ - name: Build Docker image (cuda)
185
+ uses: docker/build-push-action@v5
186
+ id: build
187
+ with:
188
+ context: .
189
+ push: true
190
+ platforms: ${{ matrix.platform }}
191
+ labels: ${{ steps.meta.outputs.labels }}
192
+ outputs: type=image,name=${{ env.FULL_IMAGE_NAME }},push-by-digest=true,name-canonical=true,push=true
193
+ cache-from: type=registry,ref=${{ steps.cache-meta.outputs.tags }}
194
+ cache-to: type=registry,ref=${{ steps.cache-meta.outputs.tags }},mode=max
195
+ build-args: |
196
+ BUILD_HASH=${{ github.sha }}
197
+ USE_CUDA=true
198
+
199
+ - name: Export digest
200
+ run: |
201
+ mkdir -p /tmp/digests
202
+ digest="${{ steps.build.outputs.digest }}"
203
+ touch "/tmp/digests/${digest#sha256:}"
204
+
205
+ - name: Upload digest
206
+ uses: actions/upload-artifact@v4
207
+ with:
208
+ name: digests-cuda-${{ env.PLATFORM_PAIR }}
209
+ path: /tmp/digests/*
210
+ if-no-files-found: error
211
+ retention-days: 1
212
+
213
+ build-ollama-image:
214
+ runs-on: ubuntu-latest
215
+ permissions:
216
+ contents: read
217
+ packages: write
218
+ strategy:
219
+ fail-fast: false
220
+ matrix:
221
+ platform:
222
+ - linux/amd64
223
+ - linux/arm64
224
+
225
+ steps:
226
+ # GitHub Packages requires the entire repository name to be in lowercase
227
+ # although the repository owner has a lowercase username, this prevents some people from running actions after forking
228
+ - name: Set repository and image name to lowercase
229
+ run: |
230
+ echo "IMAGE_NAME=${IMAGE_NAME,,}" >>${GITHUB_ENV}
231
+ echo "FULL_IMAGE_NAME=ghcr.io/${IMAGE_NAME,,}" >>${GITHUB_ENV}
232
+ env:
233
+ IMAGE_NAME: '${{ github.repository }}'
234
+
235
+ - name: Prepare
236
+ run: |
237
+ platform=${{ matrix.platform }}
238
+ echo "PLATFORM_PAIR=${platform//\//-}" >> $GITHUB_ENV
239
+
240
+ - name: Checkout repository
241
+ uses: actions/checkout@v4
242
+
243
+ - name: Set up QEMU
244
+ uses: docker/setup-qemu-action@v3
245
+
246
+ - name: Set up Docker Buildx
247
+ uses: docker/setup-buildx-action@v3
248
+
249
+ - name: Log in to the Container registry
250
+ uses: docker/login-action@v3
251
+ with:
252
+ registry: ${{ env.REGISTRY }}
253
+ username: ${{ github.actor }}
254
+ password: ${{ secrets.GITHUB_TOKEN }}
255
+
256
+ - name: Extract metadata for Docker images (ollama tag)
257
+ id: meta
258
+ uses: docker/metadata-action@v5
259
+ with:
260
+ images: ${{ env.FULL_IMAGE_NAME }}
261
+ tags: |
262
+ type=ref,event=branch
263
+ type=ref,event=tag
264
+ type=sha,prefix=git-
265
+ type=semver,pattern={{version}}
266
+ type=semver,pattern={{major}}.{{minor}}
267
+ type=raw,enable=${{ github.ref == 'refs/heads/main' }},prefix=,suffix=,value=ollama
268
+ flavor: |
269
+ latest=${{ github.ref == 'refs/heads/main' }}
270
+ suffix=-ollama,onlatest=true
271
+
272
+ - name: Extract metadata for Docker cache
273
+ id: cache-meta
274
+ uses: docker/metadata-action@v5
275
+ with:
276
+ images: ${{ env.FULL_IMAGE_NAME }}
277
+ tags: |
278
+ type=ref,event=branch
279
+ ${{ github.ref_type == 'tag' && 'type=raw,value=main' || '' }}
280
+ flavor: |
281
+ prefix=cache-ollama-${{ matrix.platform }}-
282
+ latest=false
283
+
284
+ - name: Build Docker image (ollama)
285
+ uses: docker/build-push-action@v5
286
+ id: build
287
+ with:
288
+ context: .
289
+ push: true
290
+ platforms: ${{ matrix.platform }}
291
+ labels: ${{ steps.meta.outputs.labels }}
292
+ outputs: type=image,name=${{ env.FULL_IMAGE_NAME }},push-by-digest=true,name-canonical=true,push=true
293
+ cache-from: type=registry,ref=${{ steps.cache-meta.outputs.tags }}
294
+ cache-to: type=registry,ref=${{ steps.cache-meta.outputs.tags }},mode=max
295
+ build-args: |
296
+ BUILD_HASH=${{ github.sha }}
297
+ USE_OLLAMA=true
298
+
299
+ - name: Export digest
300
+ run: |
301
+ mkdir -p /tmp/digests
302
+ digest="${{ steps.build.outputs.digest }}"
303
+ touch "/tmp/digests/${digest#sha256:}"
304
+
305
+ - name: Upload digest
306
+ uses: actions/upload-artifact@v4
307
+ with:
308
+ name: digests-ollama-${{ env.PLATFORM_PAIR }}
309
+ path: /tmp/digests/*
310
+ if-no-files-found: error
311
+ retention-days: 1
312
+
313
+ merge-main-images:
314
+ runs-on: ubuntu-latest
315
+ needs: [build-main-image]
316
+ steps:
317
+ # GitHub Packages requires the entire repository name to be in lowercase
318
+ # although the repository owner has a lowercase username, this prevents some people from running actions after forking
319
+ - name: Set repository and image name to lowercase
320
+ run: |
321
+ echo "IMAGE_NAME=${IMAGE_NAME,,}" >>${GITHUB_ENV}
322
+ echo "FULL_IMAGE_NAME=ghcr.io/${IMAGE_NAME,,}" >>${GITHUB_ENV}
323
+ env:
324
+ IMAGE_NAME: '${{ github.repository }}'
325
+
326
+ - name: Download digests
327
+ uses: actions/download-artifact@v4
328
+ with:
329
+ pattern: digests-main-*
330
+ path: /tmp/digests
331
+ merge-multiple: true
332
+
333
+ - name: Set up Docker Buildx
334
+ uses: docker/setup-buildx-action@v3
335
+
336
+ - name: Log in to the Container registry
337
+ uses: docker/login-action@v3
338
+ with:
339
+ registry: ${{ env.REGISTRY }}
340
+ username: ${{ github.actor }}
341
+ password: ${{ secrets.GITHUB_TOKEN }}
342
+
343
+ - name: Extract metadata for Docker images (default latest tag)
344
+ id: meta
345
+ uses: docker/metadata-action@v5
346
+ with:
347
+ images: ${{ env.FULL_IMAGE_NAME }}
348
+ tags: |
349
+ type=ref,event=branch
350
+ type=ref,event=tag
351
+ type=sha,prefix=git-
352
+ type=semver,pattern={{version}}
353
+ type=semver,pattern={{major}}.{{minor}}
354
+ flavor: |
355
+ latest=${{ github.ref == 'refs/heads/main' }}
356
+
357
+ - name: Create manifest list and push
358
+ working-directory: /tmp/digests
359
+ run: |
360
+ docker buildx imagetools create $(jq -cr '.tags | map("-t " + .) | join(" ")' <<< "$DOCKER_METADATA_OUTPUT_JSON") \
361
+ $(printf '${{ env.FULL_IMAGE_NAME }}@sha256:%s ' *)
362
+
363
+ - name: Inspect image
364
+ run: |
365
+ docker buildx imagetools inspect ${{ env.FULL_IMAGE_NAME }}:${{ steps.meta.outputs.version }}
366
+
367
+ merge-cuda-images:
368
+ runs-on: ubuntu-latest
369
+ needs: [build-cuda-image]
370
+ steps:
371
+ # GitHub Packages requires the entire repository name to be in lowercase
372
+ # although the repository owner has a lowercase username, this prevents some people from running actions after forking
373
+ - name: Set repository and image name to lowercase
374
+ run: |
375
+ echo "IMAGE_NAME=${IMAGE_NAME,,}" >>${GITHUB_ENV}
376
+ echo "FULL_IMAGE_NAME=ghcr.io/${IMAGE_NAME,,}" >>${GITHUB_ENV}
377
+ env:
378
+ IMAGE_NAME: '${{ github.repository }}'
379
+
380
+ - name: Download digests
381
+ uses: actions/download-artifact@v4
382
+ with:
383
+ pattern: digests-cuda-*
384
+ path: /tmp/digests
385
+ merge-multiple: true
386
+
387
+ - name: Set up Docker Buildx
388
+ uses: docker/setup-buildx-action@v3
389
+
390
+ - name: Log in to the Container registry
391
+ uses: docker/login-action@v3
392
+ with:
393
+ registry: ${{ env.REGISTRY }}
394
+ username: ${{ github.actor }}
395
+ password: ${{ secrets.GITHUB_TOKEN }}
396
+
397
+ - name: Extract metadata for Docker images (default latest tag)
398
+ id: meta
399
+ uses: docker/metadata-action@v5
400
+ with:
401
+ images: ${{ env.FULL_IMAGE_NAME }}
402
+ tags: |
403
+ type=ref,event=branch
404
+ type=ref,event=tag
405
+ type=sha,prefix=git-
406
+ type=semver,pattern={{version}}
407
+ type=semver,pattern={{major}}.{{minor}}
408
+ type=raw,enable=${{ github.ref == 'refs/heads/main' }},prefix=,suffix=,value=cuda
409
+ flavor: |
410
+ latest=${{ github.ref == 'refs/heads/main' }}
411
+ suffix=-cuda,onlatest=true
412
+
413
+ - name: Create manifest list and push
414
+ working-directory: /tmp/digests
415
+ run: |
416
+ docker buildx imagetools create $(jq -cr '.tags | map("-t " + .) | join(" ")' <<< "$DOCKER_METADATA_OUTPUT_JSON") \
417
+ $(printf '${{ env.FULL_IMAGE_NAME }}@sha256:%s ' *)
418
+
419
+ - name: Inspect image
420
+ run: |
421
+ docker buildx imagetools inspect ${{ env.FULL_IMAGE_NAME }}:${{ steps.meta.outputs.version }}
422
+
423
+ merge-ollama-images:
424
+ runs-on: ubuntu-latest
425
+ needs: [build-ollama-image]
426
+ steps:
427
+ # GitHub Packages requires the entire repository name to be in lowercase
428
+ # although the repository owner has a lowercase username, this prevents some people from running actions after forking
429
+ - name: Set repository and image name to lowercase
430
+ run: |
431
+ echo "IMAGE_NAME=${IMAGE_NAME,,}" >>${GITHUB_ENV}
432
+ echo "FULL_IMAGE_NAME=ghcr.io/${IMAGE_NAME,,}" >>${GITHUB_ENV}
433
+ env:
434
+ IMAGE_NAME: '${{ github.repository }}'
435
+
436
+ - name: Download digests
437
+ uses: actions/download-artifact@v4
438
+ with:
439
+ pattern: digests-ollama-*
440
+ path: /tmp/digests
441
+ merge-multiple: true
442
+
443
+ - name: Set up Docker Buildx
444
+ uses: docker/setup-buildx-action@v3
445
+
446
+ - name: Log in to the Container registry
447
+ uses: docker/login-action@v3
448
+ with:
449
+ registry: ${{ env.REGISTRY }}
450
+ username: ${{ github.actor }}
451
+ password: ${{ secrets.GITHUB_TOKEN }}
452
+
453
+ - name: Extract metadata for Docker images (default ollama tag)
454
+ id: meta
455
+ uses: docker/metadata-action@v5
456
+ with:
457
+ images: ${{ env.FULL_IMAGE_NAME }}
458
+ tags: |
459
+ type=ref,event=branch
460
+ type=ref,event=tag
461
+ type=sha,prefix=git-
462
+ type=semver,pattern={{version}}
463
+ type=semver,pattern={{major}}.{{minor}}
464
+ type=raw,enable=${{ github.ref == 'refs/heads/main' }},prefix=,suffix=,value=ollama
465
+ flavor: |
466
+ latest=${{ github.ref == 'refs/heads/main' }}
467
+ suffix=-ollama,onlatest=true
468
+
469
+ - name: Create manifest list and push
470
+ working-directory: /tmp/digests
471
+ run: |
472
+ docker buildx imagetools create $(jq -cr '.tags | map("-t " + .) | join(" ")' <<< "$DOCKER_METADATA_OUTPUT_JSON") \
473
+ $(printf '${{ env.FULL_IMAGE_NAME }}@sha256:%s ' *)
474
+
475
+ - name: Inspect image
476
+ run: |
477
+ docker buildx imagetools inspect ${{ env.FULL_IMAGE_NAME }}:${{ steps.meta.outputs.version }}
.github/workflows/format-backend.yaml ADDED
@@ -0,0 +1,39 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ name: Python CI
2
+
3
+ on:
4
+ push:
5
+ branches:
6
+ - main
7
+ - dev
8
+ pull_request:
9
+ branches:
10
+ - main
11
+ - dev
12
+
13
+ jobs:
14
+ build:
15
+ name: 'Format Backend'
16
+ runs-on: ubuntu-latest
17
+
18
+ strategy:
19
+ matrix:
20
+ python-version: [3.11]
21
+
22
+ steps:
23
+ - uses: actions/checkout@v4
24
+
25
+ - name: Set up Python
26
+ uses: actions/setup-python@v5
27
+ with:
28
+ python-version: ${{ matrix.python-version }}
29
+
30
+ - name: Install dependencies
31
+ run: |
32
+ python -m pip install --upgrade pip
33
+ pip install black
34
+
35
+ - name: Format backend
36
+ run: npm run format:backend
37
+
38
+ - name: Check for changes after format
39
+ run: git diff --exit-code
.github/workflows/format-build-frontend.yaml ADDED
@@ -0,0 +1,57 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ name: Frontend Build
2
+
3
+ on:
4
+ push:
5
+ branches:
6
+ - main
7
+ - dev
8
+ pull_request:
9
+ branches:
10
+ - main
11
+ - dev
12
+
13
+ jobs:
14
+ build:
15
+ name: 'Format & Build Frontend'
16
+ runs-on: ubuntu-latest
17
+ steps:
18
+ - name: Checkout Repository
19
+ uses: actions/checkout@v4
20
+
21
+ - name: Setup Node.js
22
+ uses: actions/setup-node@v4
23
+ with:
24
+ node-version: '22' # Or specify any other version you want to use
25
+
26
+ - name: Install Dependencies
27
+ run: npm install
28
+
29
+ - name: Format Frontend
30
+ run: npm run format
31
+
32
+ - name: Run i18next
33
+ run: npm run i18n:parse
34
+
35
+ - name: Check for Changes After Format
36
+ run: git diff --exit-code
37
+
38
+ - name: Build Frontend
39
+ run: npm run build
40
+
41
+ test-frontend:
42
+ name: 'Frontend Unit Tests'
43
+ runs-on: ubuntu-latest
44
+ steps:
45
+ - name: Checkout Repository
46
+ uses: actions/checkout@v4
47
+
48
+ - name: Setup Node.js
49
+ uses: actions/setup-node@v4
50
+ with:
51
+ node-version: '22'
52
+
53
+ - name: Install Dependencies
54
+ run: npm ci
55
+
56
+ - name: Run vitest
57
+ run: npm run test:frontend
.github/workflows/integration-test.yml ADDED
@@ -0,0 +1,253 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ name: Integration Test
2
+
3
+ on:
4
+ push:
5
+ branches:
6
+ - main
7
+ - dev
8
+ pull_request:
9
+ branches:
10
+ - main
11
+ - dev
12
+
13
+ jobs:
14
+ cypress-run:
15
+ name: Run Cypress Integration Tests
16
+ runs-on: ubuntu-latest
17
+ steps:
18
+ - name: Maximize build space
19
+ uses: AdityaGarg8/[email protected]
20
+ with:
21
+ remove-android: 'true'
22
+ remove-haskell: 'true'
23
+ remove-codeql: 'true'
24
+
25
+ - name: Checkout Repository
26
+ uses: actions/checkout@v4
27
+
28
+ - name: Build and run Compose Stack
29
+ run: |
30
+ docker compose \
31
+ --file docker-compose.yaml \
32
+ --file docker-compose.api.yaml \
33
+ --file docker-compose.a1111-test.yaml \
34
+ up --detach --build
35
+
36
+ - name: Delete Docker build cache
37
+ run: |
38
+ docker builder prune --all --force
39
+
40
+ - name: Wait for Ollama to be up
41
+ timeout-minutes: 5
42
+ run: |
43
+ until curl --output /dev/null --silent --fail http://localhost:11434; do
44
+ printf '.'
45
+ sleep 1
46
+ done
47
+ echo "Service is up!"
48
+
49
+ - name: Preload Ollama model
50
+ run: |
51
+ docker exec ollama ollama pull qwen:0.5b-chat-v1.5-q2_K
52
+
53
+ - name: Cypress run
54
+ uses: cypress-io/github-action@v6
55
+ with:
56
+ browser: chrome
57
+ wait-on: 'http://localhost:3000'
58
+ config: baseUrl=http://localhost:3000
59
+
60
+ - uses: actions/upload-artifact@v4
61
+ if: always()
62
+ name: Upload Cypress videos
63
+ with:
64
+ name: cypress-videos
65
+ path: cypress/videos
66
+ if-no-files-found: ignore
67
+
68
+ - name: Extract Compose logs
69
+ if: always()
70
+ run: |
71
+ docker compose logs > compose-logs.txt
72
+
73
+ - uses: actions/upload-artifact@v4
74
+ if: always()
75
+ name: Upload Compose logs
76
+ with:
77
+ name: compose-logs
78
+ path: compose-logs.txt
79
+ if-no-files-found: ignore
80
+
81
+ # pytest:
82
+ # name: Run Backend Tests
83
+ # runs-on: ubuntu-latest
84
+ # steps:
85
+ # - uses: actions/checkout@v4
86
+
87
+ # - name: Set up Python
88
+ # uses: actions/setup-python@v5
89
+ # with:
90
+ # python-version: ${{ matrix.python-version }}
91
+
92
+ # - name: Install dependencies
93
+ # run: |
94
+ # python -m pip install --upgrade pip
95
+ # pip install -r backend/requirements.txt
96
+
97
+ # - name: pytest run
98
+ # run: |
99
+ # ls -al
100
+ # cd backend
101
+ # PYTHONPATH=. pytest . -o log_cli=true -o log_cli_level=INFO
102
+
103
+ migration_test:
104
+ name: Run Migration Tests
105
+ runs-on: ubuntu-latest
106
+ services:
107
+ postgres:
108
+ image: postgres
109
+ env:
110
+ POSTGRES_PASSWORD: postgres
111
+ options: >-
112
+ --health-cmd pg_isready
113
+ --health-interval 10s
114
+ --health-timeout 5s
115
+ --health-retries 5
116
+ ports:
117
+ - 5432:5432
118
+ # mysql:
119
+ # image: mysql
120
+ # env:
121
+ # MYSQL_ROOT_PASSWORD: mysql
122
+ # MYSQL_DATABASE: mysql
123
+ # options: >-
124
+ # --health-cmd "mysqladmin ping -h localhost"
125
+ # --health-interval 10s
126
+ # --health-timeout 5s
127
+ # --health-retries 5
128
+ # ports:
129
+ # - 3306:3306
130
+ steps:
131
+ - name: Checkout Repository
132
+ uses: actions/checkout@v4
133
+
134
+ - name: Set up Python
135
+ uses: actions/setup-python@v5
136
+ with:
137
+ python-version: ${{ matrix.python-version }}
138
+
139
+ - name: Set up uv
140
+ uses: yezz123/setup-uv@v4
141
+ with:
142
+ uv-venv: venv
143
+
144
+ - name: Activate virtualenv
145
+ run: |
146
+ . venv/bin/activate
147
+ echo PATH=$PATH >> $GITHUB_ENV
148
+
149
+ - name: Install dependencies
150
+ run: |
151
+ uv pip install -r backend/requirements.txt
152
+
153
+ - name: Test backend with SQLite
154
+ id: sqlite
155
+ env:
156
+ WEBUI_SECRET_KEY: secret-key
157
+ GLOBAL_LOG_LEVEL: debug
158
+ run: |
159
+ cd backend
160
+ uvicorn open_webui.main:app --port "8080" --forwarded-allow-ips '*' &
161
+ UVICORN_PID=$!
162
+ # Wait up to 40 seconds for the server to start
163
+ for i in {1..40}; do
164
+ curl -s http://localhost:8080/api/config > /dev/null && break
165
+ sleep 1
166
+ if [ $i -eq 40 ]; then
167
+ echo "Server failed to start"
168
+ kill -9 $UVICORN_PID
169
+ exit 1
170
+ fi
171
+ done
172
+ # Check that the server is still running after 5 seconds
173
+ sleep 5
174
+ if ! kill -0 $UVICORN_PID; then
175
+ echo "Server has stopped"
176
+ exit 1
177
+ fi
178
+
179
+ - name: Test backend with Postgres
180
+ if: success() || steps.sqlite.conclusion == 'failure'
181
+ env:
182
+ WEBUI_SECRET_KEY: secret-key
183
+ GLOBAL_LOG_LEVEL: debug
184
+ DATABASE_URL: postgresql://postgres:postgres@localhost:5432/postgres
185
+ DATABASE_POOL_SIZE: 10
186
+ DATABASE_POOL_MAX_OVERFLOW: 10
187
+ DATABASE_POOL_TIMEOUT: 30
188
+ run: |
189
+ cd backend
190
+ uvicorn open_webui.main:app --port "8081" --forwarded-allow-ips '*' &
191
+ UVICORN_PID=$!
192
+ # Wait up to 20 seconds for the server to start
193
+ for i in {1..20}; do
194
+ curl -s http://localhost:8081/api/config > /dev/null && break
195
+ sleep 1
196
+ if [ $i -eq 20 ]; then
197
+ echo "Server failed to start"
198
+ kill -9 $UVICORN_PID
199
+ exit 1
200
+ fi
201
+ done
202
+ # Check that the server is still running after 5 seconds
203
+ sleep 5
204
+ if ! kill -0 $UVICORN_PID; then
205
+ echo "Server has stopped"
206
+ exit 1
207
+ fi
208
+
209
+ # Check that service will reconnect to postgres when connection will be closed
210
+ status_code=$(curl --write-out %{http_code} -s --output /dev/null http://localhost:8081/health/db)
211
+ if [[ "$status_code" -ne 200 ]] ; then
212
+ echo "Server has failed before postgres reconnect check"
213
+ exit 1
214
+ fi
215
+
216
+ echo "Terminating all connections to postgres..."
217
+ python -c "import os, psycopg2 as pg2; \
218
+ conn = pg2.connect(dsn=os.environ['DATABASE_URL'].replace('+pool', '')); \
219
+ cur = conn.cursor(); \
220
+ cur.execute('SELECT pg_terminate_backend(psa.pid) FROM pg_stat_activity psa WHERE datname = current_database() AND pid <> pg_backend_pid();')"
221
+
222
+ status_code=$(curl --write-out %{http_code} -s --output /dev/null http://localhost:8081/health/db)
223
+ if [[ "$status_code" -ne 200 ]] ; then
224
+ echo "Server has not reconnected to postgres after connection was closed: returned status $status_code"
225
+ exit 1
226
+ fi
227
+
228
+ # - name: Test backend with MySQL
229
+ # if: success() || steps.sqlite.conclusion == 'failure' || steps.postgres.conclusion == 'failure'
230
+ # env:
231
+ # WEBUI_SECRET_KEY: secret-key
232
+ # GLOBAL_LOG_LEVEL: debug
233
+ # DATABASE_URL: mysql://root:mysql@localhost:3306/mysql
234
+ # run: |
235
+ # cd backend
236
+ # uvicorn open_webui.main:app --port "8083" --forwarded-allow-ips '*' &
237
+ # UVICORN_PID=$!
238
+ # # Wait up to 20 seconds for the server to start
239
+ # for i in {1..20}; do
240
+ # curl -s http://localhost:8083/api/config > /dev/null && break
241
+ # sleep 1
242
+ # if [ $i -eq 20 ]; then
243
+ # echo "Server failed to start"
244
+ # kill -9 $UVICORN_PID
245
+ # exit 1
246
+ # fi
247
+ # done
248
+ # # Check that the server is still running after 5 seconds
249
+ # sleep 5
250
+ # if ! kill -0 $UVICORN_PID; then
251
+ # echo "Server has stopped"
252
+ # exit 1
253
+ # fi
.github/workflows/lint-backend.disabled ADDED
@@ -0,0 +1,27 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ name: Python CI
2
+ on:
3
+ push:
4
+ branches: ['main']
5
+ pull_request:
6
+ jobs:
7
+ build:
8
+ name: 'Lint Backend'
9
+ env:
10
+ PUBLIC_API_BASE_URL: ''
11
+ runs-on: ubuntu-latest
12
+ strategy:
13
+ matrix:
14
+ node-version:
15
+ - latest
16
+ steps:
17
+ - uses: actions/checkout@v4
18
+ - name: Use Python
19
+ uses: actions/setup-python@v5
20
+ - name: Use Bun
21
+ uses: oven-sh/setup-bun@v1
22
+ - name: Install dependencies
23
+ run: |
24
+ python -m pip install --upgrade pip
25
+ pip install pylint
26
+ - name: Lint backend
27
+ run: bun run lint:backend
.github/workflows/lint-frontend.disabled ADDED
@@ -0,0 +1,21 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ name: Bun CI
2
+ on:
3
+ push:
4
+ branches: ['main']
5
+ pull_request:
6
+ jobs:
7
+ build:
8
+ name: 'Lint Frontend'
9
+ env:
10
+ PUBLIC_API_BASE_URL: ''
11
+ runs-on: ubuntu-latest
12
+ steps:
13
+ - uses: actions/checkout@v4
14
+ - name: Use Bun
15
+ uses: oven-sh/setup-bun@v1
16
+ - run: bun --version
17
+ - name: Install frontend dependencies
18
+ run: bun install --frozen-lockfile
19
+ - run: bun run lint:frontend
20
+ - run: bun run lint:types
21
+ if: success() || failure()
.github/workflows/release-pypi.yml ADDED
@@ -0,0 +1,32 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ name: Release to PyPI
2
+
3
+ on:
4
+ push:
5
+ branches:
6
+ - main # or whatever branch you want to use
7
+ - pypi-release
8
+
9
+ jobs:
10
+ release:
11
+ runs-on: ubuntu-latest
12
+ environment:
13
+ name: pypi
14
+ url: https://pypi.org/p/open-webui
15
+ permissions:
16
+ id-token: write
17
+ steps:
18
+ - name: Checkout repository
19
+ uses: actions/checkout@v4
20
+ - uses: actions/setup-node@v4
21
+ with:
22
+ node-version: 18
23
+ - uses: actions/setup-python@v5
24
+ with:
25
+ python-version: 3.11
26
+ - name: Build
27
+ run: |
28
+ python -m pip install --upgrade pip
29
+ pip install build
30
+ python -m build .
31
+ - name: Publish package distributions to PyPI
32
+ uses: pypa/gh-action-pypi-publish@release/v1
.gitignore ADDED
@@ -0,0 +1,310 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ .DS_Store
2
+ node_modules
3
+ /build
4
+ /.svelte-kit
5
+ /package
6
+ .myenv/
7
+ .env
8
+ .env.*
9
+ !.env.example
10
+ vite.config.js.timestamp-*
11
+ vite.config.ts.timestamp-*
12
+ # Byte-compiled / optimized / DLL files
13
+ __pycache__/
14
+ *.py[cod]
15
+ *$py.class
16
+
17
+ # C extensions
18
+ *.so
19
+
20
+ # Pyodide distribution
21
+ static/pyodide/*
22
+ !static/pyodide/pyodide-lock.json
23
+
24
+ # Distribution / packaging
25
+ .Python
26
+ build/
27
+ develop-eggs/
28
+ dist/
29
+ downloads/
30
+ eggs/
31
+ .eggs/
32
+ lib64/
33
+ parts/
34
+ sdist/
35
+ var/
36
+ wheels/
37
+ share/python-wheels/
38
+ *.egg-info/
39
+ .installed.cfg
40
+ *.egg
41
+ MANIFEST
42
+
43
+ # PyInstaller
44
+ # Usually these files are written by a python script from a template
45
+ # before PyInstaller builds the exe, so as to inject date/other infos into it.
46
+ *.manifest
47
+ *.spec
48
+
49
+ # Installer logs
50
+ pip-log.txt
51
+ pip-delete-this-directory.txt
52
+
53
+ # Unit test / coverage reports
54
+ htmlcov/
55
+ .tox/
56
+ .nox/
57
+ .coverage
58
+ .coverage.*
59
+ .cache
60
+ nosetests.xml
61
+ coverage.xml
62
+ *.cover
63
+ *.py,cover
64
+ .hypothesis/
65
+ .pytest_cache/
66
+ cover/
67
+
68
+ # Translations
69
+ *.mo
70
+ *.pot
71
+
72
+ # Django stuff:
73
+ *.log
74
+ local_settings.py
75
+ db.sqlite3
76
+ db.sqlite3-journal
77
+
78
+ # Flask stuff:
79
+ instance/
80
+ .webassets-cache
81
+
82
+ # Scrapy stuff:
83
+ .scrapy
84
+
85
+ # Sphinx documentation
86
+ docs/_build/
87
+
88
+ # PyBuilder
89
+ .pybuilder/
90
+ target/
91
+
92
+ # Jupyter Notebook
93
+ .ipynb_checkpoints
94
+
95
+ # IPython
96
+ profile_default/
97
+ ipython_config.py
98
+
99
+ # pyenv
100
+ # For a library or package, you might want to ignore these files since the code is
101
+ # intended to run in multiple environments; otherwise, check them in:
102
+ # .python-version
103
+
104
+ # pipenv
105
+ # According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
106
+ # However, in case of collaboration, if having platform-specific dependencies or dependencies
107
+ # having no cross-platform support, pipenv may install dependencies that don't work, or not
108
+ # install all needed dependencies.
109
+ #Pipfile.lock
110
+
111
+ # poetry
112
+ # Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
113
+ # This is especially recommended for binary packages to ensure reproducibility, and is more
114
+ # commonly ignored for libraries.
115
+ # https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
116
+ #poetry.lock
117
+
118
+ # pdm
119
+ # Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
120
+ #pdm.lock
121
+ # pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
122
+ # in version control.
123
+ # https://pdm.fming.dev/#use-with-ide
124
+ .pdm.toml
125
+
126
+ # PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
127
+ __pypackages__/
128
+
129
+ # Celery stuff
130
+ celerybeat-schedule
131
+ celerybeat.pid
132
+
133
+ # SageMath parsed files
134
+ *.sage.py
135
+
136
+ # Environments
137
+ .env
138
+ .venv
139
+ env/
140
+ venv/
141
+ ENV/
142
+ env.bak/
143
+ venv.bak/
144
+
145
+ # Spyder project settings
146
+ .spyderproject
147
+ .spyproject
148
+
149
+ # Rope project settings
150
+ .ropeproject
151
+
152
+ # mkdocs documentation
153
+ /site
154
+
155
+ # mypy
156
+ .mypy_cache/
157
+ .dmypy.json
158
+ dmypy.json
159
+
160
+ # Pyre type checker
161
+ .pyre/
162
+
163
+ # pytype static type analyzer
164
+ .pytype/
165
+
166
+ # Cython debug symbols
167
+ cython_debug/
168
+
169
+ # PyCharm
170
+ # JetBrains specific template is maintained in a separate JetBrains.gitignore that can
171
+ # be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
172
+ # and can be added to the global gitignore or merged into this file. For a more nuclear
173
+ # option (not recommended) you can uncomment the following to ignore the entire idea folder.
174
+ .idea/
175
+
176
+ # Logs
177
+ logs
178
+ *.log
179
+ npm-debug.log*
180
+ yarn-debug.log*
181
+ yarn-error.log*
182
+ lerna-debug.log*
183
+ .pnpm-debug.log*
184
+
185
+ # Diagnostic reports (https://nodejs.org/api/report.html)
186
+ report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
187
+
188
+ # Runtime data
189
+ pids
190
+ *.pid
191
+ *.seed
192
+ *.pid.lock
193
+
194
+ # Directory for instrumented libs generated by jscoverage/JSCover
195
+ lib-cov
196
+
197
+ # Coverage directory used by tools like istanbul
198
+ coverage
199
+ *.lcov
200
+
201
+ # nyc test coverage
202
+ .nyc_output
203
+
204
+ # Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
205
+ .grunt
206
+
207
+ # Bower dependency directory (https://bower.io/)
208
+ bower_components
209
+
210
+ # node-waf configuration
211
+ .lock-wscript
212
+
213
+ # Compiled binary addons (https://nodejs.org/api/addons.html)
214
+ build/Release
215
+
216
+ # Dependency directories
217
+ node_modules/
218
+ jspm_packages/
219
+
220
+ # Snowpack dependency directory (https://snowpack.dev/)
221
+ web_modules/
222
+
223
+ # TypeScript cache
224
+ *.tsbuildinfo
225
+
226
+ # Optional npm cache directory
227
+ .npm
228
+
229
+ # Optional eslint cache
230
+ .eslintcache
231
+
232
+ # Optional stylelint cache
233
+ .stylelintcache
234
+
235
+ # Microbundle cache
236
+ .rpt2_cache/
237
+ .rts2_cache_cjs/
238
+ .rts2_cache_es/
239
+ .rts2_cache_umd/
240
+
241
+ # Optional REPL history
242
+ .node_repl_history
243
+
244
+ # Output of 'npm pack'
245
+ *.tgz
246
+
247
+ # Yarn Integrity file
248
+ .yarn-integrity
249
+
250
+ # dotenv environment variable files
251
+ .env
252
+ .env.development.local
253
+ .env.test.local
254
+ .env.production.local
255
+ .env.local
256
+
257
+ # parcel-bundler cache (https://parceljs.org/)
258
+ .cache
259
+ .parcel-cache
260
+
261
+ # Next.js build output
262
+ .next
263
+ out
264
+
265
+ # Nuxt.js build / generate output
266
+ .nuxt
267
+ dist
268
+
269
+ # Gatsby files
270
+ .cache/
271
+ # Comment in the public line in if your project uses Gatsby and not Next.js
272
+ # https://nextjs.org/blog/next-9-1#public-directory-support
273
+ # public
274
+
275
+ # vuepress build output
276
+ .vuepress/dist
277
+
278
+ # vuepress v2.x temp and cache directory
279
+ .temp
280
+ .cache
281
+
282
+ # Docusaurus cache and generated files
283
+ .docusaurus
284
+
285
+ # Serverless directories
286
+ .serverless/
287
+
288
+ # FuseBox cache
289
+ .fusebox/
290
+
291
+ # DynamoDB Local files
292
+ .dynamodb/
293
+
294
+ # TernJS port file
295
+ .tern-port
296
+
297
+ # Stores VSCode versions used for testing VSCode extensions
298
+ .vscode-test
299
+
300
+ # yarn v2
301
+ .yarn/cache
302
+ .yarn/unplugged
303
+ .yarn/build-state.yml
304
+ .yarn/install-state.gz
305
+ .pnp.*
306
+
307
+ # cypress artifacts
308
+ cypress/videos
309
+ cypress/screenshots
310
+ .vscode/settings.json
.npmrc ADDED
@@ -0,0 +1 @@
 
 
1
+ engine-strict=true
.prettierignore ADDED
@@ -0,0 +1,316 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Ignore files for PNPM, NPM and YARN
2
+ pnpm-lock.yaml
3
+ package-lock.json
4
+ yarn.lock
5
+
6
+ kubernetes/
7
+
8
+ # Copy of .gitignore
9
+ .DS_Store
10
+ node_modules
11
+ /build
12
+ /.svelte-kit
13
+ /package
14
+ .env
15
+ .env.*
16
+ !.env.example
17
+ vite.config.js.timestamp-*
18
+ vite.config.ts.timestamp-*
19
+ # Byte-compiled / optimized / DLL files
20
+ __pycache__/
21
+ *.py[cod]
22
+ *$py.class
23
+
24
+ # C extensions
25
+ *.so
26
+
27
+ # Distribution / packaging
28
+ .Python
29
+ build/
30
+ develop-eggs/
31
+ dist/
32
+ downloads/
33
+ eggs/
34
+ .eggs/
35
+ lib64/
36
+ parts/
37
+ sdist/
38
+ var/
39
+ wheels/
40
+ share/python-wheels/
41
+ *.egg-info/
42
+ .installed.cfg
43
+ *.egg
44
+ MANIFEST
45
+
46
+ # PyInstaller
47
+ # Usually these files are written by a python script from a template
48
+ # before PyInstaller builds the exe, so as to inject date/other infos into it.
49
+ *.manifest
50
+ *.spec
51
+
52
+ # Installer logs
53
+ pip-log.txt
54
+ pip-delete-this-directory.txt
55
+
56
+ # Unit test / coverage reports
57
+ htmlcov/
58
+ .tox/
59
+ .nox/
60
+ .coverage
61
+ .coverage.*
62
+ .cache
63
+ nosetests.xml
64
+ coverage.xml
65
+ *.cover
66
+ *.py,cover
67
+ .hypothesis/
68
+ .pytest_cache/
69
+ cover/
70
+
71
+ # Translations
72
+ *.mo
73
+ *.pot
74
+
75
+ # Django stuff:
76
+ *.log
77
+ local_settings.py
78
+ db.sqlite3
79
+ db.sqlite3-journal
80
+
81
+ # Flask stuff:
82
+ instance/
83
+ .webassets-cache
84
+
85
+ # Scrapy stuff:
86
+ .scrapy
87
+
88
+ # Sphinx documentation
89
+ docs/_build/
90
+
91
+ # PyBuilder
92
+ .pybuilder/
93
+ target/
94
+
95
+ # Jupyter Notebook
96
+ .ipynb_checkpoints
97
+
98
+ # IPython
99
+ profile_default/
100
+ ipython_config.py
101
+
102
+ # pyenv
103
+ # For a library or package, you might want to ignore these files since the code is
104
+ # intended to run in multiple environments; otherwise, check them in:
105
+ # .python-version
106
+
107
+ # pipenv
108
+ # According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
109
+ # However, in case of collaboration, if having platform-specific dependencies or dependencies
110
+ # having no cross-platform support, pipenv may install dependencies that don't work, or not
111
+ # install all needed dependencies.
112
+ #Pipfile.lock
113
+
114
+ # poetry
115
+ # Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
116
+ # This is especially recommended for binary packages to ensure reproducibility, and is more
117
+ # commonly ignored for libraries.
118
+ # https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
119
+ #poetry.lock
120
+
121
+ # pdm
122
+ # Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
123
+ #pdm.lock
124
+ # pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
125
+ # in version control.
126
+ # https://pdm.fming.dev/#use-with-ide
127
+ .pdm.toml
128
+
129
+ # PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
130
+ __pypackages__/
131
+
132
+ # Celery stuff
133
+ celerybeat-schedule
134
+ celerybeat.pid
135
+
136
+ # SageMath parsed files
137
+ *.sage.py
138
+
139
+ # Environments
140
+ .env
141
+ .venv
142
+ env/
143
+ venv/
144
+ ENV/
145
+ env.bak/
146
+ venv.bak/
147
+
148
+ # Spyder project settings
149
+ .spyderproject
150
+ .spyproject
151
+
152
+ # Rope project settings
153
+ .ropeproject
154
+
155
+ # mkdocs documentation
156
+ /site
157
+
158
+ # mypy
159
+ .mypy_cache/
160
+ .dmypy.json
161
+ dmypy.json
162
+
163
+ # Pyre type checker
164
+ .pyre/
165
+
166
+ # pytype static type analyzer
167
+ .pytype/
168
+
169
+ # Cython debug symbols
170
+ cython_debug/
171
+
172
+ # PyCharm
173
+ # JetBrains specific template is maintained in a separate JetBrains.gitignore that can
174
+ # be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
175
+ # and can be added to the global gitignore or merged into this file. For a more nuclear
176
+ # option (not recommended) you can uncomment the following to ignore the entire idea folder.
177
+ .idea/
178
+
179
+ # Logs
180
+ logs
181
+ *.log
182
+ npm-debug.log*
183
+ yarn-debug.log*
184
+ yarn-error.log*
185
+ lerna-debug.log*
186
+ .pnpm-debug.log*
187
+
188
+ # Diagnostic reports (https://nodejs.org/api/report.html)
189
+ report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
190
+
191
+ # Runtime data
192
+ pids
193
+ *.pid
194
+ *.seed
195
+ *.pid.lock
196
+
197
+ # Directory for instrumented libs generated by jscoverage/JSCover
198
+ lib-cov
199
+
200
+ # Coverage directory used by tools like istanbul
201
+ coverage
202
+ *.lcov
203
+
204
+ # nyc test coverage
205
+ .nyc_output
206
+
207
+ # Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
208
+ .grunt
209
+
210
+ # Bower dependency directory (https://bower.io/)
211
+ bower_components
212
+
213
+ # node-waf configuration
214
+ .lock-wscript
215
+
216
+ # Compiled binary addons (https://nodejs.org/api/addons.html)
217
+ build/Release
218
+
219
+ # Dependency directories
220
+ node_modules/
221
+ jspm_packages/
222
+
223
+ # Snowpack dependency directory (https://snowpack.dev/)
224
+ web_modules/
225
+
226
+ # TypeScript cache
227
+ *.tsbuildinfo
228
+
229
+ # Optional npm cache directory
230
+ .npm
231
+
232
+ # Optional eslint cache
233
+ .eslintcache
234
+
235
+ # Optional stylelint cache
236
+ .stylelintcache
237
+
238
+ # Microbundle cache
239
+ .rpt2_cache/
240
+ .rts2_cache_cjs/
241
+ .rts2_cache_es/
242
+ .rts2_cache_umd/
243
+
244
+ # Optional REPL history
245
+ .node_repl_history
246
+
247
+ # Output of 'npm pack'
248
+ *.tgz
249
+
250
+ # Yarn Integrity file
251
+ .yarn-integrity
252
+
253
+ # dotenv environment variable files
254
+ .env
255
+ .env.development.local
256
+ .env.test.local
257
+ .env.production.local
258
+ .env.local
259
+
260
+ # parcel-bundler cache (https://parceljs.org/)
261
+ .cache
262
+ .parcel-cache
263
+
264
+ # Next.js build output
265
+ .next
266
+ out
267
+
268
+ # Nuxt.js build / generate output
269
+ .nuxt
270
+ dist
271
+
272
+ # Gatsby files
273
+ .cache/
274
+ # Comment in the public line in if your project uses Gatsby and not Next.js
275
+ # https://nextjs.org/blog/next-9-1#public-directory-support
276
+ # public
277
+
278
+ # vuepress build output
279
+ .vuepress/dist
280
+
281
+ # vuepress v2.x temp and cache directory
282
+ .temp
283
+ .cache
284
+
285
+ # Docusaurus cache and generated files
286
+ .docusaurus
287
+
288
+ # Serverless directories
289
+ .serverless/
290
+
291
+ # FuseBox cache
292
+ .fusebox/
293
+
294
+ # DynamoDB Local files
295
+ .dynamodb/
296
+
297
+ # TernJS port file
298
+ .tern-port
299
+
300
+ # Stores VSCode versions used for testing VSCode extensions
301
+ .vscode-test
302
+
303
+ # yarn v2
304
+ .yarn/cache
305
+ .yarn/unplugged
306
+ .yarn/build-state.yml
307
+ .yarn/install-state.gz
308
+ .pnp.*
309
+
310
+ # cypress artifacts
311
+ cypress/videos
312
+ cypress/screenshots
313
+
314
+
315
+
316
+ /static/*
.prettierrc ADDED
@@ -0,0 +1,9 @@
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "useTabs": true,
3
+ "singleQuote": true,
4
+ "trailingComma": "none",
5
+ "printWidth": 100,
6
+ "plugins": ["prettier-plugin-svelte"],
7
+ "pluginSearchDirs": ["."],
8
+ "overrides": [{ "files": "*.svelte", "options": { "parser": "svelte" } }]
9
+ }
CHANGELOG.md ADDED
@@ -0,0 +1,1314 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Changelog
2
+
3
+ All notable changes to this project will be documented in this file.
4
+
5
+ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
6
+ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
+
8
+ ## [0.4.3] - 2024-11-21
9
+
10
+ ### Added
11
+
12
+ - **📚 Inline Citations for RAG Results**: Get seamless inline citations for Retrieval-Augmented Generation (RAG) responses using the default RAG prompt. Note: This feature only supports newly uploaded files, improving traceability and providing source clarity.
13
+ - **🎨 Better Rich Text Input Support**: Enjoy smoother and more reliable rich text formatting for chats, enhancing communication quality.
14
+ - **⚡ Faster Model Retrieval**: Implemented caching optimizations for faster model loading, providing a noticeable speed boost across workflows. Further improvements are on the way!
15
+
16
+ ### Fixed
17
+
18
+ - **🔗 Pipelines Feature Restored**: Resolved a critical issue that previously prevented Pipelines from functioning, ensuring seamless workflows.
19
+ - **✏️ Missing Suffix Field in Ollama Form**: Added the missing "suffix" field to the Ollama generate form, enhancing customization options.
20
+
21
+ ### Changed
22
+
23
+ - **🗂️ Renamed "Citations" to "Sources"**: Improved clarity and consistency by renaming the "citations" field to "sources" in messages.
24
+
25
+ ## [0.4.2] - 2024-11-20
26
+
27
+ ### Fixed
28
+
29
+ - **📁 Knowledge Files Visibility Issue**: Resolved the bug preventing individual files in knowledge collections from displaying when referenced with '#'.
30
+ - **🔗 OpenAI Endpoint Prefix**: Fixed the issue where certain OpenAI connections that deviate from the official API spec weren’t working correctly with prefixes.
31
+ - **⚔️ Arena Model Access Control**: Corrected an issue where arena model access control settings were not being saved.
32
+ - **🔧 Usage Capability Selector**: Fixed the broken usage capabilities selector in the model editor.
33
+
34
+ ## [0.4.1] - 2024-11-19
35
+
36
+ ### Added
37
+
38
+ - **📊 Enhanced Feedback System**: Introduced a detailed 1-10 rating scale for feedback alongside thumbs up/down, preparing for more precise model fine-tuning and improving feedback quality.
39
+ - **ℹ️ Tool Descriptions on Hover**: Easily access tool descriptions by hovering over the message input, providing a smoother workflow with more context when utilizing tools.
40
+
41
+ ### Fixed
42
+
43
+ - **🗑️ Graceful Handling of Deleted Users**: Resolved an issue where deleted users caused workspace items (models, knowledge, prompts, tools) to fail, ensuring reliable workspace loading.
44
+ - **🔑 API Key Creation**: Fixed an issue preventing users from creating new API keys, restoring secure and seamless API management.
45
+ - **🔗 HTTPS Proxy Fix**: Corrected HTTPS proxy issues affecting the '/api/v1/models/' endpoint, ensuring smoother, uninterrupted model management.
46
+
47
+ ## [0.4.0] - 2024-11-19
48
+
49
+ ### Added
50
+
51
+ - **👥 User Groups**: You can now create and manage user groups, making user organization seamless.
52
+ - **🔐 Group-Based Access Control**: Set granular access to models, knowledge, prompts, and tools based on user groups, allowing for more controlled and secure environments.
53
+ - **🛠️ Group-Based User Permissions**: Easily manage workspace permissions. Grant users the ability to upload files, delete, edit, or create temporary chats, as well as define their ability to create models, knowledge, prompts, and tools.
54
+ - **🔑 LDAP Support**: Newly introduced LDAP authentication adds robust security and scalability to user management.
55
+ - **🌐 Enhanced OpenAI-Compatible Connections**: Added prefix ID support to avoid model ID clashes, with explicit model ID support for APIs lacking '/models' endpoint support, ensuring smooth operation with custom setups.
56
+ - **🔐 Ollama API Key Support**: Now manage credentials for Ollama when set behind proxies, including the option to utilize prefix ID for proper distinction across multiple Ollama instances.
57
+ - **🔄 Connection Enable/Disable Toggle**: Easily enable or disable individual OpenAI and Ollama connections as needed.
58
+ - **🎨 Redesigned Model Workspace**: Freshly redesigned to improve usability for managing models across users and groups.
59
+ - **🎨 Redesigned Prompt Workspace**: A fresh UI to conveniently organize and manage prompts.
60
+ - **🧩 Sorted Functions Workspace**: Functions are now automatically categorized by type (Action, Filter, Pipe), streamlining management.
61
+ - **💻 Redesigned Collaborative Workspace**: Enhanced support for multiple users contributing to models, knowledge, prompts, or tools, improving collaboration.
62
+ - **🔧 Auto-Selected Tools in Model Editor**: Tools enabled through the model editor are now automatically selected, whereas previously it only gave users the option to enable the tool, reducing manual steps and enhancing efficiency.
63
+ - **🔔 Web Search & Tools Indicator**: A clear indication now shows when web search or tools are active, reducing confusion.
64
+ - **🔑 Toggle API Key Auth**: Tighten security by easily enabling or disabling API key authentication option for Open WebUI.
65
+ - **🗂️ Agentic Retrieval**: Improve RAG accuracy via smart pre-processing of chat history to determine the best queries before retrieval.
66
+ - **📁 Large Text as File Option**: Optionally convert large pasted text into a file upload, keeping the chat interface cleaner.
67
+ - **🗂️ Toggle Citations for Models**: Ability to disable citations has been introduced in the model editor.
68
+ - **🔍 User Settings Search**: Quickly search for settings fields, improving ease of use and navigation.
69
+ - **🗣️ Experimental SpeechT5 TTS**: Local SpeechT5 support added for improved text-to-speech capabilities.
70
+ - **🔄 Unified Reset for Models**: A one-click option has been introduced to reset and remove all models from the Admin Settings.
71
+ - **🛠️ Initial Setup Wizard**: The setup process now explicitly informs users that they are creating an admin account during the first-time setup, ensuring clarity. Previously, users encountered the login page right away without this distinction.
72
+ - **🌐 Enhanced Translations**: Several language translations, including Ukrainian, Norwegian, and Brazilian Portuguese, were refined for better localization.
73
+
74
+ ### Fixed
75
+
76
+ - **🎥 YouTube Video Attachments**: Fixed issues preventing proper loading and attachment of YouTube videos as files.
77
+ - **🔄 Shared Chat Update**: Corrected issues where shared chats were not updating, improving collaboration consistency.
78
+ - **🔍 DuckDuckGo Rate Limit Fix**: Addressed issues with DuckDuckGo search integration, enhancing search stability and performance when operating within rate limits.
79
+ - **🧾 Citations Relevance Fix**: Adjusted the relevance percentage calculation for citations, so that Open WebUI properly reflect the accuracy of a retrieved document in RAG, ensuring users get clearer insights into sources.
80
+ - **🔑 Jina Search API Key Requirement**: Added the option to input an API key for Jina Search, ensuring smooth functionality as keys are now mandatory.
81
+
82
+ ### Changed
83
+
84
+ - **🛠️ Functions Moved to Admin Panel**: As Functions operate as advanced plugins, they are now accessible from the Admin Panel instead of the workspace.
85
+ - **🛠️ Manage Ollama Connections**: The "Models" section in Admin Settings has been relocated to Admin Settings > "Connections" > Ollama Connections. You can now manage Ollama instances via a dedicated "Manage Ollama" modal from "Connections", streamlining the setup and configuration of Ollama models.
86
+ - **📊 Base Models in Admin Settings**: Admins can now find all base models, both connections or functions, in the "Models" Admin setting. Global model accessibility can be enabled or disabled here. Models are private by default, requiring explicit permission assignment for user access.
87
+ - **📌 Sticky Model Selection for New Chats**: The model chosen from a previous chat now persists when creating a new chat. If you click "New Chat" again from the new chat page, it will revert to your default model.
88
+ - **🎨 Design Refactoring**: Overall design refinements across the platform have been made, providing a more cohesive and polished user experience.
89
+
90
+ ### Removed
91
+
92
+ - **📂 Model List Reordering**: Temporarily removed and will be reintroduced in upcoming user group settings improvements.
93
+ - **⚙️ Default Model Setting**: Removed the ability to set a default model for users, will be reintroduced with user group settings in the future.
94
+
95
+ ## [0.3.35] - 2024-10-26
96
+
97
+ ### Added
98
+
99
+ - **🌐 Translation Update**: Added translation labels in the SearchInput and CreateCollection components and updated Brazilian Portuguese translation (pt-BR)
100
+ - **📁 Robust File Handling**: Enhanced file input handling for chat. If the content extraction fails or is empty, users will now receive a clear warning, preventing silent failures and ensuring you always know what's happening with your uploads.
101
+ - **🌍 New Language Support**: Introduced Hungarian translations and updated French translations, expanding the platform's language accessibility for a more global user base.
102
+
103
+ ### Fixed
104
+
105
+ - **📚 Knowledge Base Loading Issue**: Resolved a critical bug where the Knowledge Base was not loading, ensuring smooth access to your stored documents and improving information retrieval in RAG-enhanced workflows.
106
+ - **🛠️ Tool Parameters Issue**: Fixed an error where tools were not functioning correctly when required parameters were missing, ensuring reliable tool performance and more efficient task completions.
107
+ - **🔗 Merged Response Loss in Multi-Model Chats**: Addressed an issue where responses in multi-model chat workflows were being deleted after follow-up queries, improving consistency and ensuring smoother interactions across models.
108
+
109
+ ## [0.3.34] - 2024-10-26
110
+
111
+ ### Added
112
+
113
+ - **🔧 Feedback Export Enhancements**: Feedback history data can now be exported to JSON, allowing for seamless integration in RLHF processing and further analysis.
114
+ - **🗂️ Embedding Model Lazy Loading**: Search functionality for leaderboard reranking is now more efficient, as embedding models are lazy-loaded only when needed, optimizing performance.
115
+ - **🎨 Rich Text Input Toggle**: Users can now switch back to legacy textarea input for chat if they prefer simpler text input, though rich text is still the default until deprecation.
116
+ - **🛠️ Improved Tool Calling Mechanism**: Enhanced method for parsing and calling tools, improving the reliability and robustness of tool function calls.
117
+ - **🌐 Globalization Enhancements**: Updates to internationalization (i18n) support, further refining multi-language compatibility and accuracy.
118
+
119
+ ### Fixed
120
+
121
+ - **🖥️ Folder Rename Fix for Firefox**: Addressed a persistent issue where users could not rename folders by pressing enter in Firefox, now ensuring seamless folder management across browsers.
122
+ - **🔠 Tiktoken Model Text Splitter Issue**: Resolved an issue where the tiktoken text splitter wasn’t working in Docker installations, restoring full functionality for tokenized text editing.
123
+ - **💼 S3 File Upload Issue**: Fixed a problem affecting S3 file uploads, ensuring smooth operations for those who store files on cloud storage.
124
+ - **🔒 Strict-Transport-Security Crash**: Resolved a crash when setting the Strict-Transport-Security (HSTS) header, improving stability and security enhancements.
125
+ - **🚫 OIDC Boolean Access Fix**: Addressed an issue with boolean values not being accessed correctly during OIDC logins, ensuring login reliability.
126
+ - **⚙️ Rich Text Paste Behavior**: Refined paste behavior in rich text input to make it smoother and more intuitive when pasting various content types.
127
+ - **🔨 Model Exclusion for Arena Fix**: Corrected the filter function that was not properly excluding models from the arena, improving model management.
128
+ - **🏷️ "Tags Generation Prompt" Fix**: Addressed an issue preventing custom "tags generation prompts" from registering properly, ensuring custom prompt work seamlessly.
129
+
130
+ ## [0.3.33] - 2024-10-24
131
+
132
+ ### Added
133
+
134
+ - **🏆 Evaluation Leaderboard**: Easily track your performance through a new leaderboard system where your ratings contribute to a real-time ranking based on the Elo system. Sibling responses (regenerations, many model chats) are required for your ratings to count in the leaderboard. Additionally, you can opt-in to share your feedback history and be part of the community-wide leaderboard. Expect further improvements as we refine the algorithm—help us build the best community leaderboard!
135
+ - **⚔️ Arena Model Evaluation**: Enable blind A/B testing of models directly from Admin Settings > Evaluation for a true side-by-side comparison. Ideal for pinpointing the best model for your needs.
136
+ - **🎯 Topic-Based Leaderboard**: Discover more accurate rankings with experimental topic-based reranking, which adjusts leaderboard standings based on tag similarity in feedback. Get more relevant insights based on specific topics!
137
+ - **📁 Folders Support for Chats**: Organize your chats better by grouping them into folders. Drag and drop chats between folders and export them seamlessly for easy sharing or analysis.
138
+ - **📤 Easy Chat Import via Drag & Drop**: Save time by simply dragging and dropping chat exports (JSON) directly onto the sidebar to import them into your workspace—streamlined, efficient, and intuitive!
139
+ - **📚 Enhanced Knowledge Collection**: Now, you can reference individual files from a knowledge collection—ideal for more precise Retrieval-Augmented Generations (RAG) queries and document analysis.
140
+ - **🏷️ Enhanced Tagging System**: Tags now take up less space! Utilize the new 'tag:' query system to manage, search, and organize your conversations more effectively without cluttering the interface.
141
+ - **🧠 Auto-Tagging for Chats**: Your conversations are now automatically tagged for improved organization, mirroring the efficiency of auto-generated titles.
142
+ - **🔍 Backend Chat Query System**: Chat filtering has become more efficient, now handled through the backend\*\* instead of your browser, improving search performance and accuracy.
143
+ - **🎮 Revamped Playground**: Experience a refreshed and optimized Playground for smoother testing, tweaks, and experimentation of your models and tools.
144
+ - **🧩 Token-Based Text Splitter**: Introducing token-based text splitting (tiktoken), giving you more precise control over how text is processed. Previously, only character-based splitting was available.
145
+ - **🔢 Ollama Batch Embeddings**: Leverage new batch embedding support for improved efficiency and performance with Ollama embedding models.
146
+ - **🔍 Enhanced Add Text Content Modal**: Enjoy a cleaner, more intuitive workflow for adding and curating knowledge content with an upgraded input modal from our Knowledge workspace.
147
+ - **🖋️ Rich Text Input for Chats**: Make your chat inputs more dynamic with support for rich text formatting. Your conversations just got a lot more polished and professional.
148
+ - **⚡ Faster Whisper Model Configurability**: Customize your local faster whisper model directly from the WebUI.
149
+ - **☁️ Experimental S3 Support**: Enable stateless WebUI instances with S3 support, greatly enhancing scalability and balancing heavy workloads.
150
+ - **🔕 Disable Update Toast**: Now you can streamline your workspace even further—choose to disable update notifications for a more focused experience.
151
+ - **🌟 RAG Citation Relevance Percentage**: Easily assess citation accuracy with the addition of relevance percentages in RAG results.
152
+ - **⚙️ Mermaid Copy Button**: Mermaid diagrams now come with a handy copy button, simplifying the extraction and use of diagram contents directly in your workflow.
153
+ - **🎨 UI Redesign**: Major interface redesign that will make navigation smoother, keep your focus where it matters, and ensure a modern look.
154
+
155
+ ### Fixed
156
+
157
+ - **🎙️ Voice Note Mic Stopping Issue**: Fixed the issue where the microphone stayed active after ending a voice note recording, ensuring your audio workflow runs smoothly.
158
+
159
+ ### Removed
160
+
161
+ - **👋 Goodbye Sidebar Tags**: Sidebar tag clutter is gone. We’ve shifted tag buttons to more effective query-based tag filtering for a sleeker, more agile interface.
162
+
163
+ ## [0.3.32] - 2024-10-06
164
+
165
+ ### Added
166
+
167
+ - **🔢 Workspace Enhancements**: Added a display count for models, prompts, tools, and functions in the workspace, providing a clear overview and easier management.
168
+
169
+ ### Fixed
170
+
171
+ - **🖥️ Web and YouTube Attachment Fix**: Resolved an issue where attaching web links and YouTube videos was malfunctioning, ensuring seamless integration and display within chats.
172
+ - **📞 Call Mode Activation on Landing Page**: Fixed a bug where call mode was not operational from the landing page.
173
+
174
+ ### Changed
175
+
176
+ - **🔄 URL Parameter Refinement**: Updated the 'tool_ids' URL parameter to 'tools' or 'tool-ids' for more intuitive and consistent user experience.
177
+ - **🎨 Floating Buttons Styling Update**: Refactored the styling of floating buttons to intelligently adjust to the left side when there isn't enough room on the right, improving interface usability and aesthetic.
178
+ - **🔧 Enhanced Accessibility for Floating Buttons**: Implemented the ability to close floating buttons with the 'Esc' key, making workflow smoother and more efficient for users navigating via keyboard.
179
+ - **🖇️ Updated Information URL**: Information URLs now direct users to a general release page rather than a version-specific URL, ensuring access to the latest and relevant details all in one place.
180
+ - **📦 Library Dependencies Update**: Upgraded dependencies to ensure compatibility and performance optimization for pip installs.
181
+
182
+ ## [0.3.31] - 2024-10-06
183
+
184
+ ### Added
185
+
186
+ - **📚 Knowledge Feature**: Reimagined documents feature, now more performant with a better UI for enhanced organization; includes streamlined API integration for Retrieval-Augmented Generation (RAG). Detailed documentation forthcoming: https://docs.openwebui.com/
187
+ - **🌐 New Landing Page**: Freshly designed landing page; toggle between the new UI and the classic chat UI from Settings > Interface for a personalized experience.
188
+ - **📁 Full Document Retrieval Mode**: Toggle between full document retrieval or traditional snippets by clicking on the file item. This mode enhances document capabilities and supports comprehensive tasks like summarization by utilizing the entire content instead of RAG.
189
+ - **📄 Extracted File Content Display**: View extracted content directly by clicking on the file item, simplifying file analysis.
190
+ - **🎨 Artifacts Feature**: Render web content and SVGs directly in the interface, supporting quick iterations and live changes.
191
+ - **🖊️ Editable Code Blocks**: Supercharged code blocks now allow live editing directly in the LLM response, with live reloads supported by artifacts.
192
+ - **🔧 Code Block Enhancements**: Introduced a floating copy button in code blocks to facilitate easier code copying without scrolling.
193
+ - **🔍 SVG Pan/Zoom**: Enhanced interaction with SVG images, including Mermaid diagrams, via new pan and zoom capabilities.
194
+ - **🔍 Text Select Quick Actions**: New floating buttons appear when text is highlighted in LLM responses, offering deeper interactions like "Ask a Question" or "Explain".
195
+ - **🗃️ Database Pool Configuration**: Enhanced database handling to support scalable user growth.
196
+ - **🔊 Experimental Audio Compression**: Compress audio files to navigate around the 25MB limit for OpenAI's speech-to-text processing.
197
+ - **🔍 Query Embedding**: Adjusted embedding behavior to enhance system performance by not repeating query embedding.
198
+ - **💾 Lazy Load Optimizations**: Implemented lazy loading of large dependencies to minimize initial memory usage, boosting performance.
199
+ - **🍏 Apple Touch Icon Support**: Optimizes the display of icons for web bookmarks on Apple mobile devices.
200
+ - **🔽 Expandable Content Markdown Support**: Introducing 'details', 'summary' tag support for creating expandable content sections in markdown, facilitating cleaner, organized documentation and interactive content display.
201
+
202
+ ### Fixed
203
+
204
+ - **🔘 Action Button Issue**: Resolved a bug where action buttons were not functioning, enhancing UI reliability.
205
+ - **🔄 Multi-Model Chat Loop**: Fixed an infinite loop issue in multi-model chat environments, ensuring smoother chat operations.
206
+ - **📄 Chat PDF/TXT Export Issue**: Resolved problems with exporting chat logs to PDF and TXT formats.
207
+ - **🔊 Call to Text-to-Speech Issues**: Rectified problems with text-to-speech functions to improve audio interactions.
208
+
209
+ ### Changed
210
+
211
+ - **⚙️ Endpoint Renaming**: Renamed 'rag' endpoints to 'retrieval' for clearer function description.
212
+ - **🎨 Styling and Interface Updates**: Multiple refinements across the platform to enhance visual appeal and user interaction.
213
+
214
+ ### Removed
215
+
216
+ - **🗑️ Deprecated 'DOCS_DIR'**: Removed the outdated 'docs_dir' variable in favor of more direct file management solutions, with direct file directory syncing and API uploads for a more integrated experience.
217
+
218
+ ## [0.3.30] - 2024-09-26
219
+
220
+ ### Fixed
221
+
222
+ - **🍞 Update Available Toast Dismissal**: Enhanced user experience by ensuring that once the update available notification is dismissed, it won't reappear for 24 hours.
223
+ - **📋 Ollama /embed Form Data**: Adjusted the integration inaccuracies in the /embed form data to ensure it perfectly matches with Ollama's specifications.
224
+ - **🔧 O1 Max Completion Tokens Issue**: Resolved compatibility issues with OpenAI's o1 models max_completion_tokens param to ensure smooth operation.
225
+ - **🔄 Pip Install Database Issue**: Fixed a critical issue where database changes during pip installations were reverting and not saving chat logs, now ensuring data persistence and reliability in chat operations.
226
+ - **🏷️ Chat Rename Tab Update**: Fixed the functionality to change the web browser's tab title simultaneously when a chat is renamed, keeping tab titles consistent.
227
+
228
+ ## [0.3.29] - 2023-09-25
229
+
230
+ ### Fixed
231
+
232
+ - **🔧 KaTeX Rendering Improvement**: Resolved specific corner cases in KaTeX rendering to enhance the display of complex mathematical notation.
233
+ - **📞 'Call' URL Parameter Fix**: Corrected functionality for 'call' URL search parameter ensuring reliable activation of voice calls through URL triggers.
234
+ - **🔄 Configuration Reset Fix**: Fixed the RESET_CONFIG_ON_START to ensure settings revert to default correctly upon each startup, improving reliability in configuration management.
235
+ - **🌍 Filter Outlet Hook Fix**: Addressed issues in the filter outlet hook, ensuring all filter functions operate as intended.
236
+
237
+ ## [0.3.28] - 2024-09-24
238
+
239
+ ### Fixed
240
+
241
+ - **🔍 Web Search Functionality**: Corrected an issue where the web search option was not functioning properly.
242
+
243
+ ## [0.3.27] - 2024-09-24
244
+
245
+ ### Fixed
246
+
247
+ - **🔄 Periodic Cleanup Error Resolved**: Fixed a critical RuntimeError related to the 'periodic_usage_pool_cleanup' coroutine, ensuring smooth and efficient performance post-pip install, correcting a persisting issue from version 0.3.26.
248
+ - **📊 Enhanced LaTeX Rendering**: Improved rendering for LaTeX content, enhancing clarity and visual presentation in documents and mathematical models.
249
+
250
+ ## [0.3.26] - 2024-09-24
251
+
252
+ ### Fixed
253
+
254
+ - **🔄 Event Loop Error Resolution**: Addressed a critical error where a missing running event loop caused 'periodic_usage_pool_cleanup' to fail with pip installs. This fix ensures smoother and more reliable updates and installations, enhancing overall system stability.
255
+
256
+ ## [0.3.25] - 2024-09-24
257
+
258
+ ### Fixed
259
+
260
+ - **🖼️ Image Generation Functionality**: Resolved an issue where image generation was not functioning, restoring full capability for visual content creation.
261
+ - **⚖️ Rate Response Corrections**: Addressed a problem where rate responses were not working, ensuring reliable feedback mechanisms are operational.
262
+
263
+ ## [0.3.24] - 2024-09-24
264
+
265
+ ### Added
266
+
267
+ - **🚀 Rendering Optimization**: Significantly improved message rendering performance, enhancing user experience and webui responsiveness.
268
+ - **💖 Favorite Response Feature in Chat Overview**: Users can now mark responses as favorite directly from the chat overview, enhancing ease of retrieval and organization of preferred responses.
269
+ - **💬 Create Message Pairs with Shortcut**: Implemented creation of new message pairs using Cmd/Ctrl+Shift+Enter, making conversation editing faster and more intuitive.
270
+ - **🌍 Expanded User Prompt Variables**: Added weekday, timezone, and language information variables to user prompts to match system prompt variables.
271
+ - **🎵 Enhanced Audio Support**: Now includes support for 'audio/x-m4a' files, broadening compatibility with audio content within the platform.
272
+ - **🔏 Model URL Search Parameter**: Added an ability to select a model directly via URL parameters, streamlining navigation and model access.
273
+ - **📄 Enhanced PDF Citations**: PDF citations now open at the associated page, streamlining reference checks and document handling.
274
+ - **🔧Use of Redis in Sockets**: Enhanced socket implementation to fully support Redis, enabling effective stateless instances suitable for scalable load balancing.
275
+ - **🌍 Stream Individual Model Responses**: Allows specific models to have individualized streaming settings, enhancing performance and customization.
276
+ - **🕒 Display Model Hash and Last Modified Timestamp for Ollama Models**: Provides critical model details directly in the Models workspace for enhanced tracking.
277
+ - **❗ Update Info Notification for Admins**: Ensures administrators receive immediate updates upon login, keeping them informed of the latest changes and system statuses.
278
+
279
+ ### Fixed
280
+
281
+ - **🗑️ Temporary File Handling On Windows**: Fixed an issue causing errors when accessing a temporary file being used by another process, Tools & Functions should now work as intended.
282
+ - **🔓 Authentication Toggle Issue**: Resolved the malfunction where setting 'WEBUI_AUTH=False' did not appropriately disable authentication, ensuring that user experience and system security settings function as configured.
283
+ - **🔧 Save As Copy Issue for Many Model Chats**: Resolved an error preventing users from save messages as copies in many model chats.
284
+ - **🔒 Sidebar Closure on Mobile**: Resolved an issue where the mobile sidebar remained open after menu engagement, improving user interface responsivity and comfort.
285
+ - **🛡️ Tooltip XSS Vulnerability**: Resolved a cross-site scripting (XSS) issue within tooltips, ensuring enhanced security and data integrity during user interactions.
286
+
287
+ ### Changed
288
+
289
+ - **↩️ Deprecated Interface Stream Response Settings**: Moved to advanced parameters to streamline interface settings and enhance user clarity.
290
+ - **⚙️ Renamed 'speedRate' to 'playbackRate'**: Standardizes terminology, improving usability and understanding in media settings.
291
+
292
+ ## [0.3.23] - 2024-09-21
293
+
294
+ ### Added
295
+
296
+ - **🚀 WebSocket Redis Support**: Enhanced load balancing capabilities for multiple instance setups, promoting better performance and reliability in WebUI.
297
+ - **🔧 Adjustable Chat Controls**: Introduced width-adjustable chat controls, enabling a personalized and more comfortable user interface.
298
+ - **🌎 i18n Updates**: Improved and updated the Chinese translations.
299
+
300
+ ### Fixed
301
+
302
+ - **🌐 Task Model Unloading Issue**: Modified task handling to use the Ollama /api/chat endpoint instead of OpenAI compatible endpoint, ensuring models stay loaded and ready with custom parameters, thus minimizing delays in task execution.
303
+ - **📝 Title Generation Fix for OpenAI Compatible APIs**: Resolved an issue preventing the generation of titles, enhancing consistency and reliability when using multiple API providers.
304
+ - **🗃️ RAG Duplicate Collection Issue**: Fixed a bug causing repeated processing of the same uploaded file. Now utilizes indexed files to prevent unnecessary duplications, optimizing resource usage.
305
+ - **🖼️ Image Generation Enhancement**: Refactored OpenAI image generation endpoint to be asynchronous, preventing the WebUI from becoming unresponsive during processing, thus enhancing user experience.
306
+ - **🔓 Downgrade Authlib**: Reverted Authlib to version 1.3.1 to address and resolve issues concerning OAuth functionality.
307
+
308
+ ### Changed
309
+
310
+ - **🔍 Improved Message Interaction**: Enhanced the message node interface to allow for easier focus redirection with a simple click, streamlining user interaction.
311
+ - **✨ Styling Refactor**: Updated WebUI styling for a cleaner, more modern look, enhancing user experience across the platform.
312
+
313
+ ## [0.3.22] - 2024-09-19
314
+
315
+ ### Added
316
+
317
+ - **⭐ Chat Overview**: Introducing a node-based interactive messages diagram for improved visualization of conversation flows.
318
+ - **🔗 Multiple Vector DB Support**: Now supports multiple vector databases, including the newly added Milvus support. Community contributions for additional database support are highly encouraged!
319
+ - **📡 Experimental Non-Stream Chat Completion**: Experimental feature allowing the use of OpenAI o1 models, which do not support streaming, ensuring more versatile model deployment.
320
+ - **🔍 Experimental Colbert-AI Reranker Integration**: Added support for "jinaai/jina-colbert-v2" as a reranker, enhancing search relevance and accuracy. Note: it may not function at all on low-spec computers.
321
+ - **🕸️ ENABLE_WEBSOCKET_SUPPORT**: Added environment variable for instances to ignore websocket upgrades, stabilizing connections on platforms with websocket issues.
322
+ - **🔊 Azure Speech Service Integration**: Added support for Azure Speech services for Text-to-Speech (TTS).
323
+ - **🎚️ Customizable Playback Speed**: Playback speed control is now available in Call mode settings, allowing users to adjust audio playback speed to their preferences.
324
+ - **🧠 Enhanced Error Messaging**: System now displays helpful error messages directly to users during chat completion issues.
325
+ - **📂 Save Model as Transparent PNG**: Model profile images are now saved as PNGs, supporting transparency and improving visual integration.
326
+ - **📱 iPhone Compatibility Adjustments**: Added padding to accommodate the iPhone navigation bar, improving UI display on these devices.
327
+ - **🔗 Secure Response Headers**: Implemented security response headers, bolstering web application security.
328
+ - **🔧 Enhanced AUTOMATIC1111 Settings**: Users can now configure 'CFG Scale', 'Sampler', and 'Scheduler' parameters directly in the admin settings, enhancing workflow flexibility without source code modifications.
329
+ - **🌍 i18n Updates**: Enhanced translations for Chinese, Ukrainian, Russian, and French, fostering a better localized experience.
330
+
331
+ ### Fixed
332
+
333
+ - **🛠️ Chat Message Deletion**: Resolved issues with chat message deletion, ensuring a smoother user interaction and system stability.
334
+ - **🔢 Ordered List Numbering**: Fixed the incorrect ordering in lists.
335
+
336
+ ### Changed
337
+
338
+ - **🎨 Transparent Icon Handling**: Allowed model icons to be displayed on transparent backgrounds, improving UI aesthetics.
339
+ - **📝 Improved RAG Template**: Enhanced Retrieval-Augmented Generation template, optimizing context handling and error checking for more precise operation.
340
+
341
+ ## [0.3.21] - 2024-09-08
342
+
343
+ ### Added
344
+
345
+ - **📊 Document Count Display**: Now displays the total number of documents directly within the dashboard.
346
+ - **🚀 Ollama Embed API Endpoint**: Enabled /api/embed endpoint proxy support.
347
+
348
+ ### Fixed
349
+
350
+ - **🐳 Docker Launch Issue**: Resolved the problem preventing Open-WebUI from launching correctly when using Docker.
351
+
352
+ ### Changed
353
+
354
+ - **🔍 Enhanced Search Prompts**: Improved the search query generation prompts for better accuracy and user interaction, enhancing the overall search experience.
355
+
356
+ ## [0.3.20] - 2024-09-07
357
+
358
+ ### Added
359
+
360
+ - **🌐 Translation Update**: Updated Catalan translations to improve user experience for Catalan speakers.
361
+
362
+ ### Fixed
363
+
364
+ - **📄 PDF Download**: Resolved a configuration issue with fonts directory, ensuring PDFs are now downloaded with the correct formatting.
365
+ - **🛠️ Installation of Tools & Functions Requirements**: Fixed a bug where necessary requirements for tools and functions were not properly installing.
366
+ - **🔗 Inline Image Link Rendering**: Enabled rendering of images directly from links in chat.
367
+ - **📞 Post-Call User Interface Cleanup**: Adjusted UI behavior to automatically close chat controls after a voice call ends, reducing screen clutter.
368
+ - **🎙️ Microphone Deactivation Post-Call**: Addressed an issue where the microphone remained active after calls.
369
+ - **✍️ Markdown Spacing Correction**: Corrected spacing in Markdown rendering, ensuring text appears neatly and as expected.
370
+ - **🔄 Message Re-rendering**: Fixed an issue causing all response messages to re-render with each new message, now improving chat performance.
371
+
372
+ ### Changed
373
+
374
+ - **🌐 Refined Web Search Integration**: Deprecated the Search Query Generation Prompt threshold; introduced a toggle button for "Enable Web Search Query Generation" allowing users to opt-in to using web search more judiciously.
375
+ - **📝 Default Prompt Templates Update**: Emptied environment variable templates for search and title generation now default to the Open WebUI default prompt templates, simplifying configuration efforts.
376
+
377
+ ## [0.3.19] - 2024-09-05
378
+
379
+ ### Added
380
+
381
+ - **🌐 Translation Update**: Improved Chinese translations.
382
+
383
+ ### Fixed
384
+
385
+ - **📂 DATA_DIR Overriding**: Fixed an issue to avoid overriding DATA_DIR, preventing errors when directories are set identically, ensuring smoother operation and data management.
386
+ - **🛠️ Frontmatter Extraction**: Fixed the extraction process for frontmatter in tools and functions.
387
+
388
+ ### Changed
389
+
390
+ - **🎨 UI Styling**: Refined the user interface styling for enhanced visual coherence and user experience.
391
+
392
+ ## [0.3.18] - 2024-09-04
393
+
394
+ ### Added
395
+
396
+ - **🛠️ Direct Database Execution for Tools & Functions**: Enhanced the execution of Python files for tools and functions, now directly loading from the database for a more streamlined backend process.
397
+
398
+ ### Fixed
399
+
400
+ - **🔄 Automatic Rewrite of Import Statements in Tools & Functions**: Tool and function scripts that import 'utils', 'apps', 'main', 'config' will now automatically rename these with 'open_webui.', ensuring compatibility and consistency across different modules.
401
+ - **🎨 Styling Adjustments**: Minor fixes in the visual styling to improve user experience and interface consistency.
402
+
403
+ ## [0.3.17] - 2024-09-04
404
+
405
+ ### Added
406
+
407
+ - **🔄 Import/Export Configuration**: Users can now import and export webui configurations from admin settings > Database, simplifying setup replication across systems.
408
+ - **🌍 Web Search via URL Parameter**: Added support for activating web search directly through URL by setting 'web-search=true'.
409
+ - **🌐 SearchApi Integration**: Added support for SearchApi as an alternative web search provider, enhancing search capabilities within the platform.
410
+ - **🔍 Literal Type Support in Tools**: Tools now support the Literal type.
411
+ - **🌍 Updated Translations**: Improved translations for Chinese, Ukrainian, and Catalan.
412
+
413
+ ### Fixed
414
+
415
+ - **🔧 Pip Install Issue**: Resolved the issue where pip install failed due to missing 'alembic.ini', ensuring smoother installation processes.
416
+ - **🌃 Automatic Theme Update**: Fixed an issue where the color theme did not update dynamically with system changes.
417
+ - **🛠️ User Agent in ComfyUI**: Added default headers in ComfyUI to fix access issues, improving reliability in network communications.
418
+ - **🔄 Missing Chat Completion Response Headers**: Ensured proper return of proxied response headers during chat completion, improving API reliability.
419
+ - **🔗 Websocket Connection Prioritization**: Modified socket.io configuration to prefer websockets and more reliably fallback to polling, enhancing connection stability.
420
+ - **🎭 Accessibility Enhancements**: Added missing ARIA labels for buttons, improving accessibility for visually impaired users.
421
+ - **⚖️ Advanced Parameter**: Fixed an issue ensuring that advanced parameters are correctly applied in all scenarios, ensuring consistent behavior of user-defined settings.
422
+
423
+ ### Changed
424
+
425
+ - **🔁 Namespace Reorganization**: Reorganized all Python files under the 'open_webui' namespace to streamline the project structure and improve maintainability. Tools and functions importing from 'utils' should now use 'open_webui.utils'.
426
+ - **🚧 Dependency Updates**: Updated several backend dependencies like 'aiohttp', 'authlib', 'duckduckgo-search', 'flask-cors', and 'langchain' to their latest versions, enhancing performance and security.
427
+
428
+ ## [0.3.16] - 2024-08-27
429
+
430
+ ### Added
431
+
432
+ - **🚀 Config DB Migration**: Migrated configuration handling from config.json to the database, enabling high-availability setups and load balancing across multiple Open WebUI instances.
433
+ - **🔗 Call Mode Activation via URL**: Added a 'call=true' URL search parameter enabling direct shortcuts to activate call mode, enhancing user interaction on mobile devices.
434
+ - **✨ TTS Content Control**: Added functionality to control how message content is segmented for Text-to-Speech (TTS) generation requests, allowing for more flexible speech output options.
435
+ - **😄 Show Knowledge Search Status**: Enhanced model usage transparency by displaying status when working with knowledge-augmented models, helping users understand the system's state during queries.
436
+ - **👆 Click-to-Copy for Codespan**: Enhanced interactive experience in the WebUI by allowing users to click to copy content from code spans directly.
437
+ - **🚫 API User Blocking via Model Filter**: Introduced the ability to block API users based on customized model filters, enhancing security and control over API access.
438
+ - **🎬 Call Overlay Styling**: Adjusted call overlay styling on large screens to not cover the entire interface, but only the chat control area, for a more unobtrusive interaction experience.
439
+
440
+ ### Fixed
441
+
442
+ - **🔧 LaTeX Rendering Issue**: Addressed an issue that affected the correct rendering of LaTeX.
443
+ - **📁 File Leak Prevention**: Resolved the issue of uploaded files mistakenly being accessible across user chats.
444
+ - **🔧 Pipe Functions with '**files**' Param**: Fixed issues with '**files**' parameter not functioning correctly in pipe functions.
445
+ - **📝 Markdown Processing for RAG**: Fixed issues with processing Markdown in files.
446
+ - **🚫 Duplicate System Prompts**: Fixed bugs causing system prompts to duplicate.
447
+
448
+ ### Changed
449
+
450
+ - **🔋 Wakelock Permission**: Optimized the activation of wakelock to only engage during call mode, conserving device resources and improving battery performance during idle periods.
451
+ - **🔍 Content-Type for Ollama Chats**: Added 'application/x-ndjson' content-type to '/api/chat' endpoint responses to match raw Ollama responses.
452
+ - **✋ Disable Signups Conditionally**: Implemented conditional logic to disable sign-ups when 'ENABLE_LOGIN_FORM' is set to false.
453
+
454
+ ## [0.3.15] - 2024-08-21
455
+
456
+ ### Added
457
+
458
+ - **🔗 Temporary Chat Activation**: Integrated a new URL parameter 'temporary-chat=true' to enable temporary chat sessions directly through the URL.
459
+ - **🌄 ComfyUI Seed Node Support**: Introduced seed node support in ComfyUI for image generation, allowing users to specify node IDs for randomized seed assignment.
460
+
461
+ ### Fixed
462
+
463
+ - **🛠️ Tools and Functions**: Resolved a critical issue where Tools and Functions were not properly functioning, restoring full capability and reliability to these essential features.
464
+ - **🔘 Chat Action Button in Many Model Chat**: Fixed the malfunctioning of chat action buttons in many model chat environments, ensuring a smoother and more responsive user interaction.
465
+ - **⏪ Many Model Chat Compatibility**: Restored backward compatibility for many model chats.
466
+
467
+ ## [0.3.14] - 2024-08-21
468
+
469
+ ### Added
470
+
471
+ - **🛠️ Custom ComfyUI Workflow**: Deprecating several older environment variables, this enhancement introduces a new, customizable workflow for a more tailored user experience.
472
+ - **🔀 Merge Responses in Many Model Chat**: Enhances the dialogue by merging responses from multiple models into a single, coherent reply, improving the interaction quality in many model chats.
473
+ - **✅ Multiple Instances of Same Model in Chats**: Enhanced many model chat to support adding multiple instances of the same model.
474
+ - **🔧 Quick Actions in Model Workspace**: Enhanced Shift key quick actions for hiding/unhiding and deleting models, facilitating a smoother workflow.
475
+ - **🗨️ Markdown Rendering in User Messages**: User messages are now rendered in Markdown, enhancing readability and interaction.
476
+ - **💬 Temporary Chat Feature**: Introduced a temporary chat feature, deprecating the old chat history setting to enhance user interaction flexibility.
477
+ - **🖋️ User Message Editing**: Enhanced the user chat editing feature to allow saving changes without sending, providing more flexibility in message management.
478
+ - **🛡️ Security Enhancements**: Various security improvements implemented across the platform to ensure safer user experiences.
479
+ - **🌍 Updated Translations**: Enhanced translations for Chinese, Ukrainian, and Bahasa Malaysia, improving localization and user comprehension.
480
+
481
+ ### Fixed
482
+
483
+ - **📑 Mermaid Rendering Issue**: Addressed issues with Mermaid chart rendering to ensure clean and clear visual data representation.
484
+ - **🎭 PWA Icon Maskability**: Fixed the Progressive Web App icon to be maskable, ensuring proper display on various device home screens.
485
+ - **🔀 Cloned Model Chat Freezing Issue**: Fixed a bug where cloning many model chats would cause freezing, enhancing stability and responsiveness.
486
+ - **🔍 Generic Error Handling and Refinements**: Various minor fixes and refinements to address previously untracked issues, ensuring smoother operations.
487
+
488
+ ### Changed
489
+
490
+ - **🖼️ Image Generation Refactor**: Overhauled image generation processes for improved efficiency and quality.
491
+ - **🔨 Refactor Tool and Function Calling**: Refactored tool and function calling mechanisms for improved clarity and maintainability.
492
+ - **🌐 Backend Library Updates**: Updated critical backend libraries including SQLAlchemy, uvicorn[standard], faster-whisper, bcrypt, and boto3 for enhanced performance and security.
493
+
494
+ ### Removed
495
+
496
+ - **🚫 Deprecated ComfyUI Environment Variables**: Removed several outdated environment variables related to ComfyUI settings, simplifying configuration management.
497
+
498
+ ## [0.3.13] - 2024-08-14
499
+
500
+ ### Added
501
+
502
+ - **🎨 Enhanced Markdown Rendering**: Significant improvements in rendering markdown, ensuring smooth and reliable display of LaTeX and Mermaid charts, enhancing user experience with more robust visual content.
503
+ - **🔄 Auto-Install Tools & Functions Python Dependencies**: For 'Tools' and 'Functions', Open WebUI now automatically install extra python requirements specified in the frontmatter, streamlining setup processes and customization.
504
+ - **🌀 OAuth Email Claim Customization**: Introduced an 'OAUTH_EMAIL_CLAIM' variable to allow customization of the default "email" claim within OAuth configurations, providing greater flexibility in authentication processes.
505
+ - **📶 Websocket Reconnection**: Enhanced reliability with the capability to automatically reconnect when a websocket is closed, ensuring consistent and stable communication.
506
+ - **🤳 Haptic Feedback on Support Devices**: Android devices now support haptic feedback for an immersive tactile experience during certain interactions.
507
+
508
+ ### Fixed
509
+
510
+ - **🛠️ ComfyUI Performance Improvement**: Addressed an issue causing FastAPI to stall when ComfyUI image generation was active; now runs in a separate thread to prevent UI unresponsiveness.
511
+ - **🔀 Session Handling**: Fixed an issue mandating session_id on client-side to ensure smoother session management and transitions.
512
+ - **🖋️ Minor Bug Fixes and Format Corrections**: Various minor fixes including typo corrections, backend formatting improvements, and test amendments enhancing overall system stability and performance.
513
+
514
+ ### Changed
515
+
516
+ - **🚀 Migration to SvelteKit 2**: Upgraded the underlying framework to SvelteKit version 2, offering enhanced speed, better code structure, and improved deployment capabilities.
517
+ - **🧹 General Cleanup and Refactoring**: Performed broad cleanup and refactoring across the platform, improving code efficiency and maintaining high standards of code health.
518
+ - **🚧 Integration Testing Improvements**: Modified how Cypress integration tests detect chat messages and updated sharing tests for better reliability and accuracy.
519
+ - **📁 Standardized '.safetensors' File Extension**: Renamed the '.sft' file extension to '.safetensors' for ComfyUI workflows, standardizing file formats across the platform.
520
+
521
+ ### Removed
522
+
523
+ - **🗑️ Deprecated Frontend Functions**: Removed frontend functions that were migrated to backend to declutter the codebase and reduce redundancy.
524
+
525
+ ## [0.3.12] - 2024-08-07
526
+
527
+ ### Added
528
+
529
+ - **🔄 Sidebar Infinite Scroll**: Added an infinite scroll feature in the sidebar for more efficient chat navigation, reducing load times and enhancing user experience.
530
+ - **🚀 Enhanced Markdown Rendering**: Support for rendering all code blocks and making images clickable for preview; codespan styling is also enhanced to improve readability and user interaction.
531
+ - **🔒 Admin Shared Chat Visibility**: Admins no longer have default visibility over shared chats when ENABLE_ADMIN_CHAT_ACCESS is set to false, tightening security and privacy settings for users.
532
+ - **🌍 Language Updates**: Added Malay (Bahasa Malaysia) translation and updated Catalan and Traditional Chinese translations to improve accessibility for more users.
533
+
534
+ ### Fixed
535
+
536
+ - **📊 Markdown Rendering Issues**: Resolved issues with markdown rendering to ensure consistent and correct display across components.
537
+ - **🛠️ Styling Issues**: Multiple fixes applied to styling throughout the application, improving the overall visual experience and interface consistency.
538
+ - **🗃️ Modal Handling**: Fixed an issue where modals were not closing correctly in various model chat scenarios, enhancing usability and interface reliability.
539
+ - **📄 Missing OpenAI Usage Information**: Resolved issues where usage statistics for OpenAI services were not being correctly displayed, ensuring users have access to crucial data for managing and monitoring their API consumption.
540
+ - **🔧 Non-Streaming Support for Functions Plugin**: Fixed a functionality issue with the Functions plugin where non-streaming operations were not functioning as intended, restoring full capabilities for async and sync integration within the platform.
541
+ - **🔄 Environment Variable Type Correction (COMFYUI_FLUX_FP8_CLIP)**: Corrected the data type of the 'COMFYUI_FLUX_FP8_CLIP' environment variable from string to boolean, ensuring environment settings apply correctly and enhance configuration management.
542
+
543
+ ### Changed
544
+
545
+ - **🔧 Backend Dependency Updates**: Updated several backend dependencies such as boto3, pypdf, python-pptx, validators, and black, ensuring up-to-date security and performance optimizations.
546
+
547
+ ## [0.3.11] - 2024-08-02
548
+
549
+ ### Added
550
+
551
+ - **📊 Model Information Display**: Added visuals for model selection, including images next to model names for more intuitive navigation.
552
+ - **🗣 ElevenLabs Voice Adaptations**: Voice enhancements including support for ElevenLabs voice ID by name for personalized vocal interactions.
553
+ - **⌨️ Arrow Keys Model Selection**: Users can now use arrow keys for quicker model selection, enhancing accessibility.
554
+ - **🔍 Fuzzy Search in Model Selector**: Enhanced model selector with fuzzy search to locate models swiftly, including descriptions.
555
+ - **🕹️ ComfyUI Flux Image Generation**: Added support for the new Flux image gen model; introduces environment controls like weight precision and CLIP model options in Settings.
556
+ - **💾 Display File Size for Uploads**: Enhanced file interface now displays file size, preparing for upcoming upload restrictions.
557
+ - **🎚️ Advanced Params "Min P"**: Added 'Min P' parameter in the advanced settings for customized model precision control.
558
+ - **🔒 Enhanced OAuth**: Introduced custom redirect URI support for OAuth behind reverse proxies, enabling safer authentication processes.
559
+ - **🖥 Enhanced Latex Rendering**: Adjustments made to latex rendering processes, now accurately detecting and presenting latex inputs from text.
560
+ - **🌐 Internationalization**: Enhanced with new Romanian and updated Vietnamese and Ukrainian translations, helping broaden accessibility for international users.
561
+
562
+ ### Fixed
563
+
564
+ - **🔧 Tags Handling in Document Upload**: Tags are now properly sent to the upload document handler, resolving issues with missing metadata.
565
+ - **🖥️ Sensitive Input Fields**: Corrected browser misinterpretation of secure input fields, preventing misclassification as password fields.
566
+ - **📂 Static Path Resolution in PDF Generation**: Fixed static paths that adjust dynamically to prevent issues across various environments.
567
+
568
+ ### Changed
569
+
570
+ - **🎨 UI/UX Styling Enhancements**: Multiple minor styling updates for a cleaner and more intuitive user interface.
571
+ - **🚧 Refactoring Various Components**: Numerous refactoring changes across styling, file handling, and function simplifications for clarity and performance.
572
+ - **🎛️ User Valves Management**: Moved user valves from settings to direct chat controls for more user-friendly access during interactions.
573
+
574
+ ### Removed
575
+
576
+ - **⚙️ Health Check Logging**: Removed verbose logging from the health checking processes to declutter logs and improve backend performance.
577
+
578
+ ## [0.3.10] - 2024-07-17
579
+
580
+ ### Fixed
581
+
582
+ - **🔄 Improved File Upload**: Addressed the issue where file uploads lacked animation.
583
+ - **💬 Chat Continuity**: Fixed a problem where existing chats were not functioning properly in some instances.
584
+ - **🗂️ Chat File Reset**: Resolved the issue of chat files not resetting for new conversations, now ensuring a clean slate for each chat session.
585
+ - **📁 Document Workspace Uploads**: Corrected the handling of document uploads in the workspace using the Files API.
586
+
587
+ ## [0.3.9] - 2024-07-17
588
+
589
+ ### Added
590
+
591
+ - **📁 Files Chat Controls**: We've reverted to the old file handling behavior where uploaded files are always included. You can now manage files directly within the chat controls section, giving you the ability to remove files as needed.
592
+ - **🔧 "Action" Function Support**: Introducing a new "Action" function to write custom buttons to the message toolbar. This feature enables more interactive messaging, with documentation coming soon.
593
+ - **📜 Citations Handling**: For newly uploaded files in documents workspace, citations will now display the actual filename. Additionally, you can click on these filenames to open the file in a new tab for easier access.
594
+ - **🛠️ Event Emitter and Call Updates**: Enhanced 'event_emitter' to allow message replacement and 'event_call' to support text input for Tools and Functions. Detailed documentation will be provided shortly.
595
+ - **🎨 Styling Refactor**: Various styling updates for a cleaner and more cohesive user interface.
596
+ - **🌐 Enhanced Translations**: Improved translations for Catalan, Ukrainian, and Brazilian Portuguese.
597
+
598
+ ### Fixed
599
+
600
+ - **🔧 Chat Controls Priority**: Resolved an issue where Chat Controls values were being overridden by model information parameters. The priority is now Chat Controls, followed by Global Settings, then Model Settings.
601
+ - **🪲 Debug Logs**: Fixed an issue where debug logs were not being logged properly.
602
+ - **🔑 Automatic1111 Auth Key**: The auth key for Automatic1111 is no longer required.
603
+ - **📝 Title Generation**: Ensured that the title generation runs only once, even when multiple models are in a chat.
604
+ - **✅ Boolean Values in Params**: Added support for boolean values in parameters.
605
+ - **🖼️ Files Overlay Styling**: Fixed the styling issue with the files overlay.
606
+
607
+ ### Changed
608
+
609
+ - **⬆️ Dependency Updates**
610
+ - Upgraded 'pydantic' from version 2.7.1 to 2.8.2.
611
+ - Upgraded 'sqlalchemy' from version 2.0.30 to 2.0.31.
612
+ - Upgraded 'unstructured' from version 0.14.9 to 0.14.10.
613
+ - Upgraded 'chromadb' from version 0.5.3 to 0.5.4.
614
+
615
+ ## [0.3.8] - 2024-07-09
616
+
617
+ ### Added
618
+
619
+ - **💬 Chat Controls**: Easily adjust parameters for each chat session, offering more precise control over your interactions.
620
+ - **📌 Pinned Chats**: Support for pinned chats, allowing you to keep important conversations easily accessible.
621
+ - **📄 Apache Tika Integration**: Added support for using Apache Tika as a document loader, enhancing document processing capabilities.
622
+ - **🛠️ Custom Environment for OpenID Claims**: Allows setting custom claims for OpenID, providing more flexibility in user authentication.
623
+ - **🔧 Enhanced Tools & Functions API**: Introduced 'event_emitter' and 'event_call', now you can also add citations for better documentation and tracking. Detailed documentation will be provided on our documentation website.
624
+ - **↔️ Sideways Scrolling in Settings**: Settings tabs container now supports horizontal scrolling for easier navigation.
625
+ - **🌑 Darker OLED Theme**: Includes a new, darker OLED theme and improved styling for the light theme, enhancing visual appeal.
626
+ - **🌐 Language Updates**: Updated translations for Indonesian, German, French, and Catalan languages, expanding accessibility.
627
+
628
+ ### Fixed
629
+
630
+ - **⏰ OpenAI Streaming Timeout**: Resolved issues with OpenAI streaming response using the 'AIOHTTP_CLIENT_TIMEOUT' setting, ensuring reliable performance.
631
+ - **💡 User Valves**: Fixed malfunctioning user valves, ensuring proper functionality.
632
+ - **🔄 Collapsible Components**: Addressed issues with collapsible components not working, restoring expected behavior.
633
+
634
+ ### Changed
635
+
636
+ - **🗃️ Database Backend**: Switched from Peewee to SQLAlchemy for improved concurrency support, enhancing database performance.
637
+ - **⬆️ ChromaDB Update**: Upgraded to version 0.5.3. Ensure your remote ChromaDB instance matches this version.
638
+ - **🔤 Primary Font Styling**: Updated primary font to Archivo for better visual consistency.
639
+ - **🔄 Font Change for Windows**: Replaced Arimo with Inter font for Windows users, improving readability.
640
+ - **🚀 Lazy Loading**: Implemented lazy loading for 'faster_whisper' and 'sentence_transformers' to reduce startup memory usage.
641
+ - **📋 Task Generation Payload**: Task generations now include only the "task" field in the body instead of "title".
642
+
643
+ ## [0.3.7] - 2024-06-29
644
+
645
+ ### Added
646
+
647
+ - **🌐 Enhanced Internationalization (i18n)**: Newly introduced Indonesian translation, and updated translations for Turkish, Chinese, and Catalan languages to improve user accessibility.
648
+
649
+ ### Fixed
650
+
651
+ - **🕵️‍♂️ Browser Language Detection**: Corrected the issue where the application was not properly detecting and adapting to the browser's language settings.
652
+ - **🔐 OIDC Admin Role Assignment**: Fixed a bug where the admin role was not being assigned to the first user who signed up via OpenID Connect (OIDC).
653
+ - **💬 Chat/Completions Endpoint**: Resolved an issue where the chat/completions endpoint was non-functional when the stream option was set to False.
654
+ - **🚫 'WEBUI_AUTH' Configuration**: Addressed the problem where setting 'WEBUI_AUTH' to False was not being applied correctly.
655
+
656
+ ### Changed
657
+
658
+ - **📦 Dependency Update**: Upgraded 'authlib' from version 1.3.0 to 1.3.1 to ensure better security and performance enhancements.
659
+
660
+ ## [0.3.6] - 2024-06-27
661
+
662
+ ### Added
663
+
664
+ - **✨ "Functions" Feature**: You can now utilize "Functions" like filters (middleware) and pipe (model) functions directly within the WebUI. While largely compatible with Pipelines, these native functions can be executed easily within Open WebUI. Example use cases for filter functions include usage monitoring, real-time translation, moderation, and automemory. For pipe functions, the scope ranges from Cohere and Anthropic integration directly within Open WebUI, enabling "Valves" for per-user OpenAI API key usage, and much more. If you encounter issues, SAFE_MODE has been introduced.
665
+ - **📁 Files API**: Compatible with OpenAI, this feature allows for custom Retrieval-Augmented Generation (RAG) in conjunction with the Filter Function. More examples will be shared on our community platform and official documentation website.
666
+ - **🛠️ Tool Enhancements**: Tools now support citations and "Valves". Documentation will be available shortly.
667
+ - **🔗 Iframe Support via Files API**: Enables rendering HTML directly into your chat interface using functions and tools. Use cases include playing games like DOOM and Snake, displaying a weather applet, and implementing Anthropic "artifacts"-like features. Stay tuned for updates on our community platform and documentation.
668
+ - **🔒 Experimental OAuth Support**: New experimental OAuth support. Check our documentation for more details.
669
+ - **🖼️ Custom Background Support**: Set a custom background from Settings > Interface to personalize your experience.
670
+ - **🔑 AUTOMATIC1111_API_AUTH Support**: Enhanced security for the AUTOMATIC1111 API.
671
+ - **🎨 Code Highlight Optimization**: Improved code highlighting features.
672
+ - **🎙️ Voice Interruption Feature**: Reintroduced and now toggleable from Settings > Interface.
673
+ - **💤 Wakelock API**: Now in use to prevent screen dimming during important tasks.
674
+ - **🔐 API Key Privacy**: All API keys are now hidden by default for better security.
675
+ - **🔍 New Web Search Provider**: Added jina_search as a new option.
676
+ - **🌐 Enhanced Internationalization (i18n)**: Improved Korean translation and updated Chinese and Ukrainian translations.
677
+
678
+ ### Fixed
679
+
680
+ - **🔧 Conversation Mode Issue**: Fixed the issue where Conversation Mode remained active after being removed from settings.
681
+ - **📏 Scroll Button Obstruction**: Resolved the issue where the scrollToBottom button container obstructed clicks on buttons beneath it.
682
+
683
+ ### Changed
684
+
685
+ - **⏲️ AIOHTTP_CLIENT_TIMEOUT**: Now set to 'None' by default for improved configuration flexibility.
686
+ - **📞 Voice Call Enhancements**: Improved by skipping code blocks and expressions during calls.
687
+ - **🚫 Error Message Handling**: Disabled the continuation of operations with error messages.
688
+ - **🗂️ Playground Relocation**: Moved the Playground from the workspace to the user menu for better user experience.
689
+
690
+ ## [0.3.5] - 2024-06-16
691
+
692
+ ### Added
693
+
694
+ - **📞 Enhanced Voice Call**: Text-to-speech (TTS) callback now operates in real-time for each sentence, reducing latency by not waiting for full completion.
695
+ - **👆 Tap to Interrupt**: During a call, you can now stop the assistant from speaking by simply tapping, instead of using voice. This resolves the issue of the speaker's voice being mistakenly registered as input.
696
+ - **😊 Emoji Call**: Toggle this feature on from the Settings > Interface, allowing LLMs to express emotions using emojis during voice calls for a more dynamic interaction.
697
+ - **🖱️ Quick Archive/Delete**: Use the Shift key + mouseover on the chat list to swiftly archive or delete items.
698
+ - **📝 Markdown Support in Model Descriptions**: You can now format model descriptions with markdown, enabling bold text, links, etc.
699
+ - **🧠 Editable Memories**: Adds the capability to modify memories.
700
+ - **📋 Admin Panel Sorting**: Introduces the ability to sort users/chats within the admin panel.
701
+ - **🌑 Dark Mode for Quick Selectors**: Dark mode now available for chat quick selectors (prompts, models, documents).
702
+ - **🔧 Advanced Parameters**: Adds 'num_keep' and 'num_batch' to advanced parameters for customization.
703
+ - **📅 Dynamic System Prompts**: New variables '{{CURRENT_DATETIME}}', '{{CURRENT_TIME}}', '{{USER_LOCATION}}' added for system prompts. Ensure '{{USER_LOCATION}}' is toggled on from Settings > Interface.
704
+ - **🌐 Tavily Web Search**: Includes Tavily as a web search provider option.
705
+ - **🖊️ Federated Auth Usernames**: Ability to set user names for federated authentication.
706
+ - **🔗 Auto Clean URLs**: When adding connection URLs, trailing slashes are now automatically removed.
707
+ - **🌐 Enhanced Translations**: Improved Chinese and Swedish translations.
708
+
709
+ ### Fixed
710
+
711
+ - **⏳ AIOHTTP_CLIENT_TIMEOUT**: Introduced a new environment variable 'AIOHTTP_CLIENT_TIMEOUT' for requests to Ollama lasting longer than 5 minutes. Default is 300 seconds; set to blank ('') for no timeout.
712
+ - **❌ Message Delete Freeze**: Resolved an issue where message deletion would sometimes cause the web UI to freeze.
713
+
714
+ ## [0.3.4] - 2024-06-12
715
+
716
+ ### Fixed
717
+
718
+ - **🔒 Mixed Content with HTTPS Issue**: Resolved a problem where mixed content (HTTP and HTTPS) was causing security warnings and blocking resources on HTTPS sites.
719
+ - **🔍 Web Search Issue**: Addressed the problem where web search functionality was not working correctly. The 'ENABLE_RAG_LOCAL_WEB_FETCH' option has been reintroduced to restore proper web searching capabilities.
720
+ - **💾 RAG Template Not Being Saved**: Fixed an issue where the RAG template was not being saved correctly, ensuring your custom templates are now preserved as expected.
721
+
722
+ ## [0.3.3] - 2024-06-12
723
+
724
+ ### Added
725
+
726
+ - **🛠️ Native Python Function Calling**: Introducing native Python function calling within Open WebUI. We’ve also included a built-in code editor to seamlessly develop and integrate function code within the 'Tools' workspace. With this, you can significantly enhance your LLM’s capabilities by creating custom RAG pipelines, web search tools, and even agent-like features such as sending Discord messages.
727
+ - **🌐 DuckDuckGo Integration**: Added DuckDuckGo as a web search provider, giving you more search options.
728
+ - **🌏 Enhanced Translations**: Improved translations for Vietnamese and Chinese languages, making the interface more accessible.
729
+
730
+ ### Fixed
731
+
732
+ - **🔗 Web Search URL Error Handling**: Fixed the issue where a single URL error would disrupt the data loading process in Web Search mode. Now, such errors will be handled gracefully to ensure uninterrupted data loading.
733
+ - **🖥️ Frontend Responsiveness**: Resolved the problem where the frontend would stop responding if the backend encounters an error while downloading a model. Improved error handling to maintain frontend stability.
734
+ - **🔧 Dependency Issues in pip**: Fixed issues related to pip installations, ensuring all dependencies are correctly managed to prevent installation errors.
735
+
736
+ ## [0.3.2] - 2024-06-10
737
+
738
+ ### Added
739
+
740
+ - **🔍 Web Search Query Status**: The web search query will now persist in the results section to aid in easier debugging and tracking of search queries.
741
+ - **🌐 New Web Search Provider**: We have added Serply as a new option for web search providers, giving you more choices for your search needs.
742
+ - **🌏 Improved Translations**: We've enhanced translations for Chinese and Portuguese.
743
+
744
+ ### Fixed
745
+
746
+ - **🎤 Audio File Upload Issue**: The bug that prevented audio files from being uploaded in chat input has been fixed, ensuring smooth communication.
747
+ - **💬 Message Input Handling**: Improved the handling of message inputs by instantly clearing images and text after sending, along with immediate visual indications when a response message is loading, enhancing user feedback.
748
+ - **⚙️ Parameter Registration and Validation**: Fixed the issue where parameters were not registering in certain cases and addressed the problem where users were unable to save due to invalid input errors.
749
+
750
+ ## [0.3.1] - 2024-06-09
751
+
752
+ ### Fixed
753
+
754
+ - **💬 Chat Functionality**: Resolved the issue where chat functionality was not working for specific models.
755
+
756
+ ## [0.3.0] - 2024-06-09
757
+
758
+ ### Added
759
+
760
+ - **📚 Knowledge Support for Models**: Attach documents directly to models from the models workspace, enhancing the information available to each model.
761
+ - **🎙️ Hands-Free Voice Call Feature**: Initiate voice calls without needing to use your hands, making interactions more seamless.
762
+ - **📹 Video Call Feature**: Enable video calls with supported vision models like Llava and GPT-4o, adding a visual dimension to your communications.
763
+ - **🎛️ Enhanced UI for Voice Recording**: Improved user interface for the voice recording feature, making it more intuitive and user-friendly.
764
+ - **🌐 External STT Support**: Now support for external Speech-To-Text services, providing more flexibility in choosing your STT provider.
765
+ - **⚙️ Unified Settings**: Consolidated settings including document settings under a new admin settings section for easier management.
766
+ - **🌑 Dark Mode Splash Screen**: A new splash screen for dark mode, ensuring a consistent and visually appealing experience for dark mode users.
767
+ - **📥 Upload Pipeline**: Directly upload pipelines from the admin settings > pipelines section, streamlining the pipeline management process.
768
+ - **🌍 Improved Language Support**: Enhanced support for Chinese and Ukrainian languages, better catering to a global user base.
769
+
770
+ ### Fixed
771
+
772
+ - **🛠️ Playground Issue**: Fixed the playground not functioning properly, ensuring a smoother user experience.
773
+ - **🔥 Temperature Parameter Issue**: Corrected the issue where the temperature value '0' was not being passed correctly.
774
+ - **📝 Prompt Input Clearing**: Resolved prompt input textarea not being cleared right away, ensuring a clean slate for new inputs.
775
+ - **✨ Various UI Styling Issues**: Fixed numerous user interface styling problems for a more cohesive look.
776
+ - **👥 Active Users Display**: Fixed active users showing active sessions instead of actual users, now reflecting accurate user activity.
777
+ - **🌐 Community Platform Compatibility**: The Community Platform is back online and fully compatible with Open WebUI.
778
+
779
+ ### Changed
780
+
781
+ - **📝 RAG Implementation**: Updated the RAG (Retrieval-Augmented Generation) implementation to use a system prompt for context, instead of overriding the user's prompt.
782
+ - **🔄 Settings Relocation**: Moved Models, Connections, Audio, and Images settings to the admin settings for better organization.
783
+ - **✍️ Improved Title Generation**: Enhanced the default prompt for title generation, yielding better results.
784
+ - **🔧 Backend Task Management**: Tasks like title generation and search query generation are now managed on the backend side and controlled only by the admin.
785
+ - **🔍 Editable Search Query Prompt**: You can now edit the search query generation prompt, offering more control over how queries are generated.
786
+ - **📏 Prompt Length Threshold**: Set the prompt length threshold for search query generation from the admin settings, giving more customization options.
787
+ - **📣 Settings Consolidation**: Merged the Banners admin setting with the Interface admin setting for a more streamlined settings area.
788
+
789
+ ## [0.2.5] - 2024-06-05
790
+
791
+ ### Added
792
+
793
+ - **👥 Active Users Indicator**: Now you can see how many people are currently active and what they are running. This helps you gauge when performance might slow down due to a high number of users.
794
+ - **🗂️ Create Ollama Modelfile**: The option to create a modelfile for Ollama has been reintroduced in the Settings > Models section, making it easier to manage your models.
795
+ - **⚙️ Default Model Setting**: Added an option to set the default model from Settings > Interface. This feature is now easily accessible, especially convenient for mobile users as it was previously hidden.
796
+ - **🌐 Enhanced Translations**: We've improved the Chinese translations and added support for Turkmen and Norwegian languages to make the interface more accessible globally.
797
+
798
+ ### Fixed
799
+
800
+ - **📱 Mobile View Improvements**: The UI now uses dvh (dynamic viewport height) instead of vh (viewport height), providing a better and more responsive experience for mobile users.
801
+
802
+ ## [0.2.4] - 2024-06-03
803
+
804
+ ### Added
805
+
806
+ - **👤 Improved Account Pending Page**: The account pending page now displays admin details by default to avoid confusion. You can disable this feature in the admin settings if needed.
807
+ - **🌐 HTTP Proxy Support**: We have enabled the use of the 'http_proxy' environment variable in OpenAI and Ollama API calls, making it easier to configure network settings.
808
+ - **❓ Quick Access to Documentation**: You can now easily access Open WebUI documents via a question mark button located at the bottom right corner of the screen (available on larger screens like PCs).
809
+ - **🌍 Enhanced Translation**: Improvements have been made to translations.
810
+
811
+ ### Fixed
812
+
813
+ - **🔍 SearxNG Web Search**: Fixed the issue where the SearxNG web search functionality was not working properly.
814
+
815
+ ## [0.2.3] - 2024-06-03
816
+
817
+ ### Added
818
+
819
+ - **📁 Export Chat as JSON**: You can now export individual chats as JSON files from the navbar menu by navigating to 'Download > Export Chat'. This makes sharing specific conversations easier.
820
+ - **✏️ Edit Titles with Double Click**: Double-click on titles to rename them quickly and efficiently.
821
+ - **🧩 Batch Multiple Embeddings**: Introduced 'RAG_EMBEDDING_OPENAI_BATCH_SIZE' to process multiple embeddings in a batch, enhancing performance for large datasets.
822
+ - **🌍 Improved Translations**: Enhanced the translation quality across various languages for a better user experience.
823
+
824
+ ### Fixed
825
+
826
+ - **🛠️ Modelfile Migration Script**: Fixed an issue where the modelfile migration script would fail if an invalid modelfile was encountered.
827
+ - **💬 Zhuyin Input Method on Mac**: Resolved an issue where using the Zhuyin input method in the Web UI on a Mac caused text to send immediately upon pressing the enter key, leading to incorrect input.
828
+ - **🔊 Local TTS Voice Selection**: Fixed the issue where the selected local Text-to-Speech (TTS) voice was not being displayed in settings.
829
+
830
+ ## [0.2.2] - 2024-06-02
831
+
832
+ ### Added
833
+
834
+ - **🌊 Mermaid Rendering Support**: We've included support for Mermaid rendering. This allows you to create beautiful diagrams and flowcharts directly within Open WebUI.
835
+ - **🔄 New Environment Variable 'RESET_CONFIG_ON_START'**: Introducing a new environment variable: 'RESET_CONFIG_ON_START'. Set this variable to reset your configuration settings upon starting the application, making it easier to revert to default settings.
836
+
837
+ ### Fixed
838
+
839
+ - **🔧 Pipelines Filter Issue**: We've addressed an issue with the pipelines where filters were not functioning as expected.
840
+
841
+ ## [0.2.1] - 2024-06-02
842
+
843
+ ### Added
844
+
845
+ - **🖱️ Single Model Export Button**: Easily export models with just one click using the new single model export button.
846
+ - **🖥️ Advanced Parameters Support**: Added support for 'num_thread', 'use_mmap', and 'use_mlock' parameters for Ollama.
847
+ - **🌐 Improved Vietnamese Translation**: Enhanced Vietnamese language support for a better user experience for our Vietnamese-speaking community.
848
+
849
+ ### Fixed
850
+
851
+ - **🔧 OpenAI URL API Save Issue**: Corrected a problem preventing the saving of OpenAI URL API settings.
852
+ - **🚫 Display Issue with Disabled Ollama API**: Fixed the display bug causing models to appear in settings when the Ollama API was disabled.
853
+
854
+ ### Changed
855
+
856
+ - **💡 Versioning Update**: As a reminder from our previous update, version 0.2.y will focus primarily on bug fixes, while major updates will be designated as 0.x from now on for better version tracking.
857
+
858
+ ## [0.2.0] - 2024-06-01
859
+
860
+ ### Added
861
+
862
+ - **🔧 Pipelines Support**: Open WebUI now includes a plugin framework for enhanced customization and functionality (https://github.com/open-webui/pipelines). Easily add custom logic and integrate Python libraries, from AI agents to home automation APIs.
863
+ - **🔗 Function Calling via Pipelines**: Integrate function calling seamlessly through Pipelines.
864
+ - **⚖️ User Rate Limiting via Pipelines**: Implement user-specific rate limits to manage API usage efficiently.
865
+ - **📊 Usage Monitoring with Langfuse**: Track and analyze usage statistics with Langfuse integration through Pipelines.
866
+ - **🕒 Conversation Turn Limits**: Set limits on conversation turns to manage interactions better through Pipelines.
867
+ - **🛡️ Toxic Message Filtering**: Automatically filter out toxic messages to maintain a safe environment using Pipelines.
868
+ - **🔍 Web Search Support**: Introducing built-in web search capabilities via RAG API, allowing users to search using SearXNG, Google Programmatic Search Engine, Brave Search, serpstack, and serper. Activate it effortlessly by adding necessary variables from Document settings > Web Params.
869
+ - **🗂️ Models Workspace**: Create and manage model presets for both Ollama/OpenAI API. Note: The old Modelfiles workspace is deprecated.
870
+ - **🛠️ Model Builder Feature**: Build and edit all models with persistent builder mode.
871
+ - **🏷️ Model Tagging Support**: Organize models with tagging features in the models workspace.
872
+ - **📋 Model Ordering Support**: Effortlessly organize models by dragging and dropping them into the desired positions within the models workspace.
873
+ - **📈 OpenAI Generation Stats**: Access detailed generation statistics for OpenAI models.
874
+ - **📅 System Prompt Variables**: New variables added: '{{CURRENT_DATE}}' and '{{USER_NAME}}' for dynamic prompts.
875
+ - **📢 Global Banner Support**: Manage global banners from admin settings > banners.
876
+ - **🗃️ Enhanced Archived Chats Modal**: Search and export archived chats easily.
877
+ - **📂 Archive All Button**: Quickly archive all chats from settings > chats.
878
+ - **🌐 Improved Translations**: Added and improved translations for French, Croatian, Cebuano, and Vietnamese.
879
+
880
+ ### Fixed
881
+
882
+ - **🔍 Archived Chats Visibility**: Resolved issue with archived chats not showing in the admin panel.
883
+ - **💬 Message Styling**: Fixed styling issues affecting message appearance.
884
+ - **🔗 Shared Chat Responses**: Corrected the issue where shared chat response messages were not readonly.
885
+ - **🖥️ UI Enhancement**: Fixed the scrollbar overlapping issue with the message box in the user interface.
886
+
887
+ ### Changed
888
+
889
+ - **💾 User Settings Storage**: User settings are now saved on the backend, ensuring consistency across all devices.
890
+ - **📡 Unified API Requests**: The API request for getting models is now unified to '/api/models' for easier usage.
891
+ - **🔄 Versioning Update**: Our versioning will now follow the format 0.x for major updates and 0.x.y for patches.
892
+ - **📦 Export All Chats (All Users)**: Moved this functionality to the Admin Panel settings for better organization and accessibility.
893
+
894
+ ### Removed
895
+
896
+ - **🚫 Bundled LiteLLM Support Deprecated**: Migrate your LiteLLM config.yaml to a self-hosted LiteLLM instance. LiteLLM can still be added via OpenAI Connections. Download the LiteLLM config.yaml from admin settings > database > export LiteLLM config.yaml.
897
+
898
+ ## [0.1.125] - 2024-05-19
899
+
900
+ ### Added
901
+
902
+ - **🔄 Updated UI**: Chat interface revamped with chat bubbles. Easily switch back to the old style via settings > interface > chat bubble UI.
903
+ - **📂 Enhanced Sidebar UI**: Model files, documents, prompts, and playground merged into Workspace for streamlined access.
904
+ - **🚀 Improved Many Model Interaction**: All responses now displayed simultaneously for a smoother experience.
905
+ - **🐍 Python Code Execution**: Execute Python code locally in the browser with libraries like 'requests', 'beautifulsoup4', 'numpy', 'pandas', 'seaborn', 'matplotlib', 'scikit-learn', 'scipy', 'regex'.
906
+ - **🧠 Experimental Memory Feature**: Manually input personal information you want LLMs to remember via settings > personalization > memory.
907
+ - **💾 Persistent Settings**: Settings now saved as config.json for convenience.
908
+ - **🩺 Health Check Endpoint**: Added for Docker deployment.
909
+ - **↕️ RTL Support**: Toggle chat direction via settings > interface > chat direction.
910
+ - **🖥️ PowerPoint Support**: RAG pipeline now supports PowerPoint documents.
911
+ - **🌐 Language Updates**: Ukrainian, Turkish, Arabic, Chinese, Serbian, Vietnamese updated; Punjabi added.
912
+
913
+ ### Changed
914
+
915
+ - **👤 Shared Chat Update**: Shared chat now includes creator user information.
916
+
917
+ ## [0.1.124] - 2024-05-08
918
+
919
+ ### Added
920
+
921
+ - **🖼️ Improved Chat Sidebar**: Now conveniently displays time ranges and organizes chats by today, yesterday, and more.
922
+ - **📜 Citations in RAG Feature**: Easily track the context fed to the LLM with added citations in the RAG feature.
923
+ - **🔒 Auth Disable Option**: Introducing the ability to disable authentication. Set 'WEBUI_AUTH' to False to disable authentication. Note: Only applicable for fresh installations without existing users.
924
+ - **📹 Enhanced YouTube RAG Pipeline**: Now supports non-English videos for an enriched experience.
925
+ - **🔊 Specify OpenAI TTS Models**: Customize your TTS experience by specifying OpenAI TTS models.
926
+ - **🔧 Additional Environment Variables**: Discover more environment variables in our comprehensive documentation at Open WebUI Documentation (https://docs.openwebui.com).
927
+ - **🌐 Language Support**: Arabic, Finnish, and Hindi added; Improved support for German, Vietnamese, and Chinese.
928
+
929
+ ### Fixed
930
+
931
+ - **🛠️ Model Selector Styling**: Addressed styling issues for improved user experience.
932
+ - **⚠️ Warning Messages**: Resolved backend warning messages.
933
+
934
+ ### Changed
935
+
936
+ - **📝 Title Generation**: Limited output to 50 tokens.
937
+ - **📦 Helm Charts**: Removed Helm charts, now available in a separate repository (https://github.com/open-webui/helm-charts).
938
+
939
+ ## [0.1.123] - 2024-05-02
940
+
941
+ ### Added
942
+
943
+ - **🎨 New Landing Page Design**: Refreshed design for a more modern look and optimized use of screen space.
944
+ - **📹 Youtube RAG Pipeline**: Introduces dedicated RAG pipeline for Youtube videos, enabling interaction with video transcriptions directly.
945
+ - **🔧 Enhanced Admin Panel**: Streamlined user management with options to add users directly or in bulk via CSV import.
946
+ - **👥 '@' Model Integration**: Easily switch to specific models during conversations; old collaborative chat feature phased out.
947
+ - **🌐 Language Enhancements**: Swedish translation added, plus improvements to German, Spanish, and the addition of Doge translation.
948
+
949
+ ### Fixed
950
+
951
+ - **🗑️ Delete Chat Shortcut**: Addressed issue where shortcut wasn't functioning.
952
+ - **🖼️ Modal Closing Bug**: Resolved unexpected closure of modal when dragging from within.
953
+ - **✏️ Edit Button Styling**: Fixed styling inconsistency with edit buttons.
954
+ - **🌐 Image Generation Compatibility Issue**: Rectified image generation compatibility issue with third-party APIs.
955
+ - **📱 iOS PWA Icon Fix**: Corrected iOS PWA home screen icon shape.
956
+ - **🔍 Scroll Gesture Bug**: Adjusted gesture sensitivity to prevent accidental activation when scrolling through code on mobile; now requires scrolling from the leftmost side to open the sidebar.
957
+
958
+ ### Changed
959
+
960
+ - **🔄 Unlimited Context Length**: Advanced settings now allow unlimited max context length (previously limited to 16000).
961
+ - **👑 Super Admin Assignment**: The first signup is automatically assigned a super admin role, unchangeable by other admins.
962
+ - **🛡️ Admin User Restrictions**: User action buttons from the admin panel are now disabled for users with admin roles.
963
+ - **🔝 Default Model Selector**: Set as default model option now exclusively available on the landing page.
964
+
965
+ ## [0.1.122] - 2024-04-27
966
+
967
+ ### Added
968
+
969
+ - **🌟 Enhanced RAG Pipeline**: Now with hybrid searching via 'BM25', reranking powered by 'CrossEncoder', and configurable relevance score thresholds.
970
+ - **🛢️ External Database Support**: Seamlessly connect to custom SQLite or Postgres databases using the 'DATABASE_URL' environment variable.
971
+ - **🌐 Remote ChromaDB Support**: Introducing the capability to connect to remote ChromaDB servers.
972
+ - **👨‍💼 Improved Admin Panel**: Admins can now conveniently check users' chat lists and last active status directly from the admin panel.
973
+ - **🎨 Splash Screen**: Introducing a loading splash screen for a smoother user experience.
974
+ - **🌍 Language Support Expansion**: Added support for Bangla (bn-BD), along with enhancements to Chinese, Spanish, and Ukrainian translations.
975
+ - **💻 Improved LaTeX Rendering Performance**: Enjoy faster rendering times for LaTeX equations.
976
+ - **🔧 More Environment Variables**: Explore additional environment variables in our documentation (https://docs.openwebui.com), including the 'ENABLE_LITELLM' option to manage memory usage.
977
+
978
+ ### Fixed
979
+
980
+ - **🔧 Ollama Compatibility**: Resolved errors occurring when Ollama server version isn't an integer, such as SHA builds or RCs.
981
+ - **🐛 Various OpenAI API Issues**: Addressed several issues related to the OpenAI API.
982
+ - **🛑 Stop Sequence Issue**: Fixed the problem where the stop sequence with a backslash '\' was not functioning.
983
+ - **🔤 Font Fallback**: Corrected font fallback issue.
984
+
985
+ ### Changed
986
+
987
+ - **⌨️ Prompt Input Behavior on Mobile**: Enter key prompt submission disabled on mobile devices for improved user experience.
988
+
989
+ ## [0.1.121] - 2024-04-24
990
+
991
+ ### Fixed
992
+
993
+ - **🔧 Translation Issues**: Addressed various translation discrepancies.
994
+ - **🔒 LiteLLM Security Fix**: Updated LiteLLM version to resolve a security vulnerability.
995
+ - **🖥️ HTML Tag Display**: Rectified the issue where the '< br >' tag wasn't displaying correctly.
996
+ - **🔗 WebSocket Connection**: Resolved the failure of WebSocket connection under HTTPS security for ComfyUI server.
997
+ - **📜 FileReader Optimization**: Implemented FileReader initialization per image in multi-file drag & drop to ensure reusability.
998
+ - **🏷️ Tag Display**: Corrected tag display inconsistencies.
999
+ - **📦 Archived Chat Styling**: Fixed styling issues in archived chat.
1000
+ - **🔖 Safari Copy Button Bug**: Addressed the bug where the copy button failed to copy links in Safari.
1001
+
1002
+ ## [0.1.120] - 2024-04-20
1003
+
1004
+ ### Added
1005
+
1006
+ - **📦 Archive Chat Feature**: Easily archive chats with a new sidebar button, and access archived chats via the profile button > archived chats.
1007
+ - **🔊 Configurable Text-to-Speech Endpoint**: Customize your Text-to-Speech experience with configurable OpenAI endpoints.
1008
+ - **🛠️ Improved Error Handling**: Enhanced error message handling for connection failures.
1009
+ - **⌨️ Enhanced Shortcut**: When editing messages, use ctrl/cmd+enter to save and submit, and esc to close.
1010
+ - **🌐 Language Support**: Added support for Georgian and enhanced translations for Portuguese and Vietnamese.
1011
+
1012
+ ### Fixed
1013
+
1014
+ - **🔧 Model Selector**: Resolved issue where default model selection was not saving.
1015
+ - **🔗 Share Link Copy Button**: Fixed bug where the copy button wasn't copying links in Safari.
1016
+ - **🎨 Light Theme Styling**: Addressed styling issue with the light theme.
1017
+
1018
+ ## [0.1.119] - 2024-04-16
1019
+
1020
+ ### Added
1021
+
1022
+ - **🌟 Enhanced RAG Embedding Support**: Ollama, and OpenAI models can now be used for RAG embedding model.
1023
+ - **🔄 Seamless Integration**: Copy 'ollama run <model name>' directly from Ollama page to easily select and pull models.
1024
+ - **🏷️ Tagging Feature**: Add tags to chats directly via the sidebar chat menu.
1025
+ - **📱 Mobile Accessibility**: Swipe left and right on mobile to effortlessly open and close the sidebar.
1026
+ - **🔍 Improved Navigation**: Admin panel now supports pagination for user list.
1027
+ - **🌍 Additional Language Support**: Added Polish language support.
1028
+
1029
+ ### Fixed
1030
+
1031
+ - **🌍 Language Enhancements**: Vietnamese and Spanish translations have been improved.
1032
+ - **🔧 Helm Fixes**: Resolved issues with Helm trailing slash and manifest.json.
1033
+
1034
+ ### Changed
1035
+
1036
+ - **🐳 Docker Optimization**: Updated docker image build process to utilize 'uv' for significantly faster builds compared to 'pip3'.
1037
+
1038
+ ## [0.1.118] - 2024-04-10
1039
+
1040
+ ### Added
1041
+
1042
+ - **🦙 Ollama and CUDA Images**: Added support for ':ollama' and ':cuda' tagged images.
1043
+ - **👍 Enhanced Response Rating**: Now you can annotate your ratings for better feedback.
1044
+ - **👤 User Initials Profile Photo**: User initials are now the default profile photo.
1045
+ - **🔍 Update RAG Embedding Model**: Customize RAG embedding model directly in document settings.
1046
+ - **🌍 Additional Language Support**: Added Turkish language support.
1047
+
1048
+ ### Fixed
1049
+
1050
+ - **🔒 Share Chat Permission**: Resolved issue with chat sharing permissions.
1051
+ - **🛠 Modal Close**: Modals can now be closed using the Esc key.
1052
+
1053
+ ### Changed
1054
+
1055
+ - **🎨 Admin Panel Styling**: Refreshed styling for the admin panel.
1056
+ - **🐳 Docker Image Build**: Updated docker image build process for improved efficiency.
1057
+
1058
+ ## [0.1.117] - 2024-04-03
1059
+
1060
+ ### Added
1061
+
1062
+ - 🗨️ **Local Chat Sharing**: Share chat links seamlessly between users.
1063
+ - 🔑 **API Key Generation Support**: Generate secret keys to leverage Open WebUI with OpenAI libraries.
1064
+ - 📄 **Chat Download as PDF**: Easily download chats in PDF format.
1065
+ - 📝 **Improved Logging**: Enhancements to logging functionality.
1066
+ - 📧 **Trusted Email Authentication**: Authenticate using a trusted email header.
1067
+
1068
+ ### Fixed
1069
+
1070
+ - 🌷 **Enhanced Dutch Translation**: Improved translation for Dutch users.
1071
+ - ⚪ **White Theme Styling**: Resolved styling issue with the white theme.
1072
+ - 📜 **LaTeX Chat Screen Overflow**: Fixed screen overflow issue with LaTeX rendering.
1073
+ - 🔒 **Security Patches**: Applied necessary security patches.
1074
+
1075
+ ## [0.1.116] - 2024-03-31
1076
+
1077
+ ### Added
1078
+
1079
+ - **🔄 Enhanced UI**: Model selector now conveniently located in the navbar, enabling seamless switching between multiple models during conversations.
1080
+ - **🔍 Improved Model Selector**: Directly pull a model from the selector/Models now display detailed information for better understanding.
1081
+ - **💬 Webhook Support**: Now compatible with Google Chat and Microsoft Teams.
1082
+ - **🌐 Localization**: Korean translation (I18n) now available.
1083
+ - **🌑 Dark Theme**: OLED dark theme introduced for reduced strain during prolonged usage.
1084
+ - **🏷️ Tag Autocomplete**: Dropdown feature added for effortless chat tagging.
1085
+
1086
+ ### Fixed
1087
+
1088
+ - **🔽 Auto-Scrolling**: Addressed OpenAI auto-scrolling issue.
1089
+ - **🏷️ Tag Validation**: Implemented tag validation to prevent empty string tags.
1090
+ - **🚫 Model Whitelisting**: Resolved LiteLLM model whitelisting issue.
1091
+ - **✅ Spelling**: Corrected various spelling issues for improved readability.
1092
+
1093
+ ## [0.1.115] - 2024-03-24
1094
+
1095
+ ### Added
1096
+
1097
+ - **🔍 Custom Model Selector**: Easily find and select custom models with the new search filter feature.
1098
+ - **🛑 Cancel Model Download**: Added the ability to cancel model downloads.
1099
+ - **🎨 Image Generation ComfyUI**: Image generation now supports ComfyUI.
1100
+ - **🌟 Updated Light Theme**: Updated the light theme for a fresh look.
1101
+ - **🌍 Additional Language Support**: Now supporting Bulgarian, Italian, Portuguese, Japanese, and Dutch.
1102
+
1103
+ ### Fixed
1104
+
1105
+ - **🔧 Fixed Broken Experimental GGUF Upload**: Resolved issues with experimental GGUF upload functionality.
1106
+
1107
+ ### Changed
1108
+
1109
+ - **🔄 Vector Storage Reset Button**: Moved the reset vector storage button to document settings.
1110
+
1111
+ ## [0.1.114] - 2024-03-20
1112
+
1113
+ ### Added
1114
+
1115
+ - **🔗 Webhook Integration**: Now you can subscribe to new user sign-up events via webhook. Simply navigate to the admin panel > admin settings > webhook URL.
1116
+ - **🛡️ Enhanced Model Filtering**: Alongside Ollama, OpenAI proxy model whitelisting, we've added model filtering functionality for LiteLLM proxy.
1117
+ - **🌍 Expanded Language Support**: Spanish, Catalan, and Vietnamese languages are now available, with improvements made to others.
1118
+
1119
+ ### Fixed
1120
+
1121
+ - **🔧 Input Field Spelling**: Resolved issue with spelling mistakes in input fields.
1122
+ - **🖊️ Light Mode Styling**: Fixed styling issue with light mode in document adding.
1123
+
1124
+ ### Changed
1125
+
1126
+ - **🔄 Language Sorting**: Languages are now sorted alphabetically by their code for improved organization.
1127
+
1128
+ ## [0.1.113] - 2024-03-18
1129
+
1130
+ ### Added
1131
+
1132
+ - 🌍 **Localization**: You can now change the UI language in Settings > General. We support Ukrainian, German, Farsi (Persian), Traditional and Simplified Chinese and French translations. You can help us to translate the UI into your language! More info in our [CONTRIBUTION.md](https://github.com/open-webui/open-webui/blob/main/docs/CONTRIBUTING.md#-translations-and-internationalization).
1133
+ - 🎨 **System-wide Theme**: Introducing a new system-wide theme for enhanced visual experience.
1134
+
1135
+ ### Fixed
1136
+
1137
+ - 🌑 **Dark Background on Select Fields**: Improved readability by adding a dark background to select fields, addressing issues on certain browsers/devices.
1138
+ - **Multiple OPENAI_API_BASE_URLS Issue**: Resolved issue where multiple base URLs caused conflicts when one wasn't functioning.
1139
+ - **RAG Encoding Issue**: Fixed encoding problem in RAG.
1140
+ - **npm Audit Fix**: Addressed npm audit findings.
1141
+ - **Reduced Scroll Threshold**: Improved auto-scroll experience by reducing the scroll threshold from 50px to 5px.
1142
+
1143
+ ### Changed
1144
+
1145
+ - 🔄 **Sidebar UI Update**: Updated sidebar UI to feature a chat menu dropdown, replacing two icons for improved navigation.
1146
+
1147
+ ## [0.1.112] - 2024-03-15
1148
+
1149
+ ### Fixed
1150
+
1151
+ - 🗨️ Resolved chat malfunction after image generation.
1152
+ - 🎨 Fixed various RAG issues.
1153
+ - 🧪 Rectified experimental broken GGUF upload logic.
1154
+
1155
+ ## [0.1.111] - 2024-03-10
1156
+
1157
+ ### Added
1158
+
1159
+ - 🛡️ **Model Whitelisting**: Admins now have the ability to whitelist models for users with the 'user' role.
1160
+ - 🔄 **Update All Models**: Added a convenient button to update all models at once.
1161
+ - 📄 **Toggle PDF OCR**: Users can now toggle PDF OCR option for improved parsing performance.
1162
+ - 🎨 **DALL-E Integration**: Introduced DALL-E integration for image generation alongside automatic1111.
1163
+ - 🛠️ **RAG API Refactoring**: Refactored RAG logic and exposed its API, with additional documentation to follow.
1164
+
1165
+ ### Fixed
1166
+
1167
+ - 🔒 **Max Token Settings**: Added max token settings for anthropic/claude-3-sonnet-20240229 (Issue #1094).
1168
+ - 🔧 **Misalignment Issue**: Corrected misalignment of Edit and Delete Icons when Chat Title is Empty (Issue #1104).
1169
+ - 🔄 **Context Loss Fix**: Resolved RAG losing context on model response regeneration with Groq models via API key (Issue #1105).
1170
+ - 📁 **File Handling Bug**: Addressed File Not Found Notification when Dropping a Conversation Element (Issue #1098).
1171
+ - 🖱️ **Dragged File Styling**: Fixed dragged file layover styling issue.
1172
+
1173
+ ## [0.1.110] - 2024-03-06
1174
+
1175
+ ### Added
1176
+
1177
+ - **🌐 Multiple OpenAI Servers Support**: Enjoy seamless integration with multiple OpenAI-compatible APIs, now supported natively.
1178
+
1179
+ ### Fixed
1180
+
1181
+ - **🔍 OCR Issue**: Resolved PDF parsing issue caused by OCR malfunction.
1182
+ - **🚫 RAG Issue**: Fixed the RAG functionality, ensuring it operates smoothly.
1183
+ - **📄 "Add Docs" Model Button**: Addressed the non-functional behavior of the "Add Docs" model button.
1184
+
1185
+ ## [0.1.109] - 2024-03-06
1186
+
1187
+ ### Added
1188
+
1189
+ - **🔄 Multiple Ollama Servers Support**: Enjoy enhanced scalability and performance with support for multiple Ollama servers in a single WebUI. Load balancing features are now available, providing improved efficiency (#788, #278).
1190
+ - **🔧 Support for Claude 3 and Gemini**: Responding to user requests, we've expanded our toolset to include Claude 3 and Gemini, offering a wider range of functionalities within our platform (#1064).
1191
+ - **🔍 OCR Functionality for PDF Loader**: We've augmented our PDF loader with Optical Character Recognition (OCR) capabilities. Now, extract text from scanned documents and images within PDFs, broadening the scope of content processing (#1050).
1192
+
1193
+ ### Fixed
1194
+
1195
+ - **🛠️ RAG Collection**: Implemented a dynamic mechanism to recreate RAG collections, ensuring users have up-to-date and accurate data (#1031).
1196
+ - **📝 User Agent Headers**: Fixed issue of RAG web requests being sent with empty user_agent headers, reducing rejections from certain websites. Realistic headers are now utilized for these requests (#1024).
1197
+ - **⏹️ Playground Cancel Functionality**: Introducing a new "Cancel" option for stopping Ollama generation in the Playground, enhancing user control and usability (#1006).
1198
+ - **🔤 Typographical Error in 'ASSISTANT' Field**: Corrected a typographical error in the 'ASSISTANT' field within the GGUF model upload template for accuracy and consistency (#1061).
1199
+
1200
+ ### Changed
1201
+
1202
+ - **🔄 Refactored Message Deletion Logic**: Streamlined message deletion process for improved efficiency and user experience, simplifying interactions within the platform (#1004).
1203
+ - **⚠️ Deprecation of `OLLAMA_API_BASE_URL`**: Deprecated `OLLAMA_API_BASE_URL` environment variable; recommend using `OLLAMA_BASE_URL` instead. Refer to our documentation for further details.
1204
+
1205
+ ## [0.1.108] - 2024-03-02
1206
+
1207
+ ### Added
1208
+
1209
+ - **🎮 Playground Feature (Beta)**: Explore the full potential of the raw API through an intuitive UI with our new playground feature, accessible to admins. Simply click on the bottom name area of the sidebar to access it. The playground feature offers two modes text completion (notebook) and chat completion. As it's in beta, please report any issues you encounter.
1210
+ - **🛠️ Direct Database Download for Admins**: Admins can now download the database directly from the WebUI via the admin settings.
1211
+ - **🎨 Additional RAG Settings**: Customize your RAG process with the ability to edit the TOP K value. Navigate to Documents > Settings > General to make changes.
1212
+ - **🖥️ UI Improvements**: Tooltips now available in the input area and sidebar handle. More tooltips will be added across other parts of the UI.
1213
+
1214
+ ### Fixed
1215
+
1216
+ - Resolved input autofocus issue on mobile when the sidebar is open, making it easier to use.
1217
+ - Corrected numbered list display issue in Safari (#963).
1218
+ - Restricted user ability to delete chats without proper permissions (#993).
1219
+
1220
+ ### Changed
1221
+
1222
+ - **Simplified Ollama Settings**: Ollama settings now don't require the `/api` suffix. You can now utilize the Ollama base URL directly, e.g., `http://localhost:11434`. Also, an `OLLAMA_BASE_URL` environment variable has been added.
1223
+ - **Database Renaming**: Starting from this release, `ollama.db` will be automatically renamed to `webui.db`.
1224
+
1225
+ ## [0.1.107] - 2024-03-01
1226
+
1227
+ ### Added
1228
+
1229
+ - **🚀 Makefile and LLM Update Script**: Included Makefile and a script for LLM updates in the repository.
1230
+
1231
+ ### Fixed
1232
+
1233
+ - Corrected issue where links in the settings modal didn't appear clickable (#960).
1234
+ - Fixed problem with web UI port not taking effect due to incorrect environment variable name in run-compose.sh (#996).
1235
+ - Enhanced user experience by displaying chat in browser title and enabling automatic scrolling to the bottom (#992).
1236
+
1237
+ ### Changed
1238
+
1239
+ - Upgraded toast library from `svelte-french-toast` to `svelte-sonner` for a more polished UI.
1240
+ - Enhanced accessibility with the addition of dark mode on the authentication page.
1241
+
1242
+ ## [0.1.106] - 2024-02-27
1243
+
1244
+ ### Added
1245
+
1246
+ - **🎯 Auto-focus Feature**: The input area now automatically focuses when initiating or opening a chat conversation.
1247
+
1248
+ ### Fixed
1249
+
1250
+ - Corrected typo from "HuggingFace" to "Hugging Face" (Issue #924).
1251
+ - Resolved bug causing errors in chat completion API calls to OpenAI due to missing "num_ctx" parameter (Issue #927).
1252
+ - Fixed issues preventing text editing, selection, and cursor retention in the input field (Issue #940).
1253
+ - Fixed a bug where defining an OpenAI-compatible API server using 'OPENAI_API_BASE_URL' containing 'openai' string resulted in hiding models not containing 'gpt' string from the model menu. (Issue #930)
1254
+
1255
+ ## [0.1.105] - 2024-02-25
1256
+
1257
+ ### Added
1258
+
1259
+ - **📄 Document Selection**: Now you can select and delete multiple documents at once for easier management.
1260
+
1261
+ ### Changed
1262
+
1263
+ - **🏷️ Document Pre-tagging**: Simply click the "+" button at the top, enter tag names in the popup window, or select from a list of existing tags. Then, upload files with the added tags for streamlined organization.
1264
+
1265
+ ## [0.1.104] - 2024-02-25
1266
+
1267
+ ### Added
1268
+
1269
+ - **🔄 Check for Updates**: Keep your system current by checking for updates conveniently located in Settings > About.
1270
+ - **🗑️ Automatic Tag Deletion**: Unused tags on the sidebar will now be deleted automatically with just a click.
1271
+
1272
+ ### Changed
1273
+
1274
+ - **🎨 Modernized Styling**: Enjoy a refreshed look with updated styling for a more contemporary experience.
1275
+
1276
+ ## [0.1.103] - 2024-02-25
1277
+
1278
+ ### Added
1279
+
1280
+ - **🔗 Built-in LiteLLM Proxy**: Now includes LiteLLM proxy within Open WebUI for enhanced functionality.
1281
+
1282
+ - Easily integrate existing LiteLLM configurations using `-v /path/to/config.yaml:/app/backend/data/litellm/config.yaml` flag.
1283
+ - When utilizing Docker container to run Open WebUI, ensure connections to localhost use `host.docker.internal`.
1284
+
1285
+ - **🖼️ Image Generation Enhancements**: Introducing Advanced Settings with Image Preview Feature.
1286
+ - Customize image generation by setting the number of steps; defaults to A1111 value.
1287
+
1288
+ ### Fixed
1289
+
1290
+ - Resolved issue with RAG scan halting document loading upon encountering unsupported MIME types or exceptions (Issue #866).
1291
+
1292
+ ### Changed
1293
+
1294
+ - Ollama is no longer required to run Open WebUI.
1295
+ - Access our comprehensive documentation at [Open WebUI Documentation](https://docs.openwebui.com/).
1296
+
1297
+ ## [0.1.102] - 2024-02-22
1298
+
1299
+ ### Added
1300
+
1301
+ - **🖼️ Image Generation**: Generate Images using the AUTOMATIC1111/stable-diffusion-webui API. You can set this up in Settings > Images.
1302
+ - **📝 Change title generation prompt**: Change the prompt used to generate titles for your chats. You can set this up in the Settings > Interface.
1303
+ - **🤖 Change embedding model**: Change the embedding model used to generate embeddings for your chats in the Dockerfile. Use any sentence transformer model from huggingface.co.
1304
+ - **📢 CHANGELOG.md/Popup**: This popup will show you the latest changes.
1305
+
1306
+ ## [0.1.101] - 2024-02-22
1307
+
1308
+ ### Fixed
1309
+
1310
+ - LaTex output formatting issue (#828)
1311
+
1312
+ ### Changed
1313
+
1314
+ - Instead of having the previous 1.0.0-alpha.101, we switched to semantic versioning as a way to respect global conventions.
CODE_OF_CONDUCT.md ADDED
@@ -0,0 +1,77 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Contributor Covenant Code of Conduct
2
+
3
+ ## Our Pledge
4
+
5
+ We as members, contributors, and leaders pledge to make participation in our
6
+ community a harassment-free experience for everyone, regardless of age, body
7
+ size, visible or invisible disability, ethnicity, sex characteristics, gender
8
+ identity and expression, level of experience, education, socio-economic status,
9
+ nationality, personal appearance, race, religion, or sexual identity
10
+ and orientation.
11
+
12
+ We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.
13
+
14
+ ## Our Standards
15
+
16
+ Examples of behavior that contribute to a positive environment for our community include:
17
+
18
+ - Demonstrating empathy and kindness toward other people
19
+ - Being respectful of differing opinions, viewpoints, and experiences
20
+ - Giving and gracefully accepting constructive feedback
21
+ - Accepting responsibility and apologizing to those affected by our mistakes, and learning from the experience
22
+ - Focusing on what is best not just for us as individuals, but for the overall community
23
+
24
+ Examples of unacceptable behavior include:
25
+
26
+ - The use of sexualized language or imagery, and sexual attention or advances of any kind
27
+ - Trolling, insulting or derogatory comments, and personal or political attacks
28
+ - Public or private harassment
29
+ - Publishing others' private information, such as a physical or email address, without their explicit permission
30
+ - **Spamming of any kind**
31
+ - Aggressive sales tactics targeting our community members are strictly prohibited. You can mention your product if it's relevant to the discussion, but under no circumstances should you push it forcefully
32
+ - Other conduct which could reasonably be considered inappropriate in a professional setting
33
+
34
+ ## Enforcement Responsibilities
35
+
36
+ Community leaders are responsible for clarifying and enforcing our standards of acceptable behavior and will take appropriate and fair corrective action in response to any behavior that they deem inappropriate, threatening, offensive, or harmful.
37
+
38
+ ## Scope
39
+
40
+ This Code of Conduct applies within all community spaces and also applies when an individual is officially representing the community in public spaces. Examples of representing our community include using an official e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event.
41
+
42
+ ## Enforcement
43
+
44
+ Instances of abusive, harassing, spamming, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at [email protected]. All complaints will be reviewed and investigated promptly and fairly.
45
+
46
+ All community leaders are obligated to respect the privacy and security of the reporter of any incident.
47
+
48
+ ## Enforcement Guidelines
49
+
50
+ Community leaders will follow these Community Impact Guidelines in determining the consequences for any action they deem in violation of this Code of Conduct:
51
+
52
+ ### 1. Temporary Ban
53
+
54
+ **Community Impact**: Any violation of community standards, including but not limited to inappropriate language, unprofessional behavior, harassment, or spamming.
55
+
56
+ **Consequence**: A temporary ban from any sort of interaction or public communication with the community for a specified period of time. No public or private interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, is allowed during this period. Violating these terms may lead to a permanent ban.
57
+
58
+ ### 2. Permanent Ban
59
+
60
+ **Community Impact**: Repeated or severe violations of community standards, including sustained inappropriate behavior, harassment of an individual, or aggression toward or disparagement of classes of individuals.
61
+
62
+ **Consequence**: A permanent ban from any sort of public interaction within the community.
63
+
64
+ ## Attribution
65
+
66
+ This Code of Conduct is adapted from the [Contributor Covenant][homepage],
67
+ version 2.0, available at
68
+ https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
69
+
70
+ Community Impact Guidelines were inspired by [Mozilla's code of conduct
71
+ enforcement ladder](https://github.com/mozilla/diversity).
72
+
73
+ [homepage]: https://www.contributor-covenant.org
74
+
75
+ For answers to common questions about this code of conduct, see the FAQ at
76
+ https://www.contributor-covenant.org/faq. Translations are available at
77
+ https://www.contributor-covenant.org/translations.
Caddyfile.localhost ADDED
@@ -0,0 +1,64 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Run with
2
+ # caddy run --envfile ./example.env --config ./Caddyfile.localhost
3
+ #
4
+ # This is configured for
5
+ # - Automatic HTTPS (even for localhost)
6
+ # - Reverse Proxying to Ollama API Base URL (http://localhost:11434/api)
7
+ # - CORS
8
+ # - HTTP Basic Auth API Tokens (uncomment basicauth section)
9
+
10
+
11
+ # CORS Preflight (OPTIONS) + Request (GET, POST, PATCH, PUT, DELETE)
12
+ (cors-api) {
13
+ @match-cors-api-preflight method OPTIONS
14
+ handle @match-cors-api-preflight {
15
+ header {
16
+ Access-Control-Allow-Origin "{http.request.header.origin}"
17
+ Access-Control-Allow-Methods "GET, POST, PUT, PATCH, DELETE, OPTIONS"
18
+ Access-Control-Allow-Headers "Origin, Accept, Authorization, Content-Type, X-Requested-With"
19
+ Access-Control-Allow-Credentials "true"
20
+ Access-Control-Max-Age "3600"
21
+ defer
22
+ }
23
+ respond "" 204
24
+ }
25
+
26
+ @match-cors-api-request {
27
+ not {
28
+ header Origin "{http.request.scheme}://{http.request.host}"
29
+ }
30
+ header Origin "{http.request.header.origin}"
31
+ }
32
+ handle @match-cors-api-request {
33
+ header {
34
+ Access-Control-Allow-Origin "{http.request.header.origin}"
35
+ Access-Control-Allow-Methods "GET, POST, PUT, PATCH, DELETE, OPTIONS"
36
+ Access-Control-Allow-Headers "Origin, Accept, Authorization, Content-Type, X-Requested-With"
37
+ Access-Control-Allow-Credentials "true"
38
+ Access-Control-Max-Age "3600"
39
+ defer
40
+ }
41
+ }
42
+ }
43
+
44
+ # replace localhost with example.com or whatever
45
+ localhost {
46
+ ## HTTP Basic Auth
47
+ ## (uncomment to enable)
48
+ # basicauth {
49
+ # # see .example.env for how to generate tokens
50
+ # {env.OLLAMA_API_ID} {env.OLLAMA_API_TOKEN_DIGEST}
51
+ # }
52
+
53
+ handle /api/* {
54
+ # Comment to disable CORS
55
+ import cors-api
56
+
57
+ reverse_proxy localhost:11434
58
+ }
59
+
60
+ # Same-Origin Static Web Server
61
+ file_server {
62
+ root ./build/
63
+ }
64
+ }
Dockerfile ADDED
@@ -0,0 +1,176 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # syntax=docker/dockerfile:1
2
+ # Initialize device type args
3
+ # use build args in the docker build command with --build-arg="BUILDARG=true"
4
+ ARG USE_CUDA=false
5
+ ARG USE_OLLAMA=false
6
+ # Tested with cu117 for CUDA 11 and cu121 for CUDA 12 (default)
7
+ ARG USE_CUDA_VER=cu121
8
+ # any sentence transformer model; models to use can be found at https://huggingface.co/models?library=sentence-transformers
9
+ # Leaderboard: https://huggingface.co/spaces/mteb/leaderboard
10
+ # for better performance and multilangauge support use "intfloat/multilingual-e5-large" (~2.5GB) or "intfloat/multilingual-e5-base" (~1.5GB)
11
+ # IMPORTANT: If you change the embedding model (sentence-transformers/all-MiniLM-L6-v2) and vice versa, you aren't able to use RAG Chat with your previous documents loaded in the WebUI! You need to re-embed them.
12
+ ARG USE_EMBEDDING_MODEL=sentence-transformers/all-MiniLM-L6-v2
13
+ ARG USE_RERANKING_MODEL=""
14
+
15
+ # Tiktoken encoding name; models to use can be found at https://huggingface.co/models?library=tiktoken
16
+ ARG USE_TIKTOKEN_ENCODING_NAME="cl100k_base"
17
+
18
+ ARG BUILD_HASH=dev-build
19
+ # Override at your own risk - non-root configurations are untested
20
+ ARG UID=0
21
+ ARG GID=0
22
+
23
+ ######## WebUI frontend ########
24
+ FROM --platform=$BUILDPLATFORM node:22-alpine3.20 AS build
25
+ ARG BUILD_HASH
26
+
27
+ WORKDIR /app
28
+
29
+ COPY package.json package-lock.json ./
30
+ RUN npm ci
31
+
32
+ COPY . .
33
+ ENV APP_BUILD_HASH=${BUILD_HASH}
34
+ RUN npm run build
35
+
36
+ ######## WebUI backend ########
37
+ FROM python:3.11-slim-bookworm AS base
38
+
39
+ # Use args
40
+ ARG USE_CUDA
41
+ ARG USE_OLLAMA
42
+ ARG USE_CUDA_VER
43
+ ARG USE_EMBEDDING_MODEL
44
+ ARG USE_RERANKING_MODEL
45
+ ARG UID
46
+ ARG GID
47
+
48
+ ## Basis ##
49
+ ENV ENV=prod \
50
+ PORT=8080 \
51
+ # pass build args to the build
52
+ USE_OLLAMA_DOCKER=${USE_OLLAMA} \
53
+ USE_CUDA_DOCKER=${USE_CUDA} \
54
+ USE_CUDA_DOCKER_VER=${USE_CUDA_VER} \
55
+ USE_EMBEDDING_MODEL_DOCKER=${USE_EMBEDDING_MODEL} \
56
+ USE_RERANKING_MODEL_DOCKER=${USE_RERANKING_MODEL}
57
+
58
+ ## Basis URL Config ##
59
+ ENV OLLAMA_BASE_URL="/ollama" \
60
+ OPENAI_API_BASE_URL=""
61
+
62
+ ## API Key and Security Config ##
63
+ ENV OPENAI_API_KEY="" \
64
+ WEBUI_SECRET_KEY="" \
65
+ SCARF_NO_ANALYTICS=true \
66
+ DO_NOT_TRACK=true \
67
+ ANONYMIZED_TELEMETRY=false
68
+
69
+ #### Other models #########################################################
70
+ ## whisper TTS model settings ##
71
+ ENV WHISPER_MODEL="base" \
72
+ WHISPER_MODEL_DIR="/app/backend/data/cache/whisper/models"
73
+
74
+ ## RAG Embedding model settings ##
75
+ ENV RAG_EMBEDDING_MODEL="$USE_EMBEDDING_MODEL_DOCKER" \
76
+ RAG_RERANKING_MODEL="$USE_RERANKING_MODEL_DOCKER" \
77
+ SENTENCE_TRANSFORMERS_HOME="/app/backend/data/cache/embedding/models"
78
+
79
+ ## Tiktoken model settings ##
80
+ ENV TIKTOKEN_ENCODING_NAME="cl100k_base" \
81
+ TIKTOKEN_CACHE_DIR="/app/backend/data/cache/tiktoken"
82
+
83
+ ## Hugging Face download cache ##
84
+ ENV HF_HOME="/app/backend/data/cache/embedding/models"
85
+
86
+ ## Torch Extensions ##
87
+ # ENV TORCH_EXTENSIONS_DIR="/.cache/torch_extensions"
88
+
89
+ #### Other models ##########################################################
90
+
91
+ WORKDIR /app/backend
92
+
93
+ ENV HOME=/root
94
+ # Create user and group if not root
95
+ RUN if [ $UID -ne 0 ]; then \
96
+ if [ $GID -ne 0 ]; then \
97
+ addgroup --gid $GID app; \
98
+ fi; \
99
+ adduser --uid $UID --gid $GID --home $HOME --disabled-password --no-create-home app; \
100
+ fi
101
+
102
+ RUN mkdir -p $HOME/.cache/chroma
103
+ RUN echo -n 00000000-0000-0000-0000-000000000000 > $HOME/.cache/chroma/telemetry_user_id
104
+
105
+ # Make sure the user has access to the app and root directory
106
+ RUN chown -R $UID:$GID /app $HOME
107
+
108
+ RUN if [ "$USE_OLLAMA" = "true" ]; then \
109
+ apt-get update && \
110
+ # Install pandoc and netcat
111
+ apt-get install -y --no-install-recommends git build-essential pandoc netcat-openbsd curl && \
112
+ apt-get install -y --no-install-recommends gcc python3-dev && \
113
+ # for RAG OCR
114
+ apt-get install -y --no-install-recommends ffmpeg libsm6 libxext6 && \
115
+ # install helper tools
116
+ apt-get install -y --no-install-recommends curl jq && \
117
+ # install ollama
118
+ curl -fsSL https://ollama.com/install.sh | sh && \
119
+ # cleanup
120
+ rm -rf /var/lib/apt/lists/*; \
121
+ else \
122
+ apt-get update && \
123
+ # Install pandoc, netcat and gcc
124
+ apt-get install -y --no-install-recommends git build-essential pandoc gcc netcat-openbsd curl jq && \
125
+ apt-get install -y --no-install-recommends gcc python3-dev && \
126
+ # for RAG OCR
127
+ apt-get install -y --no-install-recommends ffmpeg libsm6 libxext6 && \
128
+ # cleanup
129
+ rm -rf /var/lib/apt/lists/*; \
130
+ fi
131
+
132
+ # install python dependencies
133
+ COPY --chown=$UID:$GID ./backend/requirements.txt ./requirements.txt
134
+
135
+ RUN pip3 install uv && \
136
+ if [ "$USE_CUDA" = "true" ]; then \
137
+ # If you use CUDA the whisper and embedding model will be downloaded on first use
138
+ pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/$USE_CUDA_DOCKER_VER --no-cache-dir && \
139
+ uv pip install --system -r requirements.txt --no-cache-dir && \
140
+ python -c "import os; from sentence_transformers import SentenceTransformer; SentenceTransformer(os.environ['RAG_EMBEDDING_MODEL'], device='cpu')" && \
141
+ python -c "import os; from faster_whisper import WhisperModel; WhisperModel(os.environ['WHISPER_MODEL'], device='cpu', compute_type='int8', download_root=os.environ['WHISPER_MODEL_DIR'])"; \
142
+ python -c "import os; import tiktoken; tiktoken.get_encoding(os.environ['TIKTOKEN_ENCODING_NAME'])"; \
143
+ else \
144
+ pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu --no-cache-dir && \
145
+ uv pip install --system -r requirements.txt --no-cache-dir && \
146
+ python -c "import os; from sentence_transformers import SentenceTransformer; SentenceTransformer(os.environ['RAG_EMBEDDING_MODEL'], device='cpu')" && \
147
+ python -c "import os; from faster_whisper import WhisperModel; WhisperModel(os.environ['WHISPER_MODEL'], device='cpu', compute_type='int8', download_root=os.environ['WHISPER_MODEL_DIR'])"; \
148
+ python -c "import os; import tiktoken; tiktoken.get_encoding(os.environ['TIKTOKEN_ENCODING_NAME'])"; \
149
+ fi; \
150
+ chown -R $UID:$GID /app/backend/data/
151
+
152
+
153
+
154
+ # copy embedding weight from build
155
+ # RUN mkdir -p /root/.cache/chroma/onnx_models/all-MiniLM-L6-v2
156
+ # COPY --from=build /app/onnx /root/.cache/chroma/onnx_models/all-MiniLM-L6-v2/onnx
157
+
158
+ # copy built frontend files
159
+ COPY --chown=$UID:$GID --from=build /app/build /app/build
160
+ COPY --chown=$UID:$GID --from=build /app/CHANGELOG.md /app/CHANGELOG.md
161
+ COPY --chown=$UID:$GID --from=build /app/package.json /app/package.json
162
+
163
+ # copy backend files
164
+ COPY --chown=$UID:$GID ./backend .
165
+
166
+ EXPOSE 8080
167
+
168
+ HEALTHCHECK CMD curl --silent --fail http://localhost:${PORT:-8080}/health | jq -ne 'input.status == true' || exit 1
169
+
170
+ USER $UID:$GID
171
+
172
+ ARG BUILD_HASH
173
+ ENV WEBUI_BUILD_VERSION=${BUILD_HASH}
174
+ ENV DOCKER=true
175
+
176
+ CMD [ "bash", "start.sh"]
INSTALLATION.md ADDED
@@ -0,0 +1,35 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ### Installing Both Ollama and Open WebUI Using Kustomize
2
+
3
+ For cpu-only pod
4
+
5
+ ```bash
6
+ kubectl apply -f ./kubernetes/manifest/base
7
+ ```
8
+
9
+ For gpu-enabled pod
10
+
11
+ ```bash
12
+ kubectl apply -k ./kubernetes/manifest
13
+ ```
14
+
15
+ ### Installing Both Ollama and Open WebUI Using Helm
16
+
17
+ Package Helm file first
18
+
19
+ ```bash
20
+ helm package ./kubernetes/helm/
21
+ ```
22
+
23
+ For cpu-only pod
24
+
25
+ ```bash
26
+ helm install ollama-webui ./ollama-webui-*.tgz
27
+ ```
28
+
29
+ For gpu-enabled pod
30
+
31
+ ```bash
32
+ helm install ollama-webui ./ollama-webui-*.tgz --set ollama.resources.limits.nvidia.com/gpu="1"
33
+ ```
34
+
35
+ Check the `kubernetes/helm/values.yaml` file to know which parameters are available for customization
LICENSE ADDED
@@ -0,0 +1,21 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ MIT License
2
+
3
+ Copyright (c) 2023 Timothy Jaeryang Baek
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
Makefile ADDED
@@ -0,0 +1,33 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+
2
+ ifneq ($(shell which docker-compose 2>/dev/null),)
3
+ DOCKER_COMPOSE := docker-compose
4
+ else
5
+ DOCKER_COMPOSE := docker compose
6
+ endif
7
+
8
+ install:
9
+ $(DOCKER_COMPOSE) up -d
10
+
11
+ remove:
12
+ @chmod +x confirm_remove.sh
13
+ @./confirm_remove.sh
14
+
15
+ start:
16
+ $(DOCKER_COMPOSE) start
17
+ startAndBuild:
18
+ $(DOCKER_COMPOSE) up -d --build
19
+
20
+ stop:
21
+ $(DOCKER_COMPOSE) stop
22
+
23
+ update:
24
+ # Calls the LLM update script
25
+ chmod +x update_ollama_models.sh
26
+ @./update_ollama_models.sh
27
+ @git pull
28
+ $(DOCKER_COMPOSE) down
29
+ # Make sure the ollama-webui container is stopped before rebuilding
30
+ @docker stop open-webui || true
31
+ $(DOCKER_COMPOSE) up --build -d
32
+ $(DOCKER_COMPOSE) start
33
+
README.md ADDED
@@ -0,0 +1,221 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ title: Open WebUI
3
+ emoji: 🐳
4
+ colorFrom: purple
5
+ colorTo: gray
6
+ sdk: docker
7
+ app_port: 8080
8
+ ---
9
+ # Open WebUI 👋
10
+
11
+ ![GitHub stars](https://img.shields.io/github/stars/open-webui/open-webui?style=social)
12
+ ![GitHub forks](https://img.shields.io/github/forks/open-webui/open-webui?style=social)
13
+ ![GitHub watchers](https://img.shields.io/github/watchers/open-webui/open-webui?style=social)
14
+ ![GitHub repo size](https://img.shields.io/github/repo-size/open-webui/open-webui)
15
+ ![GitHub language count](https://img.shields.io/github/languages/count/open-webui/open-webui)
16
+ ![GitHub top language](https://img.shields.io/github/languages/top/open-webui/open-webui)
17
+ ![GitHub last commit](https://img.shields.io/github/last-commit/open-webui/open-webui?color=red)
18
+ ![Hits](https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https%3A%2F%2Fgithub.com%2Follama-webui%2Follama-wbui&count_bg=%2379C83D&title_bg=%23555555&icon=&icon_color=%23E7E7E7&title=hits&edge_flat=false)
19
+ [![Discord](https://img.shields.io/badge/Discord-Open_WebUI-blue?logo=discord&logoColor=white)](https://discord.gg/5rJgQTnV4s)
20
+ [![](https://img.shields.io/static/v1?label=Sponsor&message=%E2%9D%A4&logo=GitHub&color=%23fe8e86)](https://github.com/sponsors/tjbck)
21
+
22
+ Open WebUI is an [extensible](https://github.com/open-webui/pipelines), feature-rich, and user-friendly self-hosted WebUI designed to operate entirely offline. It supports various LLM runners, including Ollama and OpenAI-compatible APIs. For more information, be sure to check out our [Open WebUI Documentation](https://docs.openwebui.com/).
23
+
24
+ ![Open WebUI Demo](./demo.gif)
25
+
26
+ ## Key Features of Open WebUI ⭐
27
+
28
+ - 🚀 **Effortless Setup**: Install seamlessly using Docker or Kubernetes (kubectl, kustomize or helm) for a hassle-free experience with support for both `:ollama` and `:cuda` tagged images.
29
+
30
+ - 🤝 **Ollama/OpenAI API Integration**: Effortlessly integrate OpenAI-compatible APIs for versatile conversations alongside Ollama models. Customize the OpenAI API URL to link with **LMStudio, GroqCloud, Mistral, OpenRouter, and more**.
31
+
32
+ - 🛡️ **Granular Permissions and User Groups**: By allowing administrators to create detailed user roles and permissions, we ensure a secure user environment. This granularity not only enhances security but also allows for customized user experiences, fostering a sense of ownership and responsibility amongst users.
33
+
34
+ - 📱 **Responsive Design**: Enjoy a seamless experience across Desktop PC, Laptop, and Mobile devices.
35
+
36
+ - 📱 **Progressive Web App (PWA) for Mobile**: Enjoy a native app-like experience on your mobile device with our PWA, providing offline access on localhost and a seamless user interface.
37
+
38
+ - ✒️🔢 **Full Markdown and LaTeX Support**: Elevate your LLM experience with comprehensive Markdown and LaTeX capabilities for enriched interaction.
39
+
40
+ - 🎤📹 **Hands-Free Voice/Video Call**: Experience seamless communication with integrated hands-free voice and video call features, allowing for a more dynamic and interactive chat environment.
41
+
42
+ - 🛠️ **Model Builder**: Easily create Ollama models via the Web UI. Create and add custom characters/agents, customize chat elements, and import models effortlessly through [Open WebUI Community](https://openwebui.com/) integration.
43
+
44
+ - 🐍 **Native Python Function Calling Tool**: Enhance your LLMs with built-in code editor support in the tools workspace. Bring Your Own Function (BYOF) by simply adding your pure Python functions, enabling seamless integration with LLMs.
45
+
46
+ - 📚 **Local RAG Integration**: Dive into the future of chat interactions with groundbreaking Retrieval Augmented Generation (RAG) support. This feature seamlessly integrates document interactions into your chat experience. You can load documents directly into the chat or add files to your document library, effortlessly accessing them using the `#` command before a query.
47
+
48
+ - 🔍 **Web Search for RAG**: Perform web searches using providers like `SearXNG`, `Google PSE`, `Brave Search`, `serpstack`, `serper`, `Serply`, `DuckDuckGo`, `TavilySearch`, `SearchApi` and `Bing` and inject the results directly into your chat experience.
49
+
50
+ - 🌐 **Web Browsing Capability**: Seamlessly integrate websites into your chat experience using the `#` command followed by a URL. This feature allows you to incorporate web content directly into your conversations, enhancing the richness and depth of your interactions.
51
+
52
+ - 🎨 **Image Generation Integration**: Seamlessly incorporate image generation capabilities using options such as AUTOMATIC1111 API or ComfyUI (local), and OpenAI's DALL-E (external), enriching your chat experience with dynamic visual content.
53
+
54
+ - ⚙️ **Many Models Conversations**: Effortlessly engage with various models simultaneously, harnessing their unique strengths for optimal responses. Enhance your experience by leveraging a diverse set of models in parallel.
55
+
56
+ - 🔐 **Role-Based Access Control (RBAC)**: Ensure secure access with restricted permissions; only authorized individuals can access your Ollama, and exclusive model creation/pulling rights are reserved for administrators.
57
+
58
+ - 🌐🌍 **Multilingual Support**: Experience Open WebUI in your preferred language with our internationalization (i18n) support. Join us in expanding our supported languages! We're actively seeking contributors!
59
+
60
+ - 🧩 **Pipelines, Open WebUI Plugin Support**: Seamlessly integrate custom logic and Python libraries into Open WebUI using [Pipelines Plugin Framework](https://github.com/open-webui/pipelines). Launch your Pipelines instance, set the OpenAI URL to the Pipelines URL, and explore endless possibilities. [Examples](https://github.com/open-webui/pipelines/tree/main/examples) include **Function Calling**, User **Rate Limiting** to control access, **Usage Monitoring** with tools like Langfuse, **Live Translation with LibreTranslate** for multilingual support, **Toxic Message Filtering** and much more.
61
+
62
+ - 🌟 **Continuous Updates**: We are committed to improving Open WebUI with regular updates, fixes, and new features.
63
+
64
+ Want to learn more about Open WebUI's features? Check out our [Open WebUI documentation](https://docs.openwebui.com/features) for a comprehensive overview!
65
+
66
+ ## 🔗 Also Check Out Open WebUI Community!
67
+
68
+ Don't forget to explore our sibling project, [Open WebUI Community](https://openwebui.com/), where you can discover, download, and explore customized Modelfiles. Open WebUI Community offers a wide range of exciting possibilities for enhancing your chat interactions with Open WebUI! 🚀
69
+
70
+ ## How to Install 🚀
71
+
72
+ ### Installation via Python pip 🐍
73
+
74
+ Open WebUI can be installed using pip, the Python package installer. Before proceeding, ensure you're using **Python 3.11** to avoid compatibility issues.
75
+
76
+ 1. **Install Open WebUI**:
77
+ Open your terminal and run the following command to install Open WebUI:
78
+
79
+ ```bash
80
+ pip install open-webui
81
+ ```
82
+
83
+ 2. **Running Open WebUI**:
84
+ After installation, you can start Open WebUI by executing:
85
+
86
+ ```bash
87
+ open-webui serve
88
+ ```
89
+
90
+ This will start the Open WebUI server, which you can access at [http://localhost:8080](http://localhost:8080)
91
+
92
+ ### Quick Start with Docker 🐳
93
+
94
+ > [!NOTE]
95
+ > Please note that for certain Docker environments, additional configurations might be needed. If you encounter any connection issues, our detailed guide on [Open WebUI Documentation](https://docs.openwebui.com/) is ready to assist you.
96
+
97
+ > [!WARNING]
98
+ > When using Docker to install Open WebUI, make sure to include the `-v open-webui:/app/backend/data` in your Docker command. This step is crucial as it ensures your database is properly mounted and prevents any loss of data.
99
+
100
+ > [!TIP]
101
+ > If you wish to utilize Open WebUI with Ollama included or CUDA acceleration, we recommend utilizing our official images tagged with either `:cuda` or `:ollama`. To enable CUDA, you must install the [Nvidia CUDA container toolkit](https://docs.nvidia.com/dgx/nvidia-container-runtime-upgrade/) on your Linux/WSL system.
102
+
103
+ ### Installation with Default Configuration
104
+
105
+ - **If Ollama is on your computer**, use this command:
106
+
107
+ ```bash
108
+ docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main
109
+ ```
110
+
111
+ - **If Ollama is on a Different Server**, use this command:
112
+
113
+ To connect to Ollama on another server, change the `OLLAMA_BASE_URL` to the server's URL:
114
+
115
+ ```bash
116
+ docker run -d -p 3000:8080 -e OLLAMA_BASE_URL=https://example.com -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main
117
+ ```
118
+
119
+ - **To run Open WebUI with Nvidia GPU support**, use this command:
120
+
121
+ ```bash
122
+ docker run -d -p 3000:8080 --gpus all --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:cuda
123
+ ```
124
+
125
+ ### Installation for OpenAI API Usage Only
126
+
127
+ - **If you're only using OpenAI API**, use this command:
128
+
129
+ ```bash
130
+ docker run -d -p 3000:8080 -e OPENAI_API_KEY=your_secret_key -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main
131
+ ```
132
+
133
+ ### Installing Open WebUI with Bundled Ollama Support
134
+
135
+ This installation method uses a single container image that bundles Open WebUI with Ollama, allowing for a streamlined setup via a single command. Choose the appropriate command based on your hardware setup:
136
+
137
+ - **With GPU Support**:
138
+ Utilize GPU resources by running the following command:
139
+
140
+ ```bash
141
+ docker run -d -p 3000:8080 --gpus=all -v ollama:/root/.ollama -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:ollama
142
+ ```
143
+
144
+ - **For CPU Only**:
145
+ If you're not using a GPU, use this command instead:
146
+
147
+ ```bash
148
+ docker run -d -p 3000:8080 -v ollama:/root/.ollama -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:ollama
149
+ ```
150
+
151
+ Both commands facilitate a built-in, hassle-free installation of both Open WebUI and Ollama, ensuring that you can get everything up and running swiftly.
152
+
153
+ After installation, you can access Open WebUI at [http://localhost:3000](http://localhost:3000). Enjoy! 😄
154
+
155
+ ### Other Installation Methods
156
+
157
+ We offer various installation alternatives, including non-Docker native installation methods, Docker Compose, Kustomize, and Helm. Visit our [Open WebUI Documentation](https://docs.openwebui.com/getting-started/) or join our [Discord community](https://discord.gg/5rJgQTnV4s) for comprehensive guidance.
158
+
159
+ ### Troubleshooting
160
+
161
+ Encountering connection issues? Our [Open WebUI Documentation](https://docs.openwebui.com/troubleshooting/) has got you covered. For further assistance and to join our vibrant community, visit the [Open WebUI Discord](https://discord.gg/5rJgQTnV4s).
162
+
163
+ #### Open WebUI: Server Connection Error
164
+
165
+ If you're experiencing connection issues, it’s often due to the WebUI docker container not being able to reach the Ollama server at 127.0.0.1:11434 (host.docker.internal:11434) inside the container . Use the `--network=host` flag in your docker command to resolve this. Note that the port changes from 3000 to 8080, resulting in the link: `http://localhost:8080`.
166
+
167
+ **Example Docker Command**:
168
+
169
+ ```bash
170
+ docker run -d --network=host -v open-webui:/app/backend/data -e OLLAMA_BASE_URL=http://127.0.0.1:11434 --name open-webui --restart always ghcr.io/open-webui/open-webui:main
171
+ ```
172
+
173
+ ### Keeping Your Docker Installation Up-to-Date
174
+
175
+ In case you want to update your local Docker installation to the latest version, you can do it with [Watchtower](https://containrrr.dev/watchtower/):
176
+
177
+ ```bash
178
+ docker run --rm --volume /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower --run-once open-webui
179
+ ```
180
+
181
+ In the last part of the command, replace `open-webui` with your container name if it is different.
182
+
183
+ Check our Migration Guide available in our [Open WebUI Documentation](https://docs.openwebui.com/tutorials/migration/).
184
+
185
+ ### Using the Dev Branch 🌙
186
+
187
+ > [!WARNING]
188
+ > The `:dev` branch contains the latest unstable features and changes. Use it at your own risk as it may have bugs or incomplete features.
189
+
190
+ If you want to try out the latest bleeding-edge features and are okay with occasional instability, you can use the `:dev` tag like this:
191
+
192
+ ```bash
193
+ docker run -d -p 3000:8080 -v open-webui:/app/backend/data --name open-webui --add-host=host.docker.internal:host-gateway --restart always ghcr.io/open-webui/open-webui:dev
194
+ ```
195
+
196
+ ## What's Next? 🌟
197
+
198
+ Discover upcoming features on our roadmap in the [Open WebUI Documentation](https://docs.openwebui.com/roadmap/).
199
+
200
+ ## License 📜
201
+
202
+ This project is licensed under the [MIT License](LICENSE) - see the [LICENSE](LICENSE) file for details. 📄
203
+
204
+ ## Support 💬
205
+
206
+ If you have any questions, suggestions, or need assistance, please open an issue or join our
207
+ [Open WebUI Discord community](https://discord.gg/5rJgQTnV4s) to connect with us! 🤝
208
+
209
+ ## Star History
210
+
211
+ <a href="https://star-history.com/#open-webui/open-webui&Date">
212
+ <picture>
213
+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=open-webui/open-webui&type=Date&theme=dark" />
214
+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=open-webui/open-webui&type=Date" />
215
+ <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=open-webui/open-webui&type=Date" />
216
+ </picture>
217
+ </a>
218
+
219
+ ---
220
+
221
+ Created by [Timothy Jaeryang Baek](https://github.com/tjbck) - Let's make Open WebUI even more amazing together! 💪
TROUBLESHOOTING.md ADDED
@@ -0,0 +1,36 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Open WebUI Troubleshooting Guide
2
+
3
+ ## Understanding the Open WebUI Architecture
4
+
5
+ The Open WebUI system is designed to streamline interactions between the client (your browser) and the Ollama API. At the heart of this design is a backend reverse proxy, enhancing security and resolving CORS issues.
6
+
7
+ - **How it Works**: The Open WebUI is designed to interact with the Ollama API through a specific route. When a request is made from the WebUI to Ollama, it is not directly sent to the Ollama API. Initially, the request is sent to the Open WebUI backend via `/ollama` route. From there, the backend is responsible for forwarding the request to the Ollama API. This forwarding is accomplished by using the route specified in the `OLLAMA_BASE_URL` environment variable. Therefore, a request made to `/ollama` in the WebUI is effectively the same as making a request to `OLLAMA_BASE_URL` in the backend. For instance, a request to `/ollama/api/tags` in the WebUI is equivalent to `OLLAMA_BASE_URL/api/tags` in the backend.
8
+
9
+ - **Security Benefits**: This design prevents direct exposure of the Ollama API to the frontend, safeguarding against potential CORS (Cross-Origin Resource Sharing) issues and unauthorized access. Requiring authentication to access the Ollama API further enhances this security layer.
10
+
11
+ ## Open WebUI: Server Connection Error
12
+
13
+ If you're experiencing connection issues, it’s often due to the WebUI docker container not being able to reach the Ollama server at 127.0.0.1:11434 (host.docker.internal:11434) inside the container . Use the `--network=host` flag in your docker command to resolve this. Note that the port changes from 3000 to 8080, resulting in the link: `http://localhost:8080`.
14
+
15
+ **Example Docker Command**:
16
+
17
+ ```bash
18
+ docker run -d --network=host -v open-webui:/app/backend/data -e OLLAMA_BASE_URL=http://127.0.0.1:11434 --name open-webui --restart always ghcr.io/open-webui/open-webui:main
19
+ ```
20
+
21
+ ### Error on Slow Responses for Ollama
22
+
23
+ Open WebUI has a default timeout of 5 minutes for Ollama to finish generating the response. If needed, this can be adjusted via the environment variable AIOHTTP_CLIENT_TIMEOUT, which sets the timeout in seconds.
24
+
25
+ ### General Connection Errors
26
+
27
+ **Ensure Ollama Version is Up-to-Date**: Always start by checking that you have the latest version of Ollama. Visit [Ollama's official site](https://ollama.com/) for the latest updates.
28
+
29
+ **Troubleshooting Steps**:
30
+
31
+ 1. **Verify Ollama URL Format**:
32
+ - When running the Web UI container, ensure the `OLLAMA_BASE_URL` is correctly set. (e.g., `http://192.168.1.1:11434` for different host setups).
33
+ - In the Open WebUI, navigate to "Settings" > "General".
34
+ - Confirm that the Ollama Server URL is correctly set to `[OLLAMA URL]` (e.g., `http://localhost:11434`).
35
+
36
+ By following these enhanced troubleshooting steps, connection issues should be effectively resolved. For further assistance or queries, feel free to reach out to us on our community Discord.
backend/.dockerignore ADDED
@@ -0,0 +1,14 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ __pycache__
2
+ .env
3
+ _old
4
+ uploads
5
+ .ipynb_checkpoints
6
+ *.db
7
+ _test
8
+ !/data
9
+ /data/*
10
+ !/data/litellm
11
+ /data/litellm/*
12
+ !data/litellm/config.yaml
13
+
14
+ !data/config.json
backend/.gitignore ADDED
@@ -0,0 +1,12 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ __pycache__
2
+ .env
3
+ _old
4
+ uploads
5
+ .ipynb_checkpoints
6
+ *.db
7
+ _test
8
+ Pipfile
9
+ !/data
10
+ /data/*
11
+ /open_webui/data/*
12
+ .webui_secret_key
backend/dev.sh ADDED
@@ -0,0 +1,2 @@
 
 
 
1
+ PORT="${PORT:-8080}"
2
+ uvicorn open_webui.main:app --port $PORT --host 0.0.0.0 --forwarded-allow-ips '*' --reload
backend/open_webui/__init__.py ADDED
@@ -0,0 +1,77 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ import base64
2
+ import os
3
+ import random
4
+ from pathlib import Path
5
+
6
+ import typer
7
+ import uvicorn
8
+
9
+ app = typer.Typer()
10
+
11
+ KEY_FILE = Path.cwd() / ".webui_secret_key"
12
+
13
+
14
+ @app.command()
15
+ def serve(
16
+ host: str = "0.0.0.0",
17
+ port: int = 8080,
18
+ ):
19
+ os.environ["FROM_INIT_PY"] = "true"
20
+ if os.getenv("WEBUI_SECRET_KEY") is None:
21
+ typer.echo(
22
+ "Loading WEBUI_SECRET_KEY from file, not provided as an environment variable."
23
+ )
24
+ if not KEY_FILE.exists():
25
+ typer.echo(f"Generating a new secret key and saving it to {KEY_FILE}")
26
+ KEY_FILE.write_bytes(base64.b64encode(random.randbytes(12)))
27
+ typer.echo(f"Loading WEBUI_SECRET_KEY from {KEY_FILE}")
28
+ os.environ["WEBUI_SECRET_KEY"] = KEY_FILE.read_text()
29
+
30
+ if os.getenv("USE_CUDA_DOCKER", "false") == "true":
31
+ typer.echo(
32
+ "CUDA is enabled, appending LD_LIBRARY_PATH to include torch/cudnn & cublas libraries."
33
+ )
34
+ LD_LIBRARY_PATH = os.getenv("LD_LIBRARY_PATH", "").split(":")
35
+ os.environ["LD_LIBRARY_PATH"] = ":".join(
36
+ LD_LIBRARY_PATH
37
+ + [
38
+ "/usr/local/lib/python3.11/site-packages/torch/lib",
39
+ "/usr/local/lib/python3.11/site-packages/nvidia/cudnn/lib",
40
+ ]
41
+ )
42
+ try:
43
+ import torch
44
+
45
+ assert torch.cuda.is_available(), "CUDA not available"
46
+ typer.echo("CUDA seems to be working")
47
+ except Exception as e:
48
+ typer.echo(
49
+ "Error when testing CUDA but USE_CUDA_DOCKER is true. "
50
+ "Resetting USE_CUDA_DOCKER to false and removing "
51
+ f"LD_LIBRARY_PATH modifications: {e}"
52
+ )
53
+ os.environ["USE_CUDA_DOCKER"] = "false"
54
+ os.environ["LD_LIBRARY_PATH"] = ":".join(LD_LIBRARY_PATH)
55
+
56
+ import open_webui.main # we need set environment variables before importing main
57
+
58
+ uvicorn.run(open_webui.main.app, host=host, port=port, forwarded_allow_ips="*")
59
+
60
+
61
+ @app.command()
62
+ def dev(
63
+ host: str = "0.0.0.0",
64
+ port: int = 8080,
65
+ reload: bool = True,
66
+ ):
67
+ uvicorn.run(
68
+ "open_webui.main:app",
69
+ host=host,
70
+ port=port,
71
+ reload=reload,
72
+ forwarded_allow_ips="*",
73
+ )
74
+
75
+
76
+ if __name__ == "__main__":
77
+ app()
backend/open_webui/alembic.ini ADDED
@@ -0,0 +1,114 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # A generic, single database configuration.
2
+
3
+ [alembic]
4
+ # path to migration scripts
5
+ script_location = migrations
6
+
7
+ # template used to generate migration file names; The default value is %%(rev)s_%%(slug)s
8
+ # Uncomment the line below if you want the files to be prepended with date and time
9
+ # file_template = %%(year)d_%%(month).2d_%%(day).2d_%%(hour).2d%%(minute).2d-%%(rev)s_%%(slug)s
10
+
11
+ # sys.path path, will be prepended to sys.path if present.
12
+ # defaults to the current working directory.
13
+ prepend_sys_path = .
14
+
15
+ # timezone to use when rendering the date within the migration file
16
+ # as well as the filename.
17
+ # If specified, requires the python>=3.9 or backports.zoneinfo library.
18
+ # Any required deps can installed by adding `alembic[tz]` to the pip requirements
19
+ # string value is passed to ZoneInfo()
20
+ # leave blank for localtime
21
+ # timezone =
22
+
23
+ # max length of characters to apply to the
24
+ # "slug" field
25
+ # truncate_slug_length = 40
26
+
27
+ # set to 'true' to run the environment during
28
+ # the 'revision' command, regardless of autogenerate
29
+ # revision_environment = false
30
+
31
+ # set to 'true' to allow .pyc and .pyo files without
32
+ # a source .py file to be detected as revisions in the
33
+ # versions/ directory
34
+ # sourceless = false
35
+
36
+ # version location specification; This defaults
37
+ # to migrations/versions. When using multiple version
38
+ # directories, initial revisions must be specified with --version-path.
39
+ # The path separator used here should be the separator specified by "version_path_separator" below.
40
+ # version_locations = %(here)s/bar:%(here)s/bat:migrations/versions
41
+
42
+ # version path separator; As mentioned above, this is the character used to split
43
+ # version_locations. The default within new alembic.ini files is "os", which uses os.pathsep.
44
+ # If this key is omitted entirely, it falls back to the legacy behavior of splitting on spaces and/or commas.
45
+ # Valid values for version_path_separator are:
46
+ #
47
+ # version_path_separator = :
48
+ # version_path_separator = ;
49
+ # version_path_separator = space
50
+ version_path_separator = os # Use os.pathsep. Default configuration used for new projects.
51
+
52
+ # set to 'true' to search source files recursively
53
+ # in each "version_locations" directory
54
+ # new in Alembic version 1.10
55
+ # recursive_version_locations = false
56
+
57
+ # the output encoding used when revision files
58
+ # are written from script.py.mako
59
+ # output_encoding = utf-8
60
+
61
+ # sqlalchemy.url = REPLACE_WITH_DATABASE_URL
62
+
63
+
64
+ [post_write_hooks]
65
+ # post_write_hooks defines scripts or Python functions that are run
66
+ # on newly generated revision scripts. See the documentation for further
67
+ # detail and examples
68
+
69
+ # format using "black" - use the console_scripts runner, against the "black" entrypoint
70
+ # hooks = black
71
+ # black.type = console_scripts
72
+ # black.entrypoint = black
73
+ # black.options = -l 79 REVISION_SCRIPT_FILENAME
74
+
75
+ # lint with attempts to fix using "ruff" - use the exec runner, execute a binary
76
+ # hooks = ruff
77
+ # ruff.type = exec
78
+ # ruff.executable = %(here)s/.venv/bin/ruff
79
+ # ruff.options = --fix REVISION_SCRIPT_FILENAME
80
+
81
+ # Logging configuration
82
+ [loggers]
83
+ keys = root,sqlalchemy,alembic
84
+
85
+ [handlers]
86
+ keys = console
87
+
88
+ [formatters]
89
+ keys = generic
90
+
91
+ [logger_root]
92
+ level = WARN
93
+ handlers = console
94
+ qualname =
95
+
96
+ [logger_sqlalchemy]
97
+ level = WARN
98
+ handlers =
99
+ qualname = sqlalchemy.engine
100
+
101
+ [logger_alembic]
102
+ level = INFO
103
+ handlers =
104
+ qualname = alembic
105
+
106
+ [handler_console]
107
+ class = StreamHandler
108
+ args = (sys.stderr,)
109
+ level = NOTSET
110
+ formatter = generic
111
+
112
+ [formatter_generic]
113
+ format = %(levelname)-5.5s [%(name)s] %(message)s
114
+ datefmt = %H:%M:%S
backend/open_webui/apps/audio/main.py ADDED
@@ -0,0 +1,713 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ import hashlib
2
+ import json
3
+ import logging
4
+ import os
5
+ import uuid
6
+ from functools import lru_cache
7
+ from pathlib import Path
8
+ from pydub import AudioSegment
9
+ from pydub.silence import split_on_silence
10
+
11
+ import requests
12
+ from open_webui.config import (
13
+ AUDIO_STT_ENGINE,
14
+ AUDIO_STT_MODEL,
15
+ AUDIO_STT_OPENAI_API_BASE_URL,
16
+ AUDIO_STT_OPENAI_API_KEY,
17
+ AUDIO_TTS_API_KEY,
18
+ AUDIO_TTS_ENGINE,
19
+ AUDIO_TTS_MODEL,
20
+ AUDIO_TTS_OPENAI_API_BASE_URL,
21
+ AUDIO_TTS_OPENAI_API_KEY,
22
+ AUDIO_TTS_SPLIT_ON,
23
+ AUDIO_TTS_VOICE,
24
+ AUDIO_TTS_AZURE_SPEECH_REGION,
25
+ AUDIO_TTS_AZURE_SPEECH_OUTPUT_FORMAT,
26
+ CACHE_DIR,
27
+ CORS_ALLOW_ORIGIN,
28
+ WHISPER_MODEL,
29
+ WHISPER_MODEL_AUTO_UPDATE,
30
+ WHISPER_MODEL_DIR,
31
+ AppConfig,
32
+ )
33
+
34
+ from open_webui.constants import ERROR_MESSAGES
35
+ from open_webui.env import (
36
+ ENV,
37
+ SRC_LOG_LEVELS,
38
+ DEVICE_TYPE,
39
+ ENABLE_FORWARD_USER_INFO_HEADERS,
40
+ )
41
+
42
+ from fastapi import Depends, FastAPI, File, HTTPException, Request, UploadFile, status
43
+ from fastapi.middleware.cors import CORSMiddleware
44
+ from fastapi.responses import FileResponse
45
+ from pydantic import BaseModel
46
+ from open_webui.utils.utils import get_admin_user, get_verified_user
47
+
48
+ # Constants
49
+ MAX_FILE_SIZE_MB = 25
50
+ MAX_FILE_SIZE = MAX_FILE_SIZE_MB * 1024 * 1024 # Convert MB to bytes
51
+
52
+
53
+ log = logging.getLogger(__name__)
54
+ log.setLevel(SRC_LOG_LEVELS["AUDIO"])
55
+
56
+ app = FastAPI(
57
+ docs_url="/docs" if ENV == "dev" else None,
58
+ openapi_url="/openapi.json" if ENV == "dev" else None,
59
+ redoc_url=None,
60
+ )
61
+
62
+ app.add_middleware(
63
+ CORSMiddleware,
64
+ allow_origins=CORS_ALLOW_ORIGIN,
65
+ allow_credentials=True,
66
+ allow_methods=["*"],
67
+ allow_headers=["*"],
68
+ )
69
+
70
+ app.state.config = AppConfig()
71
+
72
+ app.state.config.STT_OPENAI_API_BASE_URL = AUDIO_STT_OPENAI_API_BASE_URL
73
+ app.state.config.STT_OPENAI_API_KEY = AUDIO_STT_OPENAI_API_KEY
74
+ app.state.config.STT_ENGINE = AUDIO_STT_ENGINE
75
+ app.state.config.STT_MODEL = AUDIO_STT_MODEL
76
+
77
+ app.state.config.WHISPER_MODEL = WHISPER_MODEL
78
+ app.state.faster_whisper_model = None
79
+
80
+ app.state.config.TTS_OPENAI_API_BASE_URL = AUDIO_TTS_OPENAI_API_BASE_URL
81
+ app.state.config.TTS_OPENAI_API_KEY = AUDIO_TTS_OPENAI_API_KEY
82
+ app.state.config.TTS_ENGINE = AUDIO_TTS_ENGINE
83
+ app.state.config.TTS_MODEL = AUDIO_TTS_MODEL
84
+ app.state.config.TTS_VOICE = AUDIO_TTS_VOICE
85
+ app.state.config.TTS_API_KEY = AUDIO_TTS_API_KEY
86
+ app.state.config.TTS_SPLIT_ON = AUDIO_TTS_SPLIT_ON
87
+
88
+
89
+ app.state.speech_synthesiser = None
90
+ app.state.speech_speaker_embeddings_dataset = None
91
+
92
+ app.state.config.TTS_AZURE_SPEECH_REGION = AUDIO_TTS_AZURE_SPEECH_REGION
93
+ app.state.config.TTS_AZURE_SPEECH_OUTPUT_FORMAT = AUDIO_TTS_AZURE_SPEECH_OUTPUT_FORMAT
94
+
95
+ # setting device type for whisper model
96
+ whisper_device_type = DEVICE_TYPE if DEVICE_TYPE and DEVICE_TYPE == "cuda" else "cpu"
97
+ log.info(f"whisper_device_type: {whisper_device_type}")
98
+
99
+ SPEECH_CACHE_DIR = Path(CACHE_DIR).joinpath("./audio/speech/")
100
+ SPEECH_CACHE_DIR.mkdir(parents=True, exist_ok=True)
101
+
102
+
103
+ def set_faster_whisper_model(model: str, auto_update: bool = False):
104
+ if model and app.state.config.STT_ENGINE == "":
105
+ from faster_whisper import WhisperModel
106
+
107
+ faster_whisper_kwargs = {
108
+ "model_size_or_path": model,
109
+ "device": whisper_device_type,
110
+ "compute_type": "int8",
111
+ "download_root": WHISPER_MODEL_DIR,
112
+ "local_files_only": not auto_update,
113
+ }
114
+
115
+ try:
116
+ app.state.faster_whisper_model = WhisperModel(**faster_whisper_kwargs)
117
+ except Exception:
118
+ log.warning(
119
+ "WhisperModel initialization failed, attempting download with local_files_only=False"
120
+ )
121
+ faster_whisper_kwargs["local_files_only"] = False
122
+ app.state.faster_whisper_model = WhisperModel(**faster_whisper_kwargs)
123
+
124
+ else:
125
+ app.state.faster_whisper_model = None
126
+
127
+
128
+ class TTSConfigForm(BaseModel):
129
+ OPENAI_API_BASE_URL: str
130
+ OPENAI_API_KEY: str
131
+ API_KEY: str
132
+ ENGINE: str
133
+ MODEL: str
134
+ VOICE: str
135
+ SPLIT_ON: str
136
+ AZURE_SPEECH_REGION: str
137
+ AZURE_SPEECH_OUTPUT_FORMAT: str
138
+
139
+
140
+ class STTConfigForm(BaseModel):
141
+ OPENAI_API_BASE_URL: str
142
+ OPENAI_API_KEY: str
143
+ ENGINE: str
144
+ MODEL: str
145
+ WHISPER_MODEL: str
146
+
147
+
148
+ class AudioConfigUpdateForm(BaseModel):
149
+ tts: TTSConfigForm
150
+ stt: STTConfigForm
151
+
152
+
153
+ from pydub import AudioSegment
154
+ from pydub.utils import mediainfo
155
+
156
+
157
+ def is_mp4_audio(file_path):
158
+ """Check if the given file is an MP4 audio file."""
159
+ if not os.path.isfile(file_path):
160
+ print(f"File not found: {file_path}")
161
+ return False
162
+
163
+ info = mediainfo(file_path)
164
+ if (
165
+ info.get("codec_name") == "aac"
166
+ and info.get("codec_type") == "audio"
167
+ and info.get("codec_tag_string") == "mp4a"
168
+ ):
169
+ return True
170
+ return False
171
+
172
+
173
+ def convert_mp4_to_wav(file_path, output_path):
174
+ """Convert MP4 audio file to WAV format."""
175
+ audio = AudioSegment.from_file(file_path, format="mp4")
176
+ audio.export(output_path, format="wav")
177
+ print(f"Converted {file_path} to {output_path}")
178
+
179
+
180
+ @app.get("/config")
181
+ async def get_audio_config(user=Depends(get_admin_user)):
182
+ return {
183
+ "tts": {
184
+ "OPENAI_API_BASE_URL": app.state.config.TTS_OPENAI_API_BASE_URL,
185
+ "OPENAI_API_KEY": app.state.config.TTS_OPENAI_API_KEY,
186
+ "API_KEY": app.state.config.TTS_API_KEY,
187
+ "ENGINE": app.state.config.TTS_ENGINE,
188
+ "MODEL": app.state.config.TTS_MODEL,
189
+ "VOICE": app.state.config.TTS_VOICE,
190
+ "SPLIT_ON": app.state.config.TTS_SPLIT_ON,
191
+ "AZURE_SPEECH_REGION": app.state.config.TTS_AZURE_SPEECH_REGION,
192
+ "AZURE_SPEECH_OUTPUT_FORMAT": app.state.config.TTS_AZURE_SPEECH_OUTPUT_FORMAT,
193
+ },
194
+ "stt": {
195
+ "OPENAI_API_BASE_URL": app.state.config.STT_OPENAI_API_BASE_URL,
196
+ "OPENAI_API_KEY": app.state.config.STT_OPENAI_API_KEY,
197
+ "ENGINE": app.state.config.STT_ENGINE,
198
+ "MODEL": app.state.config.STT_MODEL,
199
+ "WHISPER_MODEL": app.state.config.WHISPER_MODEL,
200
+ },
201
+ }
202
+
203
+
204
+ @app.post("/config/update")
205
+ async def update_audio_config(
206
+ form_data: AudioConfigUpdateForm, user=Depends(get_admin_user)
207
+ ):
208
+ app.state.config.TTS_OPENAI_API_BASE_URL = form_data.tts.OPENAI_API_BASE_URL
209
+ app.state.config.TTS_OPENAI_API_KEY = form_data.tts.OPENAI_API_KEY
210
+ app.state.config.TTS_API_KEY = form_data.tts.API_KEY
211
+ app.state.config.TTS_ENGINE = form_data.tts.ENGINE
212
+ app.state.config.TTS_MODEL = form_data.tts.MODEL
213
+ app.state.config.TTS_VOICE = form_data.tts.VOICE
214
+ app.state.config.TTS_SPLIT_ON = form_data.tts.SPLIT_ON
215
+ app.state.config.TTS_AZURE_SPEECH_REGION = form_data.tts.AZURE_SPEECH_REGION
216
+ app.state.config.TTS_AZURE_SPEECH_OUTPUT_FORMAT = (
217
+ form_data.tts.AZURE_SPEECH_OUTPUT_FORMAT
218
+ )
219
+
220
+ app.state.config.STT_OPENAI_API_BASE_URL = form_data.stt.OPENAI_API_BASE_URL
221
+ app.state.config.STT_OPENAI_API_KEY = form_data.stt.OPENAI_API_KEY
222
+ app.state.config.STT_ENGINE = form_data.stt.ENGINE
223
+ app.state.config.STT_MODEL = form_data.stt.MODEL
224
+ app.state.config.WHISPER_MODEL = form_data.stt.WHISPER_MODEL
225
+ set_faster_whisper_model(form_data.stt.WHISPER_MODEL, WHISPER_MODEL_AUTO_UPDATE)
226
+
227
+ return {
228
+ "tts": {
229
+ "OPENAI_API_BASE_URL": app.state.config.TTS_OPENAI_API_BASE_URL,
230
+ "OPENAI_API_KEY": app.state.config.TTS_OPENAI_API_KEY,
231
+ "API_KEY": app.state.config.TTS_API_KEY,
232
+ "ENGINE": app.state.config.TTS_ENGINE,
233
+ "MODEL": app.state.config.TTS_MODEL,
234
+ "VOICE": app.state.config.TTS_VOICE,
235
+ "SPLIT_ON": app.state.config.TTS_SPLIT_ON,
236
+ "AZURE_SPEECH_REGION": app.state.config.TTS_AZURE_SPEECH_REGION,
237
+ "AZURE_SPEECH_OUTPUT_FORMAT": app.state.config.TTS_AZURE_SPEECH_OUTPUT_FORMAT,
238
+ },
239
+ "stt": {
240
+ "OPENAI_API_BASE_URL": app.state.config.STT_OPENAI_API_BASE_URL,
241
+ "OPENAI_API_KEY": app.state.config.STT_OPENAI_API_KEY,
242
+ "ENGINE": app.state.config.STT_ENGINE,
243
+ "MODEL": app.state.config.STT_MODEL,
244
+ "WHISPER_MODEL": app.state.config.WHISPER_MODEL,
245
+ },
246
+ }
247
+
248
+
249
+ def load_speech_pipeline():
250
+ from transformers import pipeline
251
+ from datasets import load_dataset
252
+
253
+ if app.state.speech_synthesiser is None:
254
+ app.state.speech_synthesiser = pipeline(
255
+ "text-to-speech", "microsoft/speecht5_tts"
256
+ )
257
+
258
+ if app.state.speech_speaker_embeddings_dataset is None:
259
+ app.state.speech_speaker_embeddings_dataset = load_dataset(
260
+ "Matthijs/cmu-arctic-xvectors", split="validation"
261
+ )
262
+
263
+
264
+ @app.post("/speech")
265
+ async def speech(request: Request, user=Depends(get_verified_user)):
266
+ body = await request.body()
267
+ name = hashlib.sha256(body).hexdigest()
268
+
269
+ file_path = SPEECH_CACHE_DIR.joinpath(f"{name}.mp3")
270
+ file_body_path = SPEECH_CACHE_DIR.joinpath(f"{name}.json")
271
+
272
+ # Check if the file already exists in the cache
273
+ if file_path.is_file():
274
+ return FileResponse(file_path)
275
+
276
+ if app.state.config.TTS_ENGINE == "openai":
277
+ headers = {}
278
+ headers["Authorization"] = f"Bearer {app.state.config.TTS_OPENAI_API_KEY}"
279
+ headers["Content-Type"] = "application/json"
280
+
281
+ if ENABLE_FORWARD_USER_INFO_HEADERS:
282
+ headers["X-OpenWebUI-User-Name"] = user.name
283
+ headers["X-OpenWebUI-User-Id"] = user.id
284
+ headers["X-OpenWebUI-User-Email"] = user.email
285
+ headers["X-OpenWebUI-User-Role"] = user.role
286
+
287
+ try:
288
+ body = body.decode("utf-8")
289
+ body = json.loads(body)
290
+ body["model"] = app.state.config.TTS_MODEL
291
+ body = json.dumps(body).encode("utf-8")
292
+ except Exception:
293
+ pass
294
+
295
+ r = None
296
+ try:
297
+ r = requests.post(
298
+ url=f"{app.state.config.TTS_OPENAI_API_BASE_URL}/audio/speech",
299
+ data=body,
300
+ headers=headers,
301
+ stream=True,
302
+ )
303
+
304
+ r.raise_for_status()
305
+
306
+ # Save the streaming content to a file
307
+ with open(file_path, "wb") as f:
308
+ for chunk in r.iter_content(chunk_size=8192):
309
+ f.write(chunk)
310
+
311
+ with open(file_body_path, "w") as f:
312
+ json.dump(json.loads(body.decode("utf-8")), f)
313
+
314
+ # Return the saved file
315
+ return FileResponse(file_path)
316
+
317
+ except Exception as e:
318
+ log.exception(e)
319
+ error_detail = "Open WebUI: Server Connection Error"
320
+ if r is not None:
321
+ try:
322
+ res = r.json()
323
+ if "error" in res:
324
+ error_detail = f"External: {res['error']['message']}"
325
+ except Exception:
326
+ error_detail = f"External: {e}"
327
+
328
+ raise HTTPException(
329
+ status_code=r.status_code if r != None else 500,
330
+ detail=error_detail,
331
+ )
332
+
333
+ elif app.state.config.TTS_ENGINE == "elevenlabs":
334
+ payload = None
335
+ try:
336
+ payload = json.loads(body.decode("utf-8"))
337
+ except Exception as e:
338
+ log.exception(e)
339
+ raise HTTPException(status_code=400, detail="Invalid JSON payload")
340
+
341
+ voice_id = payload.get("voice", "")
342
+
343
+ if voice_id not in get_available_voices():
344
+ raise HTTPException(
345
+ status_code=400,
346
+ detail="Invalid voice id",
347
+ )
348
+
349
+ url = f"https://api.elevenlabs.io/v1/text-to-speech/{voice_id}"
350
+
351
+ headers = {
352
+ "Accept": "audio/mpeg",
353
+ "Content-Type": "application/json",
354
+ "xi-api-key": app.state.config.TTS_API_KEY,
355
+ }
356
+
357
+ data = {
358
+ "text": payload["input"],
359
+ "model_id": app.state.config.TTS_MODEL,
360
+ "voice_settings": {"stability": 0.5, "similarity_boost": 0.5},
361
+ }
362
+
363
+ try:
364
+ r = requests.post(url, json=data, headers=headers)
365
+
366
+ r.raise_for_status()
367
+
368
+ # Save the streaming content to a file
369
+ with open(file_path, "wb") as f:
370
+ for chunk in r.iter_content(chunk_size=8192):
371
+ f.write(chunk)
372
+
373
+ with open(file_body_path, "w") as f:
374
+ json.dump(json.loads(body.decode("utf-8")), f)
375
+
376
+ # Return the saved file
377
+ return FileResponse(file_path)
378
+
379
+ except Exception as e:
380
+ log.exception(e)
381
+ error_detail = "Open WebUI: Server Connection Error"
382
+ if r is not None:
383
+ try:
384
+ res = r.json()
385
+ if "error" in res:
386
+ error_detail = f"External: {res['error']['message']}"
387
+ except Exception:
388
+ error_detail = f"External: {e}"
389
+
390
+ raise HTTPException(
391
+ status_code=r.status_code if r != None else 500,
392
+ detail=error_detail,
393
+ )
394
+
395
+ elif app.state.config.TTS_ENGINE == "azure":
396
+ payload = None
397
+ try:
398
+ payload = json.loads(body.decode("utf-8"))
399
+ except Exception as e:
400
+ log.exception(e)
401
+ raise HTTPException(status_code=400, detail="Invalid JSON payload")
402
+
403
+ region = app.state.config.TTS_AZURE_SPEECH_REGION
404
+ language = app.state.config.TTS_VOICE
405
+ locale = "-".join(app.state.config.TTS_VOICE.split("-")[:1])
406
+ output_format = app.state.config.TTS_AZURE_SPEECH_OUTPUT_FORMAT
407
+ url = f"https://{region}.tts.speech.microsoft.com/cognitiveservices/v1"
408
+
409
+ headers = {
410
+ "Ocp-Apim-Subscription-Key": app.state.config.TTS_API_KEY,
411
+ "Content-Type": "application/ssml+xml",
412
+ "X-Microsoft-OutputFormat": output_format,
413
+ }
414
+
415
+ data = f"""<speak version="1.0" xmlns="http://www.w3.org/2001/10/synthesis" xml:lang="{locale}">
416
+ <voice name="{language}">{payload["input"]}</voice>
417
+ </speak>"""
418
+
419
+ response = requests.post(url, headers=headers, data=data)
420
+
421
+ if response.status_code == 200:
422
+ with open(file_path, "wb") as f:
423
+ f.write(response.content)
424
+ return FileResponse(file_path)
425
+ else:
426
+ log.error(f"Error synthesizing speech - {response.reason}")
427
+ raise HTTPException(
428
+ status_code=500, detail=f"Error synthesizing speech - {response.reason}"
429
+ )
430
+ elif app.state.config.TTS_ENGINE == "transformers":
431
+ payload = None
432
+ try:
433
+ payload = json.loads(body.decode("utf-8"))
434
+ except Exception as e:
435
+ log.exception(e)
436
+ raise HTTPException(status_code=400, detail="Invalid JSON payload")
437
+
438
+ import torch
439
+ import soundfile as sf
440
+
441
+ load_speech_pipeline()
442
+
443
+ embeddings_dataset = app.state.speech_speaker_embeddings_dataset
444
+
445
+ speaker_index = 6799
446
+ try:
447
+ speaker_index = embeddings_dataset["filename"].index(
448
+ app.state.config.TTS_MODEL
449
+ )
450
+ except Exception:
451
+ pass
452
+
453
+ speaker_embedding = torch.tensor(
454
+ embeddings_dataset[speaker_index]["xvector"]
455
+ ).unsqueeze(0)
456
+
457
+ speech = app.state.speech_synthesiser(
458
+ payload["input"],
459
+ forward_params={"speaker_embeddings": speaker_embedding},
460
+ )
461
+
462
+ sf.write(file_path, speech["audio"], samplerate=speech["sampling_rate"])
463
+ with open(file_body_path, "w") as f:
464
+ json.dump(json.loads(body.decode("utf-8")), f)
465
+
466
+ return FileResponse(file_path)
467
+
468
+
469
+ def transcribe(file_path):
470
+ print("transcribe", file_path)
471
+ filename = os.path.basename(file_path)
472
+ file_dir = os.path.dirname(file_path)
473
+ id = filename.split(".")[0]
474
+
475
+ if app.state.config.STT_ENGINE == "":
476
+ if app.state.faster_whisper_model is None:
477
+ set_faster_whisper_model(app.state.config.WHISPER_MODEL)
478
+
479
+ model = app.state.faster_whisper_model
480
+ segments, info = model.transcribe(file_path, beam_size=5)
481
+ log.info(
482
+ "Detected language '%s' with probability %f"
483
+ % (info.language, info.language_probability)
484
+ )
485
+
486
+ transcript = "".join([segment.text for segment in list(segments)])
487
+ data = {"text": transcript.strip()}
488
+
489
+ # save the transcript to a json file
490
+ transcript_file = f"{file_dir}/{id}.json"
491
+ with open(transcript_file, "w") as f:
492
+ json.dump(data, f)
493
+
494
+ log.debug(data)
495
+ return data
496
+ elif app.state.config.STT_ENGINE == "openai":
497
+ if is_mp4_audio(file_path):
498
+ print("is_mp4_audio")
499
+ os.rename(file_path, file_path.replace(".wav", ".mp4"))
500
+ # Convert MP4 audio file to WAV format
501
+ convert_mp4_to_wav(file_path.replace(".wav", ".mp4"), file_path)
502
+
503
+ headers = {"Authorization": f"Bearer {app.state.config.STT_OPENAI_API_KEY}"}
504
+
505
+ files = {"file": (filename, open(file_path, "rb"))}
506
+ data = {"model": app.state.config.STT_MODEL}
507
+
508
+ log.debug(files, data)
509
+
510
+ r = None
511
+ try:
512
+ r = requests.post(
513
+ url=f"{app.state.config.STT_OPENAI_API_BASE_URL}/audio/transcriptions",
514
+ headers=headers,
515
+ files=files,
516
+ data=data,
517
+ )
518
+
519
+ r.raise_for_status()
520
+
521
+ data = r.json()
522
+
523
+ # save the transcript to a json file
524
+ transcript_file = f"{file_dir}/{id}.json"
525
+ with open(transcript_file, "w") as f:
526
+ json.dump(data, f)
527
+
528
+ print(data)
529
+ return data
530
+ except Exception as e:
531
+ log.exception(e)
532
+ error_detail = "Open WebUI: Server Connection Error"
533
+ if r is not None:
534
+ try:
535
+ res = r.json()
536
+ if "error" in res:
537
+ error_detail = f"External: {res['error']['message']}"
538
+ except Exception:
539
+ error_detail = f"External: {e}"
540
+
541
+ raise Exception(error_detail)
542
+
543
+
544
+ @app.post("/transcriptions")
545
+ def transcription(
546
+ file: UploadFile = File(...),
547
+ user=Depends(get_verified_user),
548
+ ):
549
+ log.info(f"file.content_type: {file.content_type}")
550
+
551
+ if file.content_type not in ["audio/mpeg", "audio/wav", "audio/ogg", "audio/x-m4a"]:
552
+ raise HTTPException(
553
+ status_code=status.HTTP_400_BAD_REQUEST,
554
+ detail=ERROR_MESSAGES.FILE_NOT_SUPPORTED,
555
+ )
556
+
557
+ try:
558
+ ext = file.filename.split(".")[-1]
559
+ id = uuid.uuid4()
560
+
561
+ filename = f"{id}.{ext}"
562
+ contents = file.file.read()
563
+
564
+ file_dir = f"{CACHE_DIR}/audio/transcriptions"
565
+ os.makedirs(file_dir, exist_ok=True)
566
+ file_path = f"{file_dir}/{filename}"
567
+
568
+ with open(file_path, "wb") as f:
569
+ f.write(contents)
570
+
571
+ try:
572
+ if os.path.getsize(file_path) > MAX_FILE_SIZE: # file is bigger than 25MB
573
+ log.debug(f"File size is larger than {MAX_FILE_SIZE_MB}MB")
574
+ audio = AudioSegment.from_file(file_path)
575
+ audio = audio.set_frame_rate(16000).set_channels(1) # Compress audio
576
+ compressed_path = f"{file_dir}/{id}_compressed.opus"
577
+ audio.export(compressed_path, format="opus", bitrate="32k")
578
+ log.debug(f"Compressed audio to {compressed_path}")
579
+ file_path = compressed_path
580
+
581
+ if (
582
+ os.path.getsize(file_path) > MAX_FILE_SIZE
583
+ ): # Still larger than 25MB after compression
584
+ log.debug(
585
+ f"Compressed file size is still larger than {MAX_FILE_SIZE_MB}MB: {os.path.getsize(file_path)}"
586
+ )
587
+ raise HTTPException(
588
+ status_code=status.HTTP_400_BAD_REQUEST,
589
+ detail=ERROR_MESSAGES.FILE_TOO_LARGE(
590
+ size=f"{MAX_FILE_SIZE_MB}MB"
591
+ ),
592
+ )
593
+
594
+ data = transcribe(file_path)
595
+ else:
596
+ data = transcribe(file_path)
597
+
598
+ file_path = file_path.split("/")[-1]
599
+ return {**data, "filename": file_path}
600
+ except Exception as e:
601
+ log.exception(e)
602
+ raise HTTPException(
603
+ status_code=status.HTTP_400_BAD_REQUEST,
604
+ detail=ERROR_MESSAGES.DEFAULT(e),
605
+ )
606
+
607
+ except Exception as e:
608
+ log.exception(e)
609
+
610
+ raise HTTPException(
611
+ status_code=status.HTTP_400_BAD_REQUEST,
612
+ detail=ERROR_MESSAGES.DEFAULT(e),
613
+ )
614
+
615
+
616
+ def get_available_models() -> list[dict]:
617
+ if app.state.config.TTS_ENGINE == "openai":
618
+ return [{"id": "tts-1"}, {"id": "tts-1-hd"}]
619
+ elif app.state.config.TTS_ENGINE == "elevenlabs":
620
+ headers = {
621
+ "xi-api-key": app.state.config.TTS_API_KEY,
622
+ "Content-Type": "application/json",
623
+ }
624
+
625
+ try:
626
+ response = requests.get(
627
+ "https://api.elevenlabs.io/v1/models", headers=headers, timeout=5
628
+ )
629
+ response.raise_for_status()
630
+ models = response.json()
631
+ return [
632
+ {"name": model["name"], "id": model["model_id"]} for model in models
633
+ ]
634
+ except requests.RequestException as e:
635
+ log.error(f"Error fetching voices: {str(e)}")
636
+ return []
637
+
638
+
639
+ @app.get("/models")
640
+ async def get_models(user=Depends(get_verified_user)):
641
+ return {"models": get_available_models()}
642
+
643
+
644
+ def get_available_voices() -> dict:
645
+ """Returns {voice_id: voice_name} dict"""
646
+ ret = {}
647
+ if app.state.config.TTS_ENGINE == "openai":
648
+ ret = {
649
+ "alloy": "alloy",
650
+ "echo": "echo",
651
+ "fable": "fable",
652
+ "onyx": "onyx",
653
+ "nova": "nova",
654
+ "shimmer": "shimmer",
655
+ }
656
+ elif app.state.config.TTS_ENGINE == "elevenlabs":
657
+ try:
658
+ ret = get_elevenlabs_voices()
659
+ except Exception:
660
+ # Avoided @lru_cache with exception
661
+ pass
662
+ elif app.state.config.TTS_ENGINE == "azure":
663
+ try:
664
+ region = app.state.config.TTS_AZURE_SPEECH_REGION
665
+ url = f"https://{region}.tts.speech.microsoft.com/cognitiveservices/voices/list"
666
+ headers = {"Ocp-Apim-Subscription-Key": app.state.config.TTS_API_KEY}
667
+
668
+ response = requests.get(url, headers=headers)
669
+ response.raise_for_status()
670
+ voices = response.json()
671
+ for voice in voices:
672
+ ret[voice["ShortName"]] = (
673
+ f"{voice['DisplayName']} ({voice['ShortName']})"
674
+ )
675
+ except requests.RequestException as e:
676
+ log.error(f"Error fetching voices: {str(e)}")
677
+
678
+ return ret
679
+
680
+
681
+ @lru_cache
682
+ def get_elevenlabs_voices() -> dict:
683
+ """
684
+ Note, set the following in your .env file to use Elevenlabs:
685
+ AUDIO_TTS_ENGINE=elevenlabs
686
+ AUDIO_TTS_API_KEY=sk_... # Your Elevenlabs API key
687
+ AUDIO_TTS_VOICE=EXAVITQu4vr4xnSDxMaL # From https://api.elevenlabs.io/v1/voices
688
+ AUDIO_TTS_MODEL=eleven_multilingual_v2
689
+ """
690
+ headers = {
691
+ "xi-api-key": app.state.config.TTS_API_KEY,
692
+ "Content-Type": "application/json",
693
+ }
694
+ try:
695
+ # TODO: Add retries
696
+ response = requests.get("https://api.elevenlabs.io/v1/voices", headers=headers)
697
+ response.raise_for_status()
698
+ voices_data = response.json()
699
+
700
+ voices = {}
701
+ for voice in voices_data.get("voices", []):
702
+ voices[voice["voice_id"]] = voice["name"]
703
+ except requests.RequestException as e:
704
+ # Avoid @lru_cache with exception
705
+ log.error(f"Error fetching voices: {str(e)}")
706
+ raise RuntimeError(f"Error fetching voices: {str(e)}")
707
+
708
+ return voices
709
+
710
+
711
+ @app.get("/voices")
712
+ async def get_voices(user=Depends(get_verified_user)):
713
+ return {"voices": [{"id": k, "name": v} for k, v in get_available_voices().items()]}
backend/open_webui/apps/images/main.py ADDED
@@ -0,0 +1,609 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ import asyncio
2
+ import base64
3
+ import json
4
+ import logging
5
+ import mimetypes
6
+ import re
7
+ import uuid
8
+ from pathlib import Path
9
+ from typing import Optional
10
+
11
+ import requests
12
+ from open_webui.apps.images.utils.comfyui import (
13
+ ComfyUIGenerateImageForm,
14
+ ComfyUIWorkflow,
15
+ comfyui_generate_image,
16
+ )
17
+ from open_webui.config import (
18
+ AUTOMATIC1111_API_AUTH,
19
+ AUTOMATIC1111_BASE_URL,
20
+ AUTOMATIC1111_CFG_SCALE,
21
+ AUTOMATIC1111_SAMPLER,
22
+ AUTOMATIC1111_SCHEDULER,
23
+ CACHE_DIR,
24
+ COMFYUI_BASE_URL,
25
+ COMFYUI_WORKFLOW,
26
+ COMFYUI_WORKFLOW_NODES,
27
+ CORS_ALLOW_ORIGIN,
28
+ ENABLE_IMAGE_GENERATION,
29
+ IMAGE_GENERATION_ENGINE,
30
+ IMAGE_GENERATION_MODEL,
31
+ IMAGE_SIZE,
32
+ IMAGE_STEPS,
33
+ IMAGES_OPENAI_API_BASE_URL,
34
+ IMAGES_OPENAI_API_KEY,
35
+ AppConfig,
36
+ )
37
+ from open_webui.constants import ERROR_MESSAGES
38
+ from open_webui.env import ENV, SRC_LOG_LEVELS, ENABLE_FORWARD_USER_INFO_HEADERS
39
+
40
+ from fastapi import Depends, FastAPI, HTTPException, Request
41
+ from fastapi.middleware.cors import CORSMiddleware
42
+ from pydantic import BaseModel
43
+ from open_webui.utils.utils import get_admin_user, get_verified_user
44
+
45
+ log = logging.getLogger(__name__)
46
+ log.setLevel(SRC_LOG_LEVELS["IMAGES"])
47
+
48
+ IMAGE_CACHE_DIR = Path(CACHE_DIR).joinpath("./image/generations/")
49
+ IMAGE_CACHE_DIR.mkdir(parents=True, exist_ok=True)
50
+
51
+ app = FastAPI(
52
+ docs_url="/docs" if ENV == "dev" else None,
53
+ openapi_url="/openapi.json" if ENV == "dev" else None,
54
+ redoc_url=None,
55
+ )
56
+
57
+ app.add_middleware(
58
+ CORSMiddleware,
59
+ allow_origins=CORS_ALLOW_ORIGIN,
60
+ allow_credentials=True,
61
+ allow_methods=["*"],
62
+ allow_headers=["*"],
63
+ )
64
+
65
+ app.state.config = AppConfig()
66
+
67
+ app.state.config.ENGINE = IMAGE_GENERATION_ENGINE
68
+ app.state.config.ENABLED = ENABLE_IMAGE_GENERATION
69
+
70
+ app.state.config.OPENAI_API_BASE_URL = IMAGES_OPENAI_API_BASE_URL
71
+ app.state.config.OPENAI_API_KEY = IMAGES_OPENAI_API_KEY
72
+
73
+ app.state.config.MODEL = IMAGE_GENERATION_MODEL
74
+
75
+ app.state.config.AUTOMATIC1111_BASE_URL = AUTOMATIC1111_BASE_URL
76
+ app.state.config.AUTOMATIC1111_API_AUTH = AUTOMATIC1111_API_AUTH
77
+ app.state.config.AUTOMATIC1111_CFG_SCALE = AUTOMATIC1111_CFG_SCALE
78
+ app.state.config.AUTOMATIC1111_SAMPLER = AUTOMATIC1111_SAMPLER
79
+ app.state.config.AUTOMATIC1111_SCHEDULER = AUTOMATIC1111_SCHEDULER
80
+ app.state.config.COMFYUI_BASE_URL = COMFYUI_BASE_URL
81
+ app.state.config.COMFYUI_WORKFLOW = COMFYUI_WORKFLOW
82
+ app.state.config.COMFYUI_WORKFLOW_NODES = COMFYUI_WORKFLOW_NODES
83
+
84
+ app.state.config.IMAGE_SIZE = IMAGE_SIZE
85
+ app.state.config.IMAGE_STEPS = IMAGE_STEPS
86
+
87
+
88
+ @app.get("/config")
89
+ async def get_config(request: Request, user=Depends(get_admin_user)):
90
+ return {
91
+ "enabled": app.state.config.ENABLED,
92
+ "engine": app.state.config.ENGINE,
93
+ "openai": {
94
+ "OPENAI_API_BASE_URL": app.state.config.OPENAI_API_BASE_URL,
95
+ "OPENAI_API_KEY": app.state.config.OPENAI_API_KEY,
96
+ },
97
+ "automatic1111": {
98
+ "AUTOMATIC1111_BASE_URL": app.state.config.AUTOMATIC1111_BASE_URL,
99
+ "AUTOMATIC1111_API_AUTH": app.state.config.AUTOMATIC1111_API_AUTH,
100
+ "AUTOMATIC1111_CFG_SCALE": app.state.config.AUTOMATIC1111_CFG_SCALE,
101
+ "AUTOMATIC1111_SAMPLER": app.state.config.AUTOMATIC1111_SAMPLER,
102
+ "AUTOMATIC1111_SCHEDULER": app.state.config.AUTOMATIC1111_SCHEDULER,
103
+ },
104
+ "comfyui": {
105
+ "COMFYUI_BASE_URL": app.state.config.COMFYUI_BASE_URL,
106
+ "COMFYUI_WORKFLOW": app.state.config.COMFYUI_WORKFLOW,
107
+ "COMFYUI_WORKFLOW_NODES": app.state.config.COMFYUI_WORKFLOW_NODES,
108
+ },
109
+ }
110
+
111
+
112
+ class OpenAIConfigForm(BaseModel):
113
+ OPENAI_API_BASE_URL: str
114
+ OPENAI_API_KEY: str
115
+
116
+
117
+ class Automatic1111ConfigForm(BaseModel):
118
+ AUTOMATIC1111_BASE_URL: str
119
+ AUTOMATIC1111_API_AUTH: str
120
+ AUTOMATIC1111_CFG_SCALE: Optional[str]
121
+ AUTOMATIC1111_SAMPLER: Optional[str]
122
+ AUTOMATIC1111_SCHEDULER: Optional[str]
123
+
124
+
125
+ class ComfyUIConfigForm(BaseModel):
126
+ COMFYUI_BASE_URL: str
127
+ COMFYUI_WORKFLOW: str
128
+ COMFYUI_WORKFLOW_NODES: list[dict]
129
+
130
+
131
+ class ConfigForm(BaseModel):
132
+ enabled: bool
133
+ engine: str
134
+ openai: OpenAIConfigForm
135
+ automatic1111: Automatic1111ConfigForm
136
+ comfyui: ComfyUIConfigForm
137
+
138
+
139
+ @app.post("/config/update")
140
+ async def update_config(form_data: ConfigForm, user=Depends(get_admin_user)):
141
+ app.state.config.ENGINE = form_data.engine
142
+ app.state.config.ENABLED = form_data.enabled
143
+
144
+ app.state.config.OPENAI_API_BASE_URL = form_data.openai.OPENAI_API_BASE_URL
145
+ app.state.config.OPENAI_API_KEY = form_data.openai.OPENAI_API_KEY
146
+
147
+ app.state.config.AUTOMATIC1111_BASE_URL = (
148
+ form_data.automatic1111.AUTOMATIC1111_BASE_URL
149
+ )
150
+ app.state.config.AUTOMATIC1111_API_AUTH = (
151
+ form_data.automatic1111.AUTOMATIC1111_API_AUTH
152
+ )
153
+
154
+ app.state.config.AUTOMATIC1111_CFG_SCALE = (
155
+ float(form_data.automatic1111.AUTOMATIC1111_CFG_SCALE)
156
+ if form_data.automatic1111.AUTOMATIC1111_CFG_SCALE
157
+ else None
158
+ )
159
+ app.state.config.AUTOMATIC1111_SAMPLER = (
160
+ form_data.automatic1111.AUTOMATIC1111_SAMPLER
161
+ if form_data.automatic1111.AUTOMATIC1111_SAMPLER
162
+ else None
163
+ )
164
+ app.state.config.AUTOMATIC1111_SCHEDULER = (
165
+ form_data.automatic1111.AUTOMATIC1111_SCHEDULER
166
+ if form_data.automatic1111.AUTOMATIC1111_SCHEDULER
167
+ else None
168
+ )
169
+
170
+ app.state.config.COMFYUI_BASE_URL = form_data.comfyui.COMFYUI_BASE_URL.strip("/")
171
+ app.state.config.COMFYUI_WORKFLOW = form_data.comfyui.COMFYUI_WORKFLOW
172
+ app.state.config.COMFYUI_WORKFLOW_NODES = form_data.comfyui.COMFYUI_WORKFLOW_NODES
173
+
174
+ return {
175
+ "enabled": app.state.config.ENABLED,
176
+ "engine": app.state.config.ENGINE,
177
+ "openai": {
178
+ "OPENAI_API_BASE_URL": app.state.config.OPENAI_API_BASE_URL,
179
+ "OPENAI_API_KEY": app.state.config.OPENAI_API_KEY,
180
+ },
181
+ "automatic1111": {
182
+ "AUTOMATIC1111_BASE_URL": app.state.config.AUTOMATIC1111_BASE_URL,
183
+ "AUTOMATIC1111_API_AUTH": app.state.config.AUTOMATIC1111_API_AUTH,
184
+ "AUTOMATIC1111_CFG_SCALE": app.state.config.AUTOMATIC1111_CFG_SCALE,
185
+ "AUTOMATIC1111_SAMPLER": app.state.config.AUTOMATIC1111_SAMPLER,
186
+ "AUTOMATIC1111_SCHEDULER": app.state.config.AUTOMATIC1111_SCHEDULER,
187
+ },
188
+ "comfyui": {
189
+ "COMFYUI_BASE_URL": app.state.config.COMFYUI_BASE_URL,
190
+ "COMFYUI_WORKFLOW": app.state.config.COMFYUI_WORKFLOW,
191
+ "COMFYUI_WORKFLOW_NODES": app.state.config.COMFYUI_WORKFLOW_NODES,
192
+ },
193
+ }
194
+
195
+
196
+ def get_automatic1111_api_auth():
197
+ if app.state.config.AUTOMATIC1111_API_AUTH is None:
198
+ return ""
199
+ else:
200
+ auth1111_byte_string = app.state.config.AUTOMATIC1111_API_AUTH.encode("utf-8")
201
+ auth1111_base64_encoded_bytes = base64.b64encode(auth1111_byte_string)
202
+ auth1111_base64_encoded_string = auth1111_base64_encoded_bytes.decode("utf-8")
203
+ return f"Basic {auth1111_base64_encoded_string}"
204
+
205
+
206
+ @app.get("/config/url/verify")
207
+ async def verify_url(user=Depends(get_admin_user)):
208
+ if app.state.config.ENGINE == "automatic1111":
209
+ try:
210
+ r = requests.get(
211
+ url=f"{app.state.config.AUTOMATIC1111_BASE_URL}/sdapi/v1/options",
212
+ headers={"authorization": get_automatic1111_api_auth()},
213
+ )
214
+ r.raise_for_status()
215
+ return True
216
+ except Exception:
217
+ app.state.config.ENABLED = False
218
+ raise HTTPException(status_code=400, detail=ERROR_MESSAGES.INVALID_URL)
219
+ elif app.state.config.ENGINE == "comfyui":
220
+ try:
221
+ r = requests.get(url=f"{app.state.config.COMFYUI_BASE_URL}/object_info")
222
+ r.raise_for_status()
223
+ return True
224
+ except Exception:
225
+ app.state.config.ENABLED = False
226
+ raise HTTPException(status_code=400, detail=ERROR_MESSAGES.INVALID_URL)
227
+ else:
228
+ return True
229
+
230
+
231
+ def set_image_model(model: str):
232
+ log.info(f"Setting image model to {model}")
233
+ app.state.config.MODEL = model
234
+ if app.state.config.ENGINE in ["", "automatic1111"]:
235
+ api_auth = get_automatic1111_api_auth()
236
+ r = requests.get(
237
+ url=f"{app.state.config.AUTOMATIC1111_BASE_URL}/sdapi/v1/options",
238
+ headers={"authorization": api_auth},
239
+ )
240
+ options = r.json()
241
+ if model != options["sd_model_checkpoint"]:
242
+ options["sd_model_checkpoint"] = model
243
+ r = requests.post(
244
+ url=f"{app.state.config.AUTOMATIC1111_BASE_URL}/sdapi/v1/options",
245
+ json=options,
246
+ headers={"authorization": api_auth},
247
+ )
248
+ return app.state.config.MODEL
249
+
250
+
251
+ def get_image_model():
252
+ if app.state.config.ENGINE == "openai":
253
+ return app.state.config.MODEL if app.state.config.MODEL else "dall-e-2"
254
+ elif app.state.config.ENGINE == "comfyui":
255
+ return app.state.config.MODEL if app.state.config.MODEL else ""
256
+ elif app.state.config.ENGINE == "automatic1111" or app.state.config.ENGINE == "":
257
+ try:
258
+ r = requests.get(
259
+ url=f"{app.state.config.AUTOMATIC1111_BASE_URL}/sdapi/v1/options",
260
+ headers={"authorization": get_automatic1111_api_auth()},
261
+ )
262
+ options = r.json()
263
+ return options["sd_model_checkpoint"]
264
+ except Exception as e:
265
+ app.state.config.ENABLED = False
266
+ raise HTTPException(status_code=400, detail=ERROR_MESSAGES.DEFAULT(e))
267
+
268
+
269
+ class ImageConfigForm(BaseModel):
270
+ MODEL: str
271
+ IMAGE_SIZE: str
272
+ IMAGE_STEPS: int
273
+
274
+
275
+ @app.get("/image/config")
276
+ async def get_image_config(user=Depends(get_admin_user)):
277
+ return {
278
+ "MODEL": app.state.config.MODEL,
279
+ "IMAGE_SIZE": app.state.config.IMAGE_SIZE,
280
+ "IMAGE_STEPS": app.state.config.IMAGE_STEPS,
281
+ }
282
+
283
+
284
+ @app.post("/image/config/update")
285
+ async def update_image_config(form_data: ImageConfigForm, user=Depends(get_admin_user)):
286
+
287
+ set_image_model(form_data.MODEL)
288
+
289
+ pattern = r"^\d+x\d+$"
290
+ if re.match(pattern, form_data.IMAGE_SIZE):
291
+ app.state.config.IMAGE_SIZE = form_data.IMAGE_SIZE
292
+ else:
293
+ raise HTTPException(
294
+ status_code=400,
295
+ detail=ERROR_MESSAGES.INCORRECT_FORMAT(" (e.g., 512x512)."),
296
+ )
297
+
298
+ if form_data.IMAGE_STEPS >= 0:
299
+ app.state.config.IMAGE_STEPS = form_data.IMAGE_STEPS
300
+ else:
301
+ raise HTTPException(
302
+ status_code=400,
303
+ detail=ERROR_MESSAGES.INCORRECT_FORMAT(" (e.g., 50)."),
304
+ )
305
+
306
+ return {
307
+ "MODEL": app.state.config.MODEL,
308
+ "IMAGE_SIZE": app.state.config.IMAGE_SIZE,
309
+ "IMAGE_STEPS": app.state.config.IMAGE_STEPS,
310
+ }
311
+
312
+
313
+ @app.get("/models")
314
+ def get_models(user=Depends(get_verified_user)):
315
+ try:
316
+ if app.state.config.ENGINE == "openai":
317
+ return [
318
+ {"id": "dall-e-2", "name": "DALL·E 2"},
319
+ {"id": "dall-e-3", "name": "DALL·E 3"},
320
+ ]
321
+ elif app.state.config.ENGINE == "comfyui":
322
+ # TODO - get models from comfyui
323
+ r = requests.get(url=f"{app.state.config.COMFYUI_BASE_URL}/object_info")
324
+ info = r.json()
325
+
326
+ workflow = json.loads(app.state.config.COMFYUI_WORKFLOW)
327
+ model_node_id = None
328
+
329
+ for node in app.state.config.COMFYUI_WORKFLOW_NODES:
330
+ if node["type"] == "model":
331
+ if node["node_ids"]:
332
+ model_node_id = node["node_ids"][0]
333
+ break
334
+
335
+ if model_node_id:
336
+ model_list_key = None
337
+
338
+ print(workflow[model_node_id]["class_type"])
339
+ for key in info[workflow[model_node_id]["class_type"]]["input"][
340
+ "required"
341
+ ]:
342
+ if "_name" in key:
343
+ model_list_key = key
344
+ break
345
+
346
+ if model_list_key:
347
+ return list(
348
+ map(
349
+ lambda model: {"id": model, "name": model},
350
+ info[workflow[model_node_id]["class_type"]]["input"][
351
+ "required"
352
+ ][model_list_key][0],
353
+ )
354
+ )
355
+ else:
356
+ return list(
357
+ map(
358
+ lambda model: {"id": model, "name": model},
359
+ info["CheckpointLoaderSimple"]["input"]["required"][
360
+ "ckpt_name"
361
+ ][0],
362
+ )
363
+ )
364
+ elif (
365
+ app.state.config.ENGINE == "automatic1111" or app.state.config.ENGINE == ""
366
+ ):
367
+ r = requests.get(
368
+ url=f"{app.state.config.AUTOMATIC1111_BASE_URL}/sdapi/v1/sd-models",
369
+ headers={"authorization": get_automatic1111_api_auth()},
370
+ )
371
+ models = r.json()
372
+ return list(
373
+ map(
374
+ lambda model: {"id": model["title"], "name": model["model_name"]},
375
+ models,
376
+ )
377
+ )
378
+ except Exception as e:
379
+ app.state.config.ENABLED = False
380
+ raise HTTPException(status_code=400, detail=ERROR_MESSAGES.DEFAULT(e))
381
+
382
+
383
+ class GenerateImageForm(BaseModel):
384
+ model: Optional[str] = None
385
+ prompt: str
386
+ size: Optional[str] = None
387
+ n: int = 1
388
+ negative_prompt: Optional[str] = None
389
+
390
+
391
+ def save_b64_image(b64_str):
392
+ try:
393
+ image_id = str(uuid.uuid4())
394
+
395
+ if "," in b64_str:
396
+ header, encoded = b64_str.split(",", 1)
397
+ mime_type = header.split(";")[0]
398
+
399
+ img_data = base64.b64decode(encoded)
400
+ image_format = mimetypes.guess_extension(mime_type)
401
+
402
+ image_filename = f"{image_id}{image_format}"
403
+ file_path = IMAGE_CACHE_DIR / f"{image_filename}"
404
+ with open(file_path, "wb") as f:
405
+ f.write(img_data)
406
+ return image_filename
407
+ else:
408
+ image_filename = f"{image_id}.png"
409
+ file_path = IMAGE_CACHE_DIR.joinpath(image_filename)
410
+
411
+ img_data = base64.b64decode(b64_str)
412
+
413
+ # Write the image data to a file
414
+ with open(file_path, "wb") as f:
415
+ f.write(img_data)
416
+ return image_filename
417
+
418
+ except Exception as e:
419
+ log.exception(f"Error saving image: {e}")
420
+ return None
421
+
422
+
423
+ def save_url_image(url):
424
+ image_id = str(uuid.uuid4())
425
+ try:
426
+ r = requests.get(url)
427
+ r.raise_for_status()
428
+ if r.headers["content-type"].split("/")[0] == "image":
429
+ mime_type = r.headers["content-type"]
430
+ image_format = mimetypes.guess_extension(mime_type)
431
+
432
+ if not image_format:
433
+ raise ValueError("Could not determine image type from MIME type")
434
+
435
+ image_filename = f"{image_id}{image_format}"
436
+
437
+ file_path = IMAGE_CACHE_DIR.joinpath(f"{image_filename}")
438
+ with open(file_path, "wb") as image_file:
439
+ for chunk in r.iter_content(chunk_size=8192):
440
+ image_file.write(chunk)
441
+ return image_filename
442
+ else:
443
+ log.error("Url does not point to an image.")
444
+ return None
445
+
446
+ except Exception as e:
447
+ log.exception(f"Error saving image: {e}")
448
+ return None
449
+
450
+
451
+ @app.post("/generations")
452
+ async def image_generations(
453
+ form_data: GenerateImageForm,
454
+ user=Depends(get_verified_user),
455
+ ):
456
+ width, height = tuple(map(int, app.state.config.IMAGE_SIZE.split("x")))
457
+
458
+ r = None
459
+ try:
460
+ if app.state.config.ENGINE == "openai":
461
+ headers = {}
462
+ headers["Authorization"] = f"Bearer {app.state.config.OPENAI_API_KEY}"
463
+ headers["Content-Type"] = "application/json"
464
+
465
+ if ENABLE_FORWARD_USER_INFO_HEADERS:
466
+ headers["X-OpenWebUI-User-Name"] = user.name
467
+ headers["X-OpenWebUI-User-Id"] = user.id
468
+ headers["X-OpenWebUI-User-Email"] = user.email
469
+ headers["X-OpenWebUI-User-Role"] = user.role
470
+
471
+ data = {
472
+ "model": (
473
+ app.state.config.MODEL
474
+ if app.state.config.MODEL != ""
475
+ else "dall-e-2"
476
+ ),
477
+ "prompt": form_data.prompt,
478
+ "n": form_data.n,
479
+ "size": (
480
+ form_data.size if form_data.size else app.state.config.IMAGE_SIZE
481
+ ),
482
+ "response_format": "b64_json",
483
+ }
484
+
485
+ # Use asyncio.to_thread for the requests.post call
486
+ r = await asyncio.to_thread(
487
+ requests.post,
488
+ url=f"{app.state.config.OPENAI_API_BASE_URL}/images/generations",
489
+ json=data,
490
+ headers=headers,
491
+ )
492
+
493
+ r.raise_for_status()
494
+ res = r.json()
495
+
496
+ images = []
497
+
498
+ for image in res["data"]:
499
+ image_filename = save_b64_image(image["b64_json"])
500
+ images.append({"url": f"/cache/image/generations/{image_filename}"})
501
+ file_body_path = IMAGE_CACHE_DIR.joinpath(f"{image_filename}.json")
502
+
503
+ with open(file_body_path, "w") as f:
504
+ json.dump(data, f)
505
+
506
+ return images
507
+
508
+ elif app.state.config.ENGINE == "comfyui":
509
+ data = {
510
+ "prompt": form_data.prompt,
511
+ "width": width,
512
+ "height": height,
513
+ "n": form_data.n,
514
+ }
515
+
516
+ if app.state.config.IMAGE_STEPS is not None:
517
+ data["steps"] = app.state.config.IMAGE_STEPS
518
+
519
+ if form_data.negative_prompt is not None:
520
+ data["negative_prompt"] = form_data.negative_prompt
521
+
522
+ form_data = ComfyUIGenerateImageForm(
523
+ **{
524
+ "workflow": ComfyUIWorkflow(
525
+ **{
526
+ "workflow": app.state.config.COMFYUI_WORKFLOW,
527
+ "nodes": app.state.config.COMFYUI_WORKFLOW_NODES,
528
+ }
529
+ ),
530
+ **data,
531
+ }
532
+ )
533
+ res = await comfyui_generate_image(
534
+ app.state.config.MODEL,
535
+ form_data,
536
+ user.id,
537
+ app.state.config.COMFYUI_BASE_URL,
538
+ )
539
+ log.debug(f"res: {res}")
540
+
541
+ images = []
542
+
543
+ for image in res["data"]:
544
+ image_filename = save_url_image(image["url"])
545
+ images.append({"url": f"/cache/image/generations/{image_filename}"})
546
+ file_body_path = IMAGE_CACHE_DIR.joinpath(f"{image_filename}.json")
547
+
548
+ with open(file_body_path, "w") as f:
549
+ json.dump(form_data.model_dump(exclude_none=True), f)
550
+
551
+ log.debug(f"images: {images}")
552
+ return images
553
+ elif (
554
+ app.state.config.ENGINE == "automatic1111" or app.state.config.ENGINE == ""
555
+ ):
556
+ if form_data.model:
557
+ set_image_model(form_data.model)
558
+
559
+ data = {
560
+ "prompt": form_data.prompt,
561
+ "batch_size": form_data.n,
562
+ "width": width,
563
+ "height": height,
564
+ }
565
+
566
+ if app.state.config.IMAGE_STEPS is not None:
567
+ data["steps"] = app.state.config.IMAGE_STEPS
568
+
569
+ if form_data.negative_prompt is not None:
570
+ data["negative_prompt"] = form_data.negative_prompt
571
+
572
+ if app.state.config.AUTOMATIC1111_CFG_SCALE:
573
+ data["cfg_scale"] = app.state.config.AUTOMATIC1111_CFG_SCALE
574
+
575
+ if app.state.config.AUTOMATIC1111_SAMPLER:
576
+ data["sampler_name"] = app.state.config.AUTOMATIC1111_SAMPLER
577
+
578
+ if app.state.config.AUTOMATIC1111_SCHEDULER:
579
+ data["scheduler"] = app.state.config.AUTOMATIC1111_SCHEDULER
580
+
581
+ # Use asyncio.to_thread for the requests.post call
582
+ r = await asyncio.to_thread(
583
+ requests.post,
584
+ url=f"{app.state.config.AUTOMATIC1111_BASE_URL}/sdapi/v1/txt2img",
585
+ json=data,
586
+ headers={"authorization": get_automatic1111_api_auth()},
587
+ )
588
+
589
+ res = r.json()
590
+ log.debug(f"res: {res}")
591
+
592
+ images = []
593
+
594
+ for image in res["images"]:
595
+ image_filename = save_b64_image(image)
596
+ images.append({"url": f"/cache/image/generations/{image_filename}"})
597
+ file_body_path = IMAGE_CACHE_DIR.joinpath(f"{image_filename}.json")
598
+
599
+ with open(file_body_path, "w") as f:
600
+ json.dump({**data, "info": res["info"]}, f)
601
+
602
+ return images
603
+ except Exception as e:
604
+ error = e
605
+ if r != None:
606
+ data = r.json()
607
+ if "error" in data:
608
+ error = data["error"]["message"]
609
+ raise HTTPException(status_code=400, detail=ERROR_MESSAGES.DEFAULT(error))
backend/open_webui/apps/images/utils/comfyui.py ADDED
@@ -0,0 +1,186 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ import asyncio
2
+ import json
3
+ import logging
4
+ import random
5
+ import urllib.parse
6
+ import urllib.request
7
+ from typing import Optional
8
+
9
+ import websocket # NOTE: websocket-client (https://github.com/websocket-client/websocket-client)
10
+ from open_webui.env import SRC_LOG_LEVELS
11
+ from pydantic import BaseModel
12
+
13
+ log = logging.getLogger(__name__)
14
+ log.setLevel(SRC_LOG_LEVELS["COMFYUI"])
15
+
16
+ default_headers = {"User-Agent": "Mozilla/5.0"}
17
+
18
+
19
+ def queue_prompt(prompt, client_id, base_url):
20
+ log.info("queue_prompt")
21
+ p = {"prompt": prompt, "client_id": client_id}
22
+ data = json.dumps(p).encode("utf-8")
23
+ log.debug(f"queue_prompt data: {data}")
24
+ try:
25
+ req = urllib.request.Request(
26
+ f"{base_url}/prompt", data=data, headers=default_headers
27
+ )
28
+ response = urllib.request.urlopen(req).read()
29
+ return json.loads(response)
30
+ except Exception as e:
31
+ log.exception(f"Error while queuing prompt: {e}")
32
+ raise e
33
+
34
+
35
+ def get_image(filename, subfolder, folder_type, base_url):
36
+ log.info("get_image")
37
+ data = {"filename": filename, "subfolder": subfolder, "type": folder_type}
38
+ url_values = urllib.parse.urlencode(data)
39
+ req = urllib.request.Request(
40
+ f"{base_url}/view?{url_values}", headers=default_headers
41
+ )
42
+ with urllib.request.urlopen(req) as response:
43
+ return response.read()
44
+
45
+
46
+ def get_image_url(filename, subfolder, folder_type, base_url):
47
+ log.info("get_image")
48
+ data = {"filename": filename, "subfolder": subfolder, "type": folder_type}
49
+ url_values = urllib.parse.urlencode(data)
50
+ return f"{base_url}/view?{url_values}"
51
+
52
+
53
+ def get_history(prompt_id, base_url):
54
+ log.info("get_history")
55
+
56
+ req = urllib.request.Request(
57
+ f"{base_url}/history/{prompt_id}", headers=default_headers
58
+ )
59
+ with urllib.request.urlopen(req) as response:
60
+ return json.loads(response.read())
61
+
62
+
63
+ def get_images(ws, prompt, client_id, base_url):
64
+ prompt_id = queue_prompt(prompt, client_id, base_url)["prompt_id"]
65
+ output_images = []
66
+ while True:
67
+ out = ws.recv()
68
+ if isinstance(out, str):
69
+ message = json.loads(out)
70
+ if message["type"] == "executing":
71
+ data = message["data"]
72
+ if data["node"] is None and data["prompt_id"] == prompt_id:
73
+ break # Execution is done
74
+ else:
75
+ continue # previews are binary data
76
+
77
+ history = get_history(prompt_id, base_url)[prompt_id]
78
+ for o in history["outputs"]:
79
+ for node_id in history["outputs"]:
80
+ node_output = history["outputs"][node_id]
81
+ if "images" in node_output:
82
+ for image in node_output["images"]:
83
+ url = get_image_url(
84
+ image["filename"], image["subfolder"], image["type"], base_url
85
+ )
86
+ output_images.append({"url": url})
87
+ return {"data": output_images}
88
+
89
+
90
+ class ComfyUINodeInput(BaseModel):
91
+ type: Optional[str] = None
92
+ node_ids: list[str] = []
93
+ key: Optional[str] = "text"
94
+ value: Optional[str] = None
95
+
96
+
97
+ class ComfyUIWorkflow(BaseModel):
98
+ workflow: str
99
+ nodes: list[ComfyUINodeInput]
100
+
101
+
102
+ class ComfyUIGenerateImageForm(BaseModel):
103
+ workflow: ComfyUIWorkflow
104
+
105
+ prompt: str
106
+ negative_prompt: Optional[str] = None
107
+ width: int
108
+ height: int
109
+ n: int = 1
110
+
111
+ steps: Optional[int] = None
112
+ seed: Optional[int] = None
113
+
114
+
115
+ async def comfyui_generate_image(
116
+ model: str, payload: ComfyUIGenerateImageForm, client_id, base_url
117
+ ):
118
+ ws_url = base_url.replace("http://", "ws://").replace("https://", "wss://")
119
+ workflow = json.loads(payload.workflow.workflow)
120
+
121
+ for node in payload.workflow.nodes:
122
+ if node.type:
123
+ if node.type == "model":
124
+ for node_id in node.node_ids:
125
+ workflow[node_id]["inputs"][node.key] = model
126
+ elif node.type == "prompt":
127
+ for node_id in node.node_ids:
128
+ workflow[node_id]["inputs"][
129
+ node.key if node.key else "text"
130
+ ] = payload.prompt
131
+ elif node.type == "negative_prompt":
132
+ for node_id in node.node_ids:
133
+ workflow[node_id]["inputs"][
134
+ node.key if node.key else "text"
135
+ ] = payload.negative_prompt
136
+ elif node.type == "width":
137
+ for node_id in node.node_ids:
138
+ workflow[node_id]["inputs"][
139
+ node.key if node.key else "width"
140
+ ] = payload.width
141
+ elif node.type == "height":
142
+ for node_id in node.node_ids:
143
+ workflow[node_id]["inputs"][
144
+ node.key if node.key else "height"
145
+ ] = payload.height
146
+ elif node.type == "n":
147
+ for node_id in node.node_ids:
148
+ workflow[node_id]["inputs"][
149
+ node.key if node.key else "batch_size"
150
+ ] = payload.n
151
+ elif node.type == "steps":
152
+ for node_id in node.node_ids:
153
+ workflow[node_id]["inputs"][
154
+ node.key if node.key else "steps"
155
+ ] = payload.steps
156
+ elif node.type == "seed":
157
+ seed = (
158
+ payload.seed
159
+ if payload.seed
160
+ else random.randint(0, 18446744073709551614)
161
+ )
162
+ for node_id in node.node_ids:
163
+ workflow[node_id]["inputs"][node.key] = seed
164
+ else:
165
+ for node_id in node.node_ids:
166
+ workflow[node_id]["inputs"][node.key] = node.value
167
+
168
+ try:
169
+ ws = websocket.WebSocket()
170
+ ws.connect(f"{ws_url}/ws?clientId={client_id}")
171
+ log.info("WebSocket connection established.")
172
+ except Exception as e:
173
+ log.exception(f"Failed to connect to WebSocket server: {e}")
174
+ return None
175
+
176
+ try:
177
+ log.info("Sending workflow to WebSocket server.")
178
+ log.info(f"Workflow: {workflow}")
179
+ images = await asyncio.to_thread(get_images, ws, workflow, client_id, base_url)
180
+ except Exception as e:
181
+ log.exception(f"Error while receiving images: {e}")
182
+ images = None
183
+
184
+ ws.close()
185
+
186
+ return images
backend/open_webui/apps/ollama/main.py ADDED
@@ -0,0 +1,1326 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ import asyncio
2
+ import json
3
+ import logging
4
+ import os
5
+ import random
6
+ import re
7
+ import time
8
+ from typing import Optional, Union
9
+ from urllib.parse import urlparse
10
+
11
+ import aiohttp
12
+ from aiocache import cached
13
+
14
+ import requests
15
+ from open_webui.apps.webui.models.models import Models
16
+ from open_webui.config import (
17
+ CORS_ALLOW_ORIGIN,
18
+ ENABLE_OLLAMA_API,
19
+ OLLAMA_BASE_URLS,
20
+ OLLAMA_API_CONFIGS,
21
+ UPLOAD_DIR,
22
+ AppConfig,
23
+ )
24
+ from open_webui.env import (
25
+ AIOHTTP_CLIENT_TIMEOUT,
26
+ AIOHTTP_CLIENT_TIMEOUT_OPENAI_MODEL_LIST,
27
+ )
28
+
29
+
30
+ from open_webui.constants import ERROR_MESSAGES
31
+ from open_webui.env import ENV, SRC_LOG_LEVELS
32
+ from fastapi import Depends, FastAPI, File, HTTPException, Request, UploadFile
33
+ from fastapi.middleware.cors import CORSMiddleware
34
+ from fastapi.responses import StreamingResponse
35
+ from pydantic import BaseModel, ConfigDict
36
+ from starlette.background import BackgroundTask
37
+
38
+
39
+ from open_webui.utils.misc import (
40
+ calculate_sha256,
41
+ )
42
+ from open_webui.utils.payload import (
43
+ apply_model_params_to_body_ollama,
44
+ apply_model_params_to_body_openai,
45
+ apply_model_system_prompt_to_body,
46
+ )
47
+ from open_webui.utils.utils import get_admin_user, get_verified_user
48
+ from open_webui.utils.access_control import has_access
49
+
50
+ log = logging.getLogger(__name__)
51
+ log.setLevel(SRC_LOG_LEVELS["OLLAMA"])
52
+
53
+
54
+ app = FastAPI(
55
+ docs_url="/docs" if ENV == "dev" else None,
56
+ openapi_url="/openapi.json" if ENV == "dev" else None,
57
+ redoc_url=None,
58
+ )
59
+
60
+ app.add_middleware(
61
+ CORSMiddleware,
62
+ allow_origins=CORS_ALLOW_ORIGIN,
63
+ allow_credentials=True,
64
+ allow_methods=["*"],
65
+ allow_headers=["*"],
66
+ )
67
+
68
+ app.state.config = AppConfig()
69
+
70
+ app.state.config.ENABLE_OLLAMA_API = ENABLE_OLLAMA_API
71
+ app.state.config.OLLAMA_BASE_URLS = OLLAMA_BASE_URLS
72
+ app.state.config.OLLAMA_API_CONFIGS = OLLAMA_API_CONFIGS
73
+
74
+
75
+ # TODO: Implement a more intelligent load balancing mechanism for distributing requests among multiple backend instances.
76
+ # Current implementation uses a simple round-robin approach (random.choice). Consider incorporating algorithms like weighted round-robin,
77
+ # least connections, or least response time for better resource utilization and performance optimization.
78
+
79
+
80
+ @app.head("/")
81
+ @app.get("/")
82
+ async def get_status():
83
+ return {"status": True}
84
+
85
+
86
+ class ConnectionVerificationForm(BaseModel):
87
+ url: str
88
+ key: Optional[str] = None
89
+
90
+
91
+ @app.post("/verify")
92
+ async def verify_connection(
93
+ form_data: ConnectionVerificationForm, user=Depends(get_admin_user)
94
+ ):
95
+ url = form_data.url
96
+ key = form_data.key
97
+
98
+ headers = {}
99
+ if key:
100
+ headers["Authorization"] = f"Bearer {key}"
101
+
102
+ timeout = aiohttp.ClientTimeout(total=AIOHTTP_CLIENT_TIMEOUT_OPENAI_MODEL_LIST)
103
+ async with aiohttp.ClientSession(timeout=timeout) as session:
104
+ try:
105
+ async with session.get(f"{url}/api/version", headers=headers) as r:
106
+ if r.status != 200:
107
+ # Extract response error details if available
108
+ error_detail = f"HTTP Error: {r.status}"
109
+ res = await r.json()
110
+ if "error" in res:
111
+ error_detail = f"External Error: {res['error']}"
112
+ raise Exception(error_detail)
113
+
114
+ response_data = await r.json()
115
+ return response_data
116
+
117
+ except aiohttp.ClientError as e:
118
+ # ClientError covers all aiohttp requests issues
119
+ log.exception(f"Client error: {str(e)}")
120
+ # Handle aiohttp-specific connection issues, timeout etc.
121
+ raise HTTPException(
122
+ status_code=500, detail="Open WebUI: Server Connection Error"
123
+ )
124
+ except Exception as e:
125
+ log.exception(f"Unexpected error: {e}")
126
+ # Generic error handler in case parsing JSON or other steps fail
127
+ error_detail = f"Unexpected error: {str(e)}"
128
+ raise HTTPException(status_code=500, detail=error_detail)
129
+
130
+
131
+ @app.get("/config")
132
+ async def get_config(user=Depends(get_admin_user)):
133
+ return {
134
+ "ENABLE_OLLAMA_API": app.state.config.ENABLE_OLLAMA_API,
135
+ "OLLAMA_BASE_URLS": app.state.config.OLLAMA_BASE_URLS,
136
+ "OLLAMA_API_CONFIGS": app.state.config.OLLAMA_API_CONFIGS,
137
+ }
138
+
139
+
140
+ class OllamaConfigForm(BaseModel):
141
+ ENABLE_OLLAMA_API: Optional[bool] = None
142
+ OLLAMA_BASE_URLS: list[str]
143
+ OLLAMA_API_CONFIGS: dict
144
+
145
+
146
+ @app.post("/config/update")
147
+ async def update_config(form_data: OllamaConfigForm, user=Depends(get_admin_user)):
148
+ app.state.config.ENABLE_OLLAMA_API = form_data.ENABLE_OLLAMA_API
149
+ app.state.config.OLLAMA_BASE_URLS = form_data.OLLAMA_BASE_URLS
150
+
151
+ app.state.config.OLLAMA_API_CONFIGS = form_data.OLLAMA_API_CONFIGS
152
+
153
+ # Remove any extra configs
154
+ config_urls = app.state.config.OLLAMA_API_CONFIGS.keys()
155
+ for url in list(app.state.config.OLLAMA_BASE_URLS):
156
+ if url not in config_urls:
157
+ app.state.config.OLLAMA_API_CONFIGS.pop(url, None)
158
+
159
+ return {
160
+ "ENABLE_OLLAMA_API": app.state.config.ENABLE_OLLAMA_API,
161
+ "OLLAMA_BASE_URLS": app.state.config.OLLAMA_BASE_URLS,
162
+ "OLLAMA_API_CONFIGS": app.state.config.OLLAMA_API_CONFIGS,
163
+ }
164
+
165
+
166
+ async def aiohttp_get(url, key=None):
167
+ timeout = aiohttp.ClientTimeout(total=AIOHTTP_CLIENT_TIMEOUT_OPENAI_MODEL_LIST)
168
+ try:
169
+ headers = {"Authorization": f"Bearer {key}"} if key else {}
170
+ async with aiohttp.ClientSession(timeout=timeout, trust_env=True) as session:
171
+ async with session.get(url, headers=headers) as response:
172
+ return await response.json()
173
+ except Exception as e:
174
+ # Handle connection error here
175
+ log.error(f"Connection error: {e}")
176
+ return None
177
+
178
+
179
+ async def cleanup_response(
180
+ response: Optional[aiohttp.ClientResponse],
181
+ session: Optional[aiohttp.ClientSession],
182
+ ):
183
+ if response:
184
+ response.close()
185
+ if session:
186
+ await session.close()
187
+
188
+
189
+ async def post_streaming_url(
190
+ url: str, payload: Union[str, bytes], stream: bool = True, content_type=None
191
+ ):
192
+ r = None
193
+ try:
194
+ session = aiohttp.ClientSession(
195
+ trust_env=True, timeout=aiohttp.ClientTimeout(total=AIOHTTP_CLIENT_TIMEOUT)
196
+ )
197
+
198
+ api_config = app.state.config.OLLAMA_API_CONFIGS.get(url, {})
199
+ key = api_config.get("key", None)
200
+
201
+ headers = {"Content-Type": "application/json"}
202
+ if key:
203
+ headers["Authorization"] = f"Bearer {key}"
204
+
205
+ r = await session.post(
206
+ url,
207
+ data=payload,
208
+ headers=headers,
209
+ )
210
+ r.raise_for_status()
211
+
212
+ if stream:
213
+ headers = dict(r.headers)
214
+ if content_type:
215
+ headers["Content-Type"] = content_type
216
+ return StreamingResponse(
217
+ r.content,
218
+ status_code=r.status,
219
+ headers=headers,
220
+ background=BackgroundTask(
221
+ cleanup_response, response=r, session=session
222
+ ),
223
+ )
224
+ else:
225
+ res = await r.json()
226
+ await cleanup_response(r, session)
227
+ return res
228
+
229
+ except Exception as e:
230
+ error_detail = "Open WebUI: Server Connection Error"
231
+ if r is not None:
232
+ try:
233
+ res = await r.json()
234
+ if "error" in res:
235
+ error_detail = f"Ollama: {res['error']}"
236
+ except Exception:
237
+ error_detail = f"Ollama: {e}"
238
+
239
+ raise HTTPException(
240
+ status_code=r.status if r else 500,
241
+ detail=error_detail,
242
+ )
243
+
244
+
245
+ def merge_models_lists(model_lists):
246
+ merged_models = {}
247
+
248
+ for idx, model_list in enumerate(model_lists):
249
+ if model_list is not None:
250
+ for model in model_list:
251
+ id = model["model"]
252
+ if id not in merged_models:
253
+ model["urls"] = [idx]
254
+ merged_models[id] = model
255
+ else:
256
+ merged_models[id]["urls"].append(idx)
257
+
258
+ return list(merged_models.values())
259
+
260
+
261
+ @cached(ttl=3)
262
+ async def get_all_models():
263
+ log.info("get_all_models()")
264
+ if app.state.config.ENABLE_OLLAMA_API:
265
+ tasks = []
266
+ for idx, url in enumerate(app.state.config.OLLAMA_BASE_URLS):
267
+ if url not in app.state.config.OLLAMA_API_CONFIGS:
268
+ tasks.append(aiohttp_get(f"{url}/api/tags"))
269
+ else:
270
+ api_config = app.state.config.OLLAMA_API_CONFIGS.get(url, {})
271
+ enable = api_config.get("enable", True)
272
+ key = api_config.get("key", None)
273
+
274
+ if enable:
275
+ tasks.append(aiohttp_get(f"{url}/api/tags", key))
276
+ else:
277
+ tasks.append(asyncio.ensure_future(asyncio.sleep(0, None)))
278
+
279
+ responses = await asyncio.gather(*tasks)
280
+
281
+ for idx, response in enumerate(responses):
282
+ if response:
283
+ url = app.state.config.OLLAMA_BASE_URLS[idx]
284
+ api_config = app.state.config.OLLAMA_API_CONFIGS.get(url, {})
285
+
286
+ prefix_id = api_config.get("prefix_id", None)
287
+ model_ids = api_config.get("model_ids", [])
288
+
289
+ if len(model_ids) != 0 and "models" in response:
290
+ response["models"] = list(
291
+ filter(
292
+ lambda model: model["model"] in model_ids,
293
+ response["models"],
294
+ )
295
+ )
296
+
297
+ if prefix_id:
298
+ for model in response.get("models", []):
299
+ model["model"] = f"{prefix_id}.{model['model']}"
300
+
301
+ models = {
302
+ "models": merge_models_lists(
303
+ map(
304
+ lambda response: response.get("models", []) if response else None,
305
+ responses,
306
+ )
307
+ )
308
+ }
309
+
310
+ else:
311
+ models = {"models": []}
312
+
313
+ return models
314
+
315
+
316
+ @app.get("/api/tags")
317
+ @app.get("/api/tags/{url_idx}")
318
+ async def get_ollama_tags(
319
+ url_idx: Optional[int] = None, user=Depends(get_verified_user)
320
+ ):
321
+ models = []
322
+ if url_idx is None:
323
+ models = await get_all_models()
324
+ else:
325
+ url = app.state.config.OLLAMA_BASE_URLS[url_idx]
326
+
327
+ api_config = app.state.config.OLLAMA_API_CONFIGS.get(url, {})
328
+ key = api_config.get("key", None)
329
+
330
+ headers = {}
331
+ if key:
332
+ headers["Authorization"] = f"Bearer {key}"
333
+
334
+ r = None
335
+ try:
336
+ r = requests.request(method="GET", url=f"{url}/api/tags", headers=headers)
337
+ r.raise_for_status()
338
+
339
+ models = r.json()
340
+ except Exception as e:
341
+ log.exception(e)
342
+ error_detail = "Open WebUI: Server Connection Error"
343
+ if r is not None:
344
+ try:
345
+ res = r.json()
346
+ if "error" in res:
347
+ error_detail = f"Ollama: {res['error']}"
348
+ except Exception:
349
+ error_detail = f"Ollama: {e}"
350
+
351
+ raise HTTPException(
352
+ status_code=r.status_code if r else 500,
353
+ detail=error_detail,
354
+ )
355
+
356
+ if user.role == "user":
357
+ # Filter models based on user access control
358
+ filtered_models = []
359
+ for model in models.get("models", []):
360
+ model_info = Models.get_model_by_id(model["model"])
361
+ if model_info:
362
+ if user.id == model_info.user_id or has_access(
363
+ user.id, type="read", access_control=model_info.access_control
364
+ ):
365
+ filtered_models.append(model)
366
+ models["models"] = filtered_models
367
+
368
+ return models
369
+
370
+
371
+ @app.get("/api/version")
372
+ @app.get("/api/version/{url_idx}")
373
+ async def get_ollama_versions(url_idx: Optional[int] = None):
374
+ if app.state.config.ENABLE_OLLAMA_API:
375
+ if url_idx is None:
376
+ # returns lowest version
377
+ tasks = [
378
+ aiohttp_get(
379
+ f"{url}/api/version",
380
+ app.state.config.OLLAMA_API_CONFIGS.get(url, {}).get("key", None),
381
+ )
382
+ for url in app.state.config.OLLAMA_BASE_URLS
383
+ ]
384
+ responses = await asyncio.gather(*tasks)
385
+ responses = list(filter(lambda x: x is not None, responses))
386
+
387
+ if len(responses) > 0:
388
+ lowest_version = min(
389
+ responses,
390
+ key=lambda x: tuple(
391
+ map(int, re.sub(r"^v|-.*", "", x["version"]).split("."))
392
+ ),
393
+ )
394
+
395
+ return {"version": lowest_version["version"]}
396
+ else:
397
+ raise HTTPException(
398
+ status_code=500,
399
+ detail=ERROR_MESSAGES.OLLAMA_NOT_FOUND,
400
+ )
401
+ else:
402
+ url = app.state.config.OLLAMA_BASE_URLS[url_idx]
403
+
404
+ r = None
405
+ try:
406
+ r = requests.request(method="GET", url=f"{url}/api/version")
407
+ r.raise_for_status()
408
+
409
+ return r.json()
410
+ except Exception as e:
411
+ log.exception(e)
412
+ error_detail = "Open WebUI: Server Connection Error"
413
+ if r is not None:
414
+ try:
415
+ res = r.json()
416
+ if "error" in res:
417
+ error_detail = f"Ollama: {res['error']}"
418
+ except Exception:
419
+ error_detail = f"Ollama: {e}"
420
+
421
+ raise HTTPException(
422
+ status_code=r.status_code if r else 500,
423
+ detail=error_detail,
424
+ )
425
+ else:
426
+ return {"version": False}
427
+
428
+
429
+ class ModelNameForm(BaseModel):
430
+ name: str
431
+
432
+
433
+ @app.post("/api/pull")
434
+ @app.post("/api/pull/{url_idx}")
435
+ async def pull_model(
436
+ form_data: ModelNameForm, url_idx: int = 0, user=Depends(get_admin_user)
437
+ ):
438
+ url = app.state.config.OLLAMA_BASE_URLS[url_idx]
439
+ log.info(f"url: {url}")
440
+
441
+ # Admin should be able to pull models from any source
442
+ payload = {**form_data.model_dump(exclude_none=True), "insecure": True}
443
+
444
+ return await post_streaming_url(f"{url}/api/pull", json.dumps(payload))
445
+
446
+
447
+ class PushModelForm(BaseModel):
448
+ name: str
449
+ insecure: Optional[bool] = None
450
+ stream: Optional[bool] = None
451
+
452
+
453
+ @app.delete("/api/push")
454
+ @app.delete("/api/push/{url_idx}")
455
+ async def push_model(
456
+ form_data: PushModelForm,
457
+ url_idx: Optional[int] = None,
458
+ user=Depends(get_admin_user),
459
+ ):
460
+ if url_idx is None:
461
+ model_list = await get_all_models()
462
+ models = {model["model"]: model for model in model_list["models"]}
463
+
464
+ if form_data.name in models:
465
+ url_idx = models[form_data.name]["urls"][0]
466
+ else:
467
+ raise HTTPException(
468
+ status_code=400,
469
+ detail=ERROR_MESSAGES.MODEL_NOT_FOUND(form_data.name),
470
+ )
471
+
472
+ url = app.state.config.OLLAMA_BASE_URLS[url_idx]
473
+ log.debug(f"url: {url}")
474
+
475
+ return await post_streaming_url(
476
+ f"{url}/api/push", form_data.model_dump_json(exclude_none=True).encode()
477
+ )
478
+
479
+
480
+ class CreateModelForm(BaseModel):
481
+ name: str
482
+ modelfile: Optional[str] = None
483
+ stream: Optional[bool] = None
484
+ path: Optional[str] = None
485
+
486
+
487
+ @app.post("/api/create")
488
+ @app.post("/api/create/{url_idx}")
489
+ async def create_model(
490
+ form_data: CreateModelForm, url_idx: int = 0, user=Depends(get_admin_user)
491
+ ):
492
+ log.debug(f"form_data: {form_data}")
493
+ url = app.state.config.OLLAMA_BASE_URLS[url_idx]
494
+ log.info(f"url: {url}")
495
+
496
+ return await post_streaming_url(
497
+ f"{url}/api/create", form_data.model_dump_json(exclude_none=True).encode()
498
+ )
499
+
500
+
501
+ class CopyModelForm(BaseModel):
502
+ source: str
503
+ destination: str
504
+
505
+
506
+ @app.post("/api/copy")
507
+ @app.post("/api/copy/{url_idx}")
508
+ async def copy_model(
509
+ form_data: CopyModelForm,
510
+ url_idx: Optional[int] = None,
511
+ user=Depends(get_admin_user),
512
+ ):
513
+ if url_idx is None:
514
+ model_list = await get_all_models()
515
+ models = {model["model"]: model for model in model_list["models"]}
516
+
517
+ if form_data.source in models:
518
+ url_idx = models[form_data.source]["urls"][0]
519
+ else:
520
+ raise HTTPException(
521
+ status_code=400,
522
+ detail=ERROR_MESSAGES.MODEL_NOT_FOUND(form_data.source),
523
+ )
524
+
525
+ url = app.state.config.OLLAMA_BASE_URLS[url_idx]
526
+ log.info(f"url: {url}")
527
+
528
+ api_config = app.state.config.OLLAMA_API_CONFIGS.get(url, {})
529
+ key = api_config.get("key", None)
530
+
531
+ headers = {"Content-Type": "application/json"}
532
+ if key:
533
+ headers["Authorization"] = f"Bearer {key}"
534
+
535
+ r = requests.request(
536
+ method="POST",
537
+ url=f"{url}/api/copy",
538
+ headers=headers,
539
+ data=form_data.model_dump_json(exclude_none=True).encode(),
540
+ )
541
+
542
+ try:
543
+ r.raise_for_status()
544
+
545
+ log.debug(f"r.text: {r.text}")
546
+
547
+ return True
548
+ except Exception as e:
549
+ log.exception(e)
550
+ error_detail = "Open WebUI: Server Connection Error"
551
+ if r is not None:
552
+ try:
553
+ res = r.json()
554
+ if "error" in res:
555
+ error_detail = f"Ollama: {res['error']}"
556
+ except Exception:
557
+ error_detail = f"Ollama: {e}"
558
+
559
+ raise HTTPException(
560
+ status_code=r.status_code if r else 500,
561
+ detail=error_detail,
562
+ )
563
+
564
+
565
+ @app.delete("/api/delete")
566
+ @app.delete("/api/delete/{url_idx}")
567
+ async def delete_model(
568
+ form_data: ModelNameForm,
569
+ url_idx: Optional[int] = None,
570
+ user=Depends(get_admin_user),
571
+ ):
572
+ if url_idx is None:
573
+ model_list = await get_all_models()
574
+ models = {model["model"]: model for model in model_list["models"]}
575
+
576
+ if form_data.name in models:
577
+ url_idx = models[form_data.name]["urls"][0]
578
+ else:
579
+ raise HTTPException(
580
+ status_code=400,
581
+ detail=ERROR_MESSAGES.MODEL_NOT_FOUND(form_data.name),
582
+ )
583
+
584
+ url = app.state.config.OLLAMA_BASE_URLS[url_idx]
585
+ log.info(f"url: {url}")
586
+
587
+ api_config = app.state.config.OLLAMA_API_CONFIGS.get(url, {})
588
+ key = api_config.get("key", None)
589
+
590
+ headers = {"Content-Type": "application/json"}
591
+ if key:
592
+ headers["Authorization"] = f"Bearer {key}"
593
+
594
+ r = requests.request(
595
+ method="DELETE",
596
+ url=f"{url}/api/delete",
597
+ data=form_data.model_dump_json(exclude_none=True).encode(),
598
+ headers=headers,
599
+ )
600
+ try:
601
+ r.raise_for_status()
602
+
603
+ log.debug(f"r.text: {r.text}")
604
+
605
+ return True
606
+ except Exception as e:
607
+ log.exception(e)
608
+ error_detail = "Open WebUI: Server Connection Error"
609
+ if r is not None:
610
+ try:
611
+ res = r.json()
612
+ if "error" in res:
613
+ error_detail = f"Ollama: {res['error']}"
614
+ except Exception:
615
+ error_detail = f"Ollama: {e}"
616
+
617
+ raise HTTPException(
618
+ status_code=r.status_code if r else 500,
619
+ detail=error_detail,
620
+ )
621
+
622
+
623
+ @app.post("/api/show")
624
+ async def show_model_info(form_data: ModelNameForm, user=Depends(get_verified_user)):
625
+ model_list = await get_all_models()
626
+ models = {model["model"]: model for model in model_list["models"]}
627
+
628
+ if form_data.name not in models:
629
+ raise HTTPException(
630
+ status_code=400,
631
+ detail=ERROR_MESSAGES.MODEL_NOT_FOUND(form_data.name),
632
+ )
633
+
634
+ url_idx = random.choice(models[form_data.name]["urls"])
635
+ url = app.state.config.OLLAMA_BASE_URLS[url_idx]
636
+ log.info(f"url: {url}")
637
+
638
+ api_config = app.state.config.OLLAMA_API_CONFIGS.get(url, {})
639
+ key = api_config.get("key", None)
640
+
641
+ headers = {"Content-Type": "application/json"}
642
+ if key:
643
+ headers["Authorization"] = f"Bearer {key}"
644
+
645
+ r = requests.request(
646
+ method="POST",
647
+ url=f"{url}/api/show",
648
+ headers=headers,
649
+ data=form_data.model_dump_json(exclude_none=True).encode(),
650
+ )
651
+ try:
652
+ r.raise_for_status()
653
+
654
+ return r.json()
655
+ except Exception as e:
656
+ log.exception(e)
657
+ error_detail = "Open WebUI: Server Connection Error"
658
+ if r is not None:
659
+ try:
660
+ res = r.json()
661
+ if "error" in res:
662
+ error_detail = f"Ollama: {res['error']}"
663
+ except Exception:
664
+ error_detail = f"Ollama: {e}"
665
+
666
+ raise HTTPException(
667
+ status_code=r.status_code if r else 500,
668
+ detail=error_detail,
669
+ )
670
+
671
+
672
+ class GenerateEmbeddingsForm(BaseModel):
673
+ model: str
674
+ prompt: str
675
+ options: Optional[dict] = None
676
+ keep_alive: Optional[Union[int, str]] = None
677
+
678
+
679
+ class GenerateEmbedForm(BaseModel):
680
+ model: str
681
+ input: list[str] | str
682
+ truncate: Optional[bool] = None
683
+ options: Optional[dict] = None
684
+ keep_alive: Optional[Union[int, str]] = None
685
+
686
+
687
+ @app.post("/api/embed")
688
+ @app.post("/api/embed/{url_idx}")
689
+ async def generate_embeddings(
690
+ form_data: GenerateEmbedForm,
691
+ url_idx: Optional[int] = None,
692
+ user=Depends(get_verified_user),
693
+ ):
694
+ return generate_ollama_batch_embeddings(form_data, url_idx)
695
+
696
+
697
+ @app.post("/api/embeddings")
698
+ @app.post("/api/embeddings/{url_idx}")
699
+ async def generate_embeddings(
700
+ form_data: GenerateEmbeddingsForm,
701
+ url_idx: Optional[int] = None,
702
+ user=Depends(get_verified_user),
703
+ ):
704
+ return await generate_ollama_embeddings(form_data=form_data, url_idx=url_idx)
705
+
706
+
707
+ async def generate_ollama_embeddings(
708
+ form_data: GenerateEmbeddingsForm,
709
+ url_idx: Optional[int] = None,
710
+ ):
711
+ log.info(f"generate_ollama_embeddings {form_data}")
712
+
713
+ if url_idx is None:
714
+ model_list = await get_all_models()
715
+ models = {model["model"]: model for model in model_list["models"]}
716
+
717
+ model = form_data.model
718
+
719
+ if ":" not in model:
720
+ model = f"{model}:latest"
721
+
722
+ if model in models:
723
+ url_idx = random.choice(models[model]["urls"])
724
+ else:
725
+ raise HTTPException(
726
+ status_code=400,
727
+ detail=ERROR_MESSAGES.MODEL_NOT_FOUND(form_data.model),
728
+ )
729
+
730
+ url = app.state.config.OLLAMA_BASE_URLS[url_idx]
731
+ log.info(f"url: {url}")
732
+
733
+ api_config = app.state.config.OLLAMA_API_CONFIGS.get(url, {})
734
+ key = api_config.get("key", None)
735
+
736
+ headers = {"Content-Type": "application/json"}
737
+ if key:
738
+ headers["Authorization"] = f"Bearer {key}"
739
+
740
+ r = requests.request(
741
+ method="POST",
742
+ url=f"{url}/api/embeddings",
743
+ headers=headers,
744
+ data=form_data.model_dump_json(exclude_none=True).encode(),
745
+ )
746
+ try:
747
+ r.raise_for_status()
748
+
749
+ data = r.json()
750
+
751
+ log.info(f"generate_ollama_embeddings {data}")
752
+
753
+ if "embedding" in data:
754
+ return data
755
+ else:
756
+ raise Exception("Something went wrong :/")
757
+ except Exception as e:
758
+ log.exception(e)
759
+ error_detail = "Open WebUI: Server Connection Error"
760
+ if r is not None:
761
+ try:
762
+ res = r.json()
763
+ if "error" in res:
764
+ error_detail = f"Ollama: {res['error']}"
765
+ except Exception:
766
+ error_detail = f"Ollama: {e}"
767
+
768
+ raise HTTPException(
769
+ status_code=r.status_code if r else 500,
770
+ detail=error_detail,
771
+ )
772
+
773
+
774
+ async def generate_ollama_batch_embeddings(
775
+ form_data: GenerateEmbedForm,
776
+ url_idx: Optional[int] = None,
777
+ ):
778
+ log.info(f"generate_ollama_batch_embeddings {form_data}")
779
+
780
+ if url_idx is None:
781
+ model_list = await get_all_models()
782
+ models = {model["model"]: model for model in model_list["models"]}
783
+
784
+ model = form_data.model
785
+
786
+ if ":" not in model:
787
+ model = f"{model}:latest"
788
+
789
+ if model in models:
790
+ url_idx = random.choice(models[model]["urls"])
791
+ else:
792
+ raise HTTPException(
793
+ status_code=400,
794
+ detail=ERROR_MESSAGES.MODEL_NOT_FOUND(form_data.model),
795
+ )
796
+
797
+ url = app.state.config.OLLAMA_BASE_URLS[url_idx]
798
+ log.info(f"url: {url}")
799
+
800
+ api_config = app.state.config.OLLAMA_API_CONFIGS.get(url, {})
801
+ key = api_config.get("key", None)
802
+
803
+ headers = {"Content-Type": "application/json"}
804
+ if key:
805
+ headers["Authorization"] = f"Bearer {key}"
806
+
807
+ r = requests.request(
808
+ method="POST",
809
+ url=f"{url}/api/embed",
810
+ headers=headers,
811
+ data=form_data.model_dump_json(exclude_none=True).encode(),
812
+ )
813
+ try:
814
+ r.raise_for_status()
815
+
816
+ data = r.json()
817
+
818
+ log.info(f"generate_ollama_batch_embeddings {data}")
819
+
820
+ if "embeddings" in data:
821
+ return data
822
+ else:
823
+ raise Exception("Something went wrong :/")
824
+ except Exception as e:
825
+ log.exception(e)
826
+ error_detail = "Open WebUI: Server Connection Error"
827
+ if r is not None:
828
+ try:
829
+ res = r.json()
830
+ if "error" in res:
831
+ error_detail = f"Ollama: {res['error']}"
832
+ except Exception:
833
+ error_detail = f"Ollama: {e}"
834
+
835
+ raise Exception(error_detail)
836
+
837
+
838
+ class GenerateCompletionForm(BaseModel):
839
+ model: str
840
+ prompt: str
841
+ suffix: Optional[str] = None
842
+ images: Optional[list[str]] = None
843
+ format: Optional[str] = None
844
+ options: Optional[dict] = None
845
+ system: Optional[str] = None
846
+ template: Optional[str] = None
847
+ context: Optional[list[int]] = None
848
+ stream: Optional[bool] = True
849
+ raw: Optional[bool] = None
850
+ keep_alive: Optional[Union[int, str]] = None
851
+
852
+
853
+ @app.post("/api/generate")
854
+ @app.post("/api/generate/{url_idx}")
855
+ async def generate_completion(
856
+ form_data: GenerateCompletionForm,
857
+ url_idx: Optional[int] = None,
858
+ user=Depends(get_verified_user),
859
+ ):
860
+ if url_idx is None:
861
+ model_list = await get_all_models()
862
+ models = {model["model"]: model for model in model_list["models"]}
863
+
864
+ model = form_data.model
865
+
866
+ if ":" not in model:
867
+ model = f"{model}:latest"
868
+
869
+ if model in models:
870
+ url_idx = random.choice(models[model]["urls"])
871
+ else:
872
+ raise HTTPException(
873
+ status_code=400,
874
+ detail=ERROR_MESSAGES.MODEL_NOT_FOUND(form_data.model),
875
+ )
876
+
877
+ url = app.state.config.OLLAMA_BASE_URLS[url_idx]
878
+ api_config = app.state.config.OLLAMA_API_CONFIGS.get(url, {})
879
+ prefix_id = api_config.get("prefix_id", None)
880
+ if prefix_id:
881
+ form_data.model = form_data.model.replace(f"{prefix_id}.", "")
882
+ log.info(f"url: {url}")
883
+
884
+ return await post_streaming_url(
885
+ f"{url}/api/generate", form_data.model_dump_json(exclude_none=True).encode()
886
+ )
887
+
888
+
889
+ class ChatMessage(BaseModel):
890
+ role: str
891
+ content: str
892
+ images: Optional[list[str]] = None
893
+
894
+
895
+ class GenerateChatCompletionForm(BaseModel):
896
+ model: str
897
+ messages: list[ChatMessage]
898
+ format: Optional[str] = None
899
+ options: Optional[dict] = None
900
+ template: Optional[str] = None
901
+ stream: Optional[bool] = True
902
+ keep_alive: Optional[Union[int, str]] = None
903
+
904
+
905
+ async def get_ollama_url(url_idx: Optional[int], model: str):
906
+ if url_idx is None:
907
+ model_list = await get_all_models()
908
+ models = {model["model"]: model for model in model_list["models"]}
909
+
910
+ if model not in models:
911
+ raise HTTPException(
912
+ status_code=400,
913
+ detail=ERROR_MESSAGES.MODEL_NOT_FOUND(model),
914
+ )
915
+ url_idx = random.choice(models[model]["urls"])
916
+ url = app.state.config.OLLAMA_BASE_URLS[url_idx]
917
+ return url
918
+
919
+
920
+ @app.post("/api/chat")
921
+ @app.post("/api/chat/{url_idx}")
922
+ async def generate_chat_completion(
923
+ form_data: GenerateChatCompletionForm,
924
+ url_idx: Optional[int] = None,
925
+ user=Depends(get_verified_user),
926
+ bypass_filter: Optional[bool] = False,
927
+ ):
928
+ payload = {**form_data.model_dump(exclude_none=True)}
929
+ log.debug(f"generate_chat_completion() - 1.payload = {payload}")
930
+ if "metadata" in payload:
931
+ del payload["metadata"]
932
+
933
+ model_id = payload["model"]
934
+ model_info = Models.get_model_by_id(model_id)
935
+
936
+ if model_info:
937
+ if model_info.base_model_id:
938
+ payload["model"] = model_info.base_model_id
939
+
940
+ params = model_info.params.model_dump()
941
+
942
+ if params:
943
+ if payload.get("options") is None:
944
+ payload["options"] = {}
945
+
946
+ payload["options"] = apply_model_params_to_body_ollama(
947
+ params, payload["options"]
948
+ )
949
+ payload = apply_model_system_prompt_to_body(params, payload, user)
950
+
951
+ # Check if user has access to the model
952
+ if not bypass_filter and user.role == "user":
953
+ if not (
954
+ user.id == model_info.user_id
955
+ or has_access(
956
+ user.id, type="read", access_control=model_info.access_control
957
+ )
958
+ ):
959
+ raise HTTPException(
960
+ status_code=403,
961
+ detail="Model not found",
962
+ )
963
+ elif not bypass_filter:
964
+ if user.role != "admin":
965
+ raise HTTPException(
966
+ status_code=403,
967
+ detail="Model not found",
968
+ )
969
+
970
+ if ":" not in payload["model"]:
971
+ payload["model"] = f"{payload['model']}:latest"
972
+
973
+ url = await get_ollama_url(url_idx, payload["model"])
974
+ log.info(f"url: {url}")
975
+ log.debug(f"generate_chat_completion() - 2.payload = {payload}")
976
+
977
+ api_config = app.state.config.OLLAMA_API_CONFIGS.get(url, {})
978
+ prefix_id = api_config.get("prefix_id", None)
979
+ if prefix_id:
980
+ payload["model"] = payload["model"].replace(f"{prefix_id}.", "")
981
+
982
+ return await post_streaming_url(
983
+ f"{url}/api/chat",
984
+ json.dumps(payload),
985
+ stream=form_data.stream,
986
+ content_type="application/x-ndjson",
987
+ )
988
+
989
+
990
+ # TODO: we should update this part once Ollama supports other types
991
+ class OpenAIChatMessageContent(BaseModel):
992
+ type: str
993
+ model_config = ConfigDict(extra="allow")
994
+
995
+
996
+ class OpenAIChatMessage(BaseModel):
997
+ role: str
998
+ content: Union[str, list[OpenAIChatMessageContent]]
999
+
1000
+ model_config = ConfigDict(extra="allow")
1001
+
1002
+
1003
+ class OpenAIChatCompletionForm(BaseModel):
1004
+ model: str
1005
+ messages: list[OpenAIChatMessage]
1006
+
1007
+ model_config = ConfigDict(extra="allow")
1008
+
1009
+
1010
+ @app.post("/v1/chat/completions")
1011
+ @app.post("/v1/chat/completions/{url_idx}")
1012
+ async def generate_openai_chat_completion(
1013
+ form_data: dict,
1014
+ url_idx: Optional[int] = None,
1015
+ user=Depends(get_verified_user),
1016
+ ):
1017
+ try:
1018
+ completion_form = OpenAIChatCompletionForm(**form_data)
1019
+ except Exception as e:
1020
+ log.exception(e)
1021
+ raise HTTPException(
1022
+ status_code=400,
1023
+ detail=str(e),
1024
+ )
1025
+
1026
+ payload = {**completion_form.model_dump(exclude_none=True, exclude=["metadata"])}
1027
+ if "metadata" in payload:
1028
+ del payload["metadata"]
1029
+
1030
+ model_id = completion_form.model
1031
+ if ":" not in model_id:
1032
+ model_id = f"{model_id}:latest"
1033
+
1034
+ model_info = Models.get_model_by_id(model_id)
1035
+ if model_info:
1036
+ if model_info.base_model_id:
1037
+ payload["model"] = model_info.base_model_id
1038
+
1039
+ params = model_info.params.model_dump()
1040
+
1041
+ if params:
1042
+ payload = apply_model_params_to_body_openai(params, payload)
1043
+ payload = apply_model_system_prompt_to_body(params, payload, user)
1044
+
1045
+ # Check if user has access to the model
1046
+ if user.role == "user":
1047
+ if not (
1048
+ user.id == model_info.user_id
1049
+ or has_access(
1050
+ user.id, type="read", access_control=model_info.access_control
1051
+ )
1052
+ ):
1053
+ raise HTTPException(
1054
+ status_code=403,
1055
+ detail="Model not found",
1056
+ )
1057
+ else:
1058
+ if user.role != "admin":
1059
+ raise HTTPException(
1060
+ status_code=403,
1061
+ detail="Model not found",
1062
+ )
1063
+
1064
+ if ":" not in payload["model"]:
1065
+ payload["model"] = f"{payload['model']}:latest"
1066
+
1067
+ url = await get_ollama_url(url_idx, payload["model"])
1068
+ log.info(f"url: {url}")
1069
+
1070
+ api_config = app.state.config.OLLAMA_API_CONFIGS.get(url, {})
1071
+ prefix_id = api_config.get("prefix_id", None)
1072
+ if prefix_id:
1073
+ payload["model"] = payload["model"].replace(f"{prefix_id}.", "")
1074
+
1075
+ return await post_streaming_url(
1076
+ f"{url}/v1/chat/completions",
1077
+ json.dumps(payload),
1078
+ stream=payload.get("stream", False),
1079
+ )
1080
+
1081
+
1082
+ @app.get("/v1/models")
1083
+ @app.get("/v1/models/{url_idx}")
1084
+ async def get_openai_models(
1085
+ url_idx: Optional[int] = None,
1086
+ user=Depends(get_verified_user),
1087
+ ):
1088
+
1089
+ models = []
1090
+ if url_idx is None:
1091
+ model_list = await get_all_models()
1092
+ models = [
1093
+ {
1094
+ "id": model["model"],
1095
+ "object": "model",
1096
+ "created": int(time.time()),
1097
+ "owned_by": "openai",
1098
+ }
1099
+ for model in model_list["models"]
1100
+ ]
1101
+
1102
+ else:
1103
+ url = app.state.config.OLLAMA_BASE_URLS[url_idx]
1104
+ try:
1105
+ r = requests.request(method="GET", url=f"{url}/api/tags")
1106
+ r.raise_for_status()
1107
+
1108
+ model_list = r.json()
1109
+
1110
+ models = [
1111
+ {
1112
+ "id": model["model"],
1113
+ "object": "model",
1114
+ "created": int(time.time()),
1115
+ "owned_by": "openai",
1116
+ }
1117
+ for model in models["models"]
1118
+ ]
1119
+ except Exception as e:
1120
+ log.exception(e)
1121
+ error_detail = "Open WebUI: Server Connection Error"
1122
+ if r is not None:
1123
+ try:
1124
+ res = r.json()
1125
+ if "error" in res:
1126
+ error_detail = f"Ollama: {res['error']}"
1127
+ except Exception:
1128
+ error_detail = f"Ollama: {e}"
1129
+
1130
+ raise HTTPException(
1131
+ status_code=r.status_code if r else 500,
1132
+ detail=error_detail,
1133
+ )
1134
+
1135
+ if user.role == "user":
1136
+ # Filter models based on user access control
1137
+ filtered_models = []
1138
+ for model in models:
1139
+ model_info = Models.get_model_by_id(model["id"])
1140
+ if model_info:
1141
+ if user.id == model_info.user_id or has_access(
1142
+ user.id, type="read", access_control=model_info.access_control
1143
+ ):
1144
+ filtered_models.append(model)
1145
+ models = filtered_models
1146
+
1147
+ return {
1148
+ "data": models,
1149
+ "object": "list",
1150
+ }
1151
+
1152
+
1153
+ class UrlForm(BaseModel):
1154
+ url: str
1155
+
1156
+
1157
+ class UploadBlobForm(BaseModel):
1158
+ filename: str
1159
+
1160
+
1161
+ def parse_huggingface_url(hf_url):
1162
+ try:
1163
+ # Parse the URL
1164
+ parsed_url = urlparse(hf_url)
1165
+
1166
+ # Get the path and split it into components
1167
+ path_components = parsed_url.path.split("/")
1168
+
1169
+ # Extract the desired output
1170
+ model_file = path_components[-1]
1171
+
1172
+ return model_file
1173
+ except ValueError:
1174
+ return None
1175
+
1176
+
1177
+ async def download_file_stream(
1178
+ ollama_url, file_url, file_path, file_name, chunk_size=1024 * 1024
1179
+ ):
1180
+ done = False
1181
+
1182
+ if os.path.exists(file_path):
1183
+ current_size = os.path.getsize(file_path)
1184
+ else:
1185
+ current_size = 0
1186
+
1187
+ headers = {"Range": f"bytes={current_size}-"} if current_size > 0 else {}
1188
+
1189
+ timeout = aiohttp.ClientTimeout(total=600) # Set the timeout
1190
+
1191
+ async with aiohttp.ClientSession(timeout=timeout, trust_env=True) as session:
1192
+ async with session.get(file_url, headers=headers) as response:
1193
+ total_size = int(response.headers.get("content-length", 0)) + current_size
1194
+
1195
+ with open(file_path, "ab+") as file:
1196
+ async for data in response.content.iter_chunked(chunk_size):
1197
+ current_size += len(data)
1198
+ file.write(data)
1199
+
1200
+ done = current_size == total_size
1201
+ progress = round((current_size / total_size) * 100, 2)
1202
+
1203
+ yield f'data: {{"progress": {progress}, "completed": {current_size}, "total": {total_size}}}\n\n'
1204
+
1205
+ if done:
1206
+ file.seek(0)
1207
+ hashed = calculate_sha256(file)
1208
+ file.seek(0)
1209
+
1210
+ url = f"{ollama_url}/api/blobs/sha256:{hashed}"
1211
+ response = requests.post(url, data=file)
1212
+
1213
+ if response.ok:
1214
+ res = {
1215
+ "done": done,
1216
+ "blob": f"sha256:{hashed}",
1217
+ "name": file_name,
1218
+ }
1219
+ os.remove(file_path)
1220
+
1221
+ yield f"data: {json.dumps(res)}\n\n"
1222
+ else:
1223
+ raise "Ollama: Could not create blob, Please try again."
1224
+
1225
+
1226
+ # url = "https://huggingface.co/TheBloke/stablelm-zephyr-3b-GGUF/resolve/main/stablelm-zephyr-3b.Q2_K.gguf"
1227
+ @app.post("/models/download")
1228
+ @app.post("/models/download/{url_idx}")
1229
+ async def download_model(
1230
+ form_data: UrlForm,
1231
+ url_idx: Optional[int] = None,
1232
+ user=Depends(get_admin_user),
1233
+ ):
1234
+ allowed_hosts = ["https://huggingface.co/", "https://github.com/"]
1235
+
1236
+ if not any(form_data.url.startswith(host) for host in allowed_hosts):
1237
+ raise HTTPException(
1238
+ status_code=400,
1239
+ detail="Invalid file_url. Only URLs from allowed hosts are permitted.",
1240
+ )
1241
+
1242
+ if url_idx is None:
1243
+ url_idx = 0
1244
+ url = app.state.config.OLLAMA_BASE_URLS[url_idx]
1245
+
1246
+ file_name = parse_huggingface_url(form_data.url)
1247
+
1248
+ if file_name:
1249
+ file_path = f"{UPLOAD_DIR}/{file_name}"
1250
+
1251
+ return StreamingResponse(
1252
+ download_file_stream(url, form_data.url, file_path, file_name),
1253
+ )
1254
+ else:
1255
+ return None
1256
+
1257
+
1258
+ @app.post("/models/upload")
1259
+ @app.post("/models/upload/{url_idx}")
1260
+ def upload_model(
1261
+ file: UploadFile = File(...),
1262
+ url_idx: Optional[int] = None,
1263
+ user=Depends(get_admin_user),
1264
+ ):
1265
+ if url_idx is None:
1266
+ url_idx = 0
1267
+ ollama_url = app.state.config.OLLAMA_BASE_URLS[url_idx]
1268
+
1269
+ file_path = f"{UPLOAD_DIR}/{file.filename}"
1270
+
1271
+ # Save file in chunks
1272
+ with open(file_path, "wb+") as f:
1273
+ for chunk in file.file:
1274
+ f.write(chunk)
1275
+
1276
+ def file_process_stream():
1277
+ nonlocal ollama_url
1278
+ total_size = os.path.getsize(file_path)
1279
+ chunk_size = 1024 * 1024
1280
+ try:
1281
+ with open(file_path, "rb") as f:
1282
+ total = 0
1283
+ done = False
1284
+
1285
+ while not done:
1286
+ chunk = f.read(chunk_size)
1287
+ if not chunk:
1288
+ done = True
1289
+ continue
1290
+
1291
+ total += len(chunk)
1292
+ progress = round((total / total_size) * 100, 2)
1293
+
1294
+ res = {
1295
+ "progress": progress,
1296
+ "total": total_size,
1297
+ "completed": total,
1298
+ }
1299
+ yield f"data: {json.dumps(res)}\n\n"
1300
+
1301
+ if done:
1302
+ f.seek(0)
1303
+ hashed = calculate_sha256(f)
1304
+ f.seek(0)
1305
+
1306
+ url = f"{ollama_url}/api/blobs/sha256:{hashed}"
1307
+ response = requests.post(url, data=f)
1308
+
1309
+ if response.ok:
1310
+ res = {
1311
+ "done": done,
1312
+ "blob": f"sha256:{hashed}",
1313
+ "name": file.filename,
1314
+ }
1315
+ os.remove(file_path)
1316
+ yield f"data: {json.dumps(res)}\n\n"
1317
+ else:
1318
+ raise Exception(
1319
+ "Ollama: Could not create blob, Please try again."
1320
+ )
1321
+
1322
+ except Exception as e:
1323
+ res = {"error": str(e)}
1324
+ yield f"data: {json.dumps(res)}\n\n"
1325
+
1326
+ return StreamingResponse(file_process_stream(), media_type="text/event-stream")
backend/open_webui/apps/openai/main.py ADDED
@@ -0,0 +1,720 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ import asyncio
2
+ import hashlib
3
+ import json
4
+ import logging
5
+ from pathlib import Path
6
+ from typing import Literal, Optional, overload
7
+
8
+ import aiohttp
9
+ from aiocache import cached
10
+ import requests
11
+
12
+
13
+ from open_webui.apps.webui.models.models import Models
14
+ from open_webui.config import (
15
+ CACHE_DIR,
16
+ CORS_ALLOW_ORIGIN,
17
+ ENABLE_OPENAI_API,
18
+ OPENAI_API_BASE_URLS,
19
+ OPENAI_API_KEYS,
20
+ OPENAI_API_CONFIGS,
21
+ AppConfig,
22
+ )
23
+ from open_webui.env import (
24
+ AIOHTTP_CLIENT_TIMEOUT,
25
+ AIOHTTP_CLIENT_TIMEOUT_OPENAI_MODEL_LIST,
26
+ ENABLE_FORWARD_USER_INFO_HEADERS,
27
+ )
28
+
29
+ from open_webui.constants import ERROR_MESSAGES
30
+ from open_webui.env import ENV, SRC_LOG_LEVELS
31
+ from fastapi import Depends, FastAPI, HTTPException, Request
32
+ from fastapi.middleware.cors import CORSMiddleware
33
+ from fastapi.responses import FileResponse, StreamingResponse
34
+ from pydantic import BaseModel
35
+ from starlette.background import BackgroundTask
36
+
37
+ from open_webui.utils.payload import (
38
+ apply_model_params_to_body_openai,
39
+ apply_model_system_prompt_to_body,
40
+ )
41
+
42
+ from open_webui.utils.utils import get_admin_user, get_verified_user
43
+ from open_webui.utils.access_control import has_access
44
+
45
+
46
+ log = logging.getLogger(__name__)
47
+ log.setLevel(SRC_LOG_LEVELS["OPENAI"])
48
+
49
+
50
+ app = FastAPI(
51
+ docs_url="/docs" if ENV == "dev" else None,
52
+ openapi_url="/openapi.json" if ENV == "dev" else None,
53
+ redoc_url=None,
54
+ )
55
+
56
+
57
+ app.add_middleware(
58
+ CORSMiddleware,
59
+ allow_origins=CORS_ALLOW_ORIGIN,
60
+ allow_credentials=True,
61
+ allow_methods=["*"],
62
+ allow_headers=["*"],
63
+ )
64
+
65
+ app.state.config = AppConfig()
66
+
67
+ app.state.config.ENABLE_OPENAI_API = ENABLE_OPENAI_API
68
+ app.state.config.OPENAI_API_BASE_URLS = OPENAI_API_BASE_URLS
69
+ app.state.config.OPENAI_API_KEYS = OPENAI_API_KEYS
70
+ app.state.config.OPENAI_API_CONFIGS = OPENAI_API_CONFIGS
71
+
72
+
73
+ @app.get("/config")
74
+ async def get_config(user=Depends(get_admin_user)):
75
+ return {
76
+ "ENABLE_OPENAI_API": app.state.config.ENABLE_OPENAI_API,
77
+ "OPENAI_API_BASE_URLS": app.state.config.OPENAI_API_BASE_URLS,
78
+ "OPENAI_API_KEYS": app.state.config.OPENAI_API_KEYS,
79
+ "OPENAI_API_CONFIGS": app.state.config.OPENAI_API_CONFIGS,
80
+ }
81
+
82
+
83
+ class OpenAIConfigForm(BaseModel):
84
+ ENABLE_OPENAI_API: Optional[bool] = None
85
+ OPENAI_API_BASE_URLS: list[str]
86
+ OPENAI_API_KEYS: list[str]
87
+ OPENAI_API_CONFIGS: dict
88
+
89
+
90
+ @app.post("/config/update")
91
+ async def update_config(form_data: OpenAIConfigForm, user=Depends(get_admin_user)):
92
+ app.state.config.ENABLE_OPENAI_API = form_data.ENABLE_OPENAI_API
93
+
94
+ app.state.config.OPENAI_API_BASE_URLS = form_data.OPENAI_API_BASE_URLS
95
+ app.state.config.OPENAI_API_KEYS = form_data.OPENAI_API_KEYS
96
+
97
+ # Check if API KEYS length is same than API URLS length
98
+ if len(app.state.config.OPENAI_API_KEYS) != len(
99
+ app.state.config.OPENAI_API_BASE_URLS
100
+ ):
101
+ if len(app.state.config.OPENAI_API_KEYS) > len(
102
+ app.state.config.OPENAI_API_BASE_URLS
103
+ ):
104
+ app.state.config.OPENAI_API_KEYS = app.state.config.OPENAI_API_KEYS[
105
+ : len(app.state.config.OPENAI_API_BASE_URLS)
106
+ ]
107
+ else:
108
+ app.state.config.OPENAI_API_KEYS += [""] * (
109
+ len(app.state.config.OPENAI_API_BASE_URLS)
110
+ - len(app.state.config.OPENAI_API_KEYS)
111
+ )
112
+
113
+ app.state.config.OPENAI_API_CONFIGS = form_data.OPENAI_API_CONFIGS
114
+
115
+ # Remove any extra configs
116
+ config_urls = app.state.config.OPENAI_API_CONFIGS.keys()
117
+ for idx, url in enumerate(app.state.config.OPENAI_API_BASE_URLS):
118
+ if url not in config_urls:
119
+ app.state.config.OPENAI_API_CONFIGS.pop(url, None)
120
+
121
+ return {
122
+ "ENABLE_OPENAI_API": app.state.config.ENABLE_OPENAI_API,
123
+ "OPENAI_API_BASE_URLS": app.state.config.OPENAI_API_BASE_URLS,
124
+ "OPENAI_API_KEYS": app.state.config.OPENAI_API_KEYS,
125
+ "OPENAI_API_CONFIGS": app.state.config.OPENAI_API_CONFIGS,
126
+ }
127
+
128
+
129
+ @app.post("/audio/speech")
130
+ async def speech(request: Request, user=Depends(get_verified_user)):
131
+ idx = None
132
+ try:
133
+ idx = app.state.config.OPENAI_API_BASE_URLS.index("https://api.openai.com/v1")
134
+ body = await request.body()
135
+ name = hashlib.sha256(body).hexdigest()
136
+
137
+ SPEECH_CACHE_DIR = Path(CACHE_DIR).joinpath("./audio/speech/")
138
+ SPEECH_CACHE_DIR.mkdir(parents=True, exist_ok=True)
139
+ file_path = SPEECH_CACHE_DIR.joinpath(f"{name}.mp3")
140
+ file_body_path = SPEECH_CACHE_DIR.joinpath(f"{name}.json")
141
+
142
+ # Check if the file already exists in the cache
143
+ if file_path.is_file():
144
+ return FileResponse(file_path)
145
+
146
+ headers = {}
147
+ headers["Authorization"] = f"Bearer {app.state.config.OPENAI_API_KEYS[idx]}"
148
+ headers["Content-Type"] = "application/json"
149
+ if "openrouter.ai" in app.state.config.OPENAI_API_BASE_URLS[idx]:
150
+ headers["HTTP-Referer"] = "https://openwebui.com/"
151
+ headers["X-Title"] = "Open WebUI"
152
+ if ENABLE_FORWARD_USER_INFO_HEADERS:
153
+ headers["X-OpenWebUI-User-Name"] = user.name
154
+ headers["X-OpenWebUI-User-Id"] = user.id
155
+ headers["X-OpenWebUI-User-Email"] = user.email
156
+ headers["X-OpenWebUI-User-Role"] = user.role
157
+ r = None
158
+ try:
159
+ r = requests.post(
160
+ url=f"{app.state.config.OPENAI_API_BASE_URLS[idx]}/audio/speech",
161
+ data=body,
162
+ headers=headers,
163
+ stream=True,
164
+ )
165
+
166
+ r.raise_for_status()
167
+
168
+ # Save the streaming content to a file
169
+ with open(file_path, "wb") as f:
170
+ for chunk in r.iter_content(chunk_size=8192):
171
+ f.write(chunk)
172
+
173
+ with open(file_body_path, "w") as f:
174
+ json.dump(json.loads(body.decode("utf-8")), f)
175
+
176
+ # Return the saved file
177
+ return FileResponse(file_path)
178
+
179
+ except Exception as e:
180
+ log.exception(e)
181
+ error_detail = "Open WebUI: Server Connection Error"
182
+ if r is not None:
183
+ try:
184
+ res = r.json()
185
+ if "error" in res:
186
+ error_detail = f"External: {res['error']}"
187
+ except Exception:
188
+ error_detail = f"External: {e}"
189
+
190
+ raise HTTPException(
191
+ status_code=r.status_code if r else 500, detail=error_detail
192
+ )
193
+
194
+ except ValueError:
195
+ raise HTTPException(status_code=401, detail=ERROR_MESSAGES.OPENAI_NOT_FOUND)
196
+
197
+
198
+ async def aiohttp_get(url, key=None):
199
+ timeout = aiohttp.ClientTimeout(total=AIOHTTP_CLIENT_TIMEOUT_OPENAI_MODEL_LIST)
200
+ try:
201
+ headers = {"Authorization": f"Bearer {key}"} if key else {}
202
+ async with aiohttp.ClientSession(timeout=timeout, trust_env=True) as session:
203
+ async with session.get(url, headers=headers) as response:
204
+ return await response.json()
205
+ except Exception as e:
206
+ # Handle connection error here
207
+ log.error(f"Connection error: {e}")
208
+ return None
209
+
210
+
211
+ async def cleanup_response(
212
+ response: Optional[aiohttp.ClientResponse],
213
+ session: Optional[aiohttp.ClientSession],
214
+ ):
215
+ if response:
216
+ response.close()
217
+ if session:
218
+ await session.close()
219
+
220
+
221
+ def merge_models_lists(model_lists):
222
+ log.debug(f"merge_models_lists {model_lists}")
223
+ merged_list = []
224
+
225
+ for idx, models in enumerate(model_lists):
226
+ if models is not None and "error" not in models:
227
+ merged_list.extend(
228
+ [
229
+ {
230
+ **model,
231
+ "name": model.get("name", model["id"]),
232
+ "owned_by": "openai",
233
+ "openai": model,
234
+ "urlIdx": idx,
235
+ }
236
+ for model in models
237
+ if "api.openai.com"
238
+ not in app.state.config.OPENAI_API_BASE_URLS[idx]
239
+ or not any(
240
+ name in model["id"]
241
+ for name in [
242
+ "babbage",
243
+ "dall-e",
244
+ "davinci",
245
+ "embedding",
246
+ "tts",
247
+ "whisper",
248
+ ]
249
+ )
250
+ ]
251
+ )
252
+
253
+ return merged_list
254
+
255
+
256
+ async def get_all_models_responses() -> list:
257
+ if not app.state.config.ENABLE_OPENAI_API:
258
+ return []
259
+
260
+ # Check if API KEYS length is same than API URLS length
261
+ num_urls = len(app.state.config.OPENAI_API_BASE_URLS)
262
+ num_keys = len(app.state.config.OPENAI_API_KEYS)
263
+
264
+ if num_keys != num_urls:
265
+ # if there are more keys than urls, remove the extra keys
266
+ if num_keys > num_urls:
267
+ new_keys = app.state.config.OPENAI_API_KEYS[:num_urls]
268
+ app.state.config.OPENAI_API_KEYS = new_keys
269
+ # if there are more urls than keys, add empty keys
270
+ else:
271
+ app.state.config.OPENAI_API_KEYS += [""] * (num_urls - num_keys)
272
+
273
+ tasks = []
274
+ for idx, url in enumerate(app.state.config.OPENAI_API_BASE_URLS):
275
+ if url not in app.state.config.OPENAI_API_CONFIGS:
276
+ tasks.append(
277
+ aiohttp_get(f"{url}/models", app.state.config.OPENAI_API_KEYS[idx])
278
+ )
279
+ else:
280
+ api_config = app.state.config.OPENAI_API_CONFIGS.get(url, {})
281
+
282
+ enable = api_config.get("enable", True)
283
+ model_ids = api_config.get("model_ids", [])
284
+
285
+ if enable:
286
+ if len(model_ids) == 0:
287
+ tasks.append(
288
+ aiohttp_get(
289
+ f"{url}/models", app.state.config.OPENAI_API_KEYS[idx]
290
+ )
291
+ )
292
+ else:
293
+ model_list = {
294
+ "object": "list",
295
+ "data": [
296
+ {
297
+ "id": model_id,
298
+ "name": model_id,
299
+ "owned_by": "openai",
300
+ "openai": {"id": model_id},
301
+ "urlIdx": idx,
302
+ }
303
+ for model_id in model_ids
304
+ ],
305
+ }
306
+
307
+ tasks.append(asyncio.ensure_future(asyncio.sleep(0, model_list)))
308
+ else:
309
+ tasks.append(asyncio.ensure_future(asyncio.sleep(0, None)))
310
+
311
+ responses = await asyncio.gather(*tasks)
312
+
313
+ for idx, response in enumerate(responses):
314
+ if response:
315
+ url = app.state.config.OPENAI_API_BASE_URLS[idx]
316
+ api_config = app.state.config.OPENAI_API_CONFIGS.get(url, {})
317
+
318
+ prefix_id = api_config.get("prefix_id", None)
319
+
320
+ if prefix_id:
321
+ for model in (
322
+ response if isinstance(response, list) else response.get("data", [])
323
+ ):
324
+ model["id"] = f"{prefix_id}.{model['id']}"
325
+
326
+ log.debug(f"get_all_models:responses() {responses}")
327
+
328
+ return responses
329
+
330
+
331
+ @cached(ttl=3)
332
+ async def get_all_models() -> dict[str, list]:
333
+ log.info("get_all_models()")
334
+
335
+ if not app.state.config.ENABLE_OPENAI_API:
336
+ return {"data": []}
337
+
338
+ responses = await get_all_models_responses()
339
+
340
+ def extract_data(response):
341
+ if response and "data" in response:
342
+ return response["data"]
343
+ if isinstance(response, list):
344
+ return response
345
+ return None
346
+
347
+ models = {"data": merge_models_lists(map(extract_data, responses))}
348
+ log.debug(f"models: {models}")
349
+
350
+ return models
351
+
352
+
353
+ @app.get("/models")
354
+ @app.get("/models/{url_idx}")
355
+ async def get_models(url_idx: Optional[int] = None, user=Depends(get_verified_user)):
356
+ models = {
357
+ "data": [],
358
+ }
359
+
360
+ if url_idx is None:
361
+ models = await get_all_models()
362
+ else:
363
+ url = app.state.config.OPENAI_API_BASE_URLS[url_idx]
364
+ key = app.state.config.OPENAI_API_KEYS[url_idx]
365
+
366
+ headers = {}
367
+ headers["Authorization"] = f"Bearer {key}"
368
+ headers["Content-Type"] = "application/json"
369
+
370
+ if ENABLE_FORWARD_USER_INFO_HEADERS:
371
+ headers["X-OpenWebUI-User-Name"] = user.name
372
+ headers["X-OpenWebUI-User-Id"] = user.id
373
+ headers["X-OpenWebUI-User-Email"] = user.email
374
+ headers["X-OpenWebUI-User-Role"] = user.role
375
+
376
+ r = None
377
+
378
+ timeout = aiohttp.ClientTimeout(total=AIOHTTP_CLIENT_TIMEOUT_OPENAI_MODEL_LIST)
379
+ async with aiohttp.ClientSession(timeout=timeout) as session:
380
+ try:
381
+ async with session.get(f"{url}/models", headers=headers) as r:
382
+ if r.status != 200:
383
+ # Extract response error details if available
384
+ error_detail = f"HTTP Error: {r.status}"
385
+ res = await r.json()
386
+ if "error" in res:
387
+ error_detail = f"External Error: {res['error']}"
388
+ raise Exception(error_detail)
389
+
390
+ response_data = await r.json()
391
+
392
+ # Check if we're calling OpenAI API based on the URL
393
+ if "api.openai.com" in url:
394
+ # Filter models according to the specified conditions
395
+ response_data["data"] = [
396
+ model
397
+ for model in response_data.get("data", [])
398
+ if not any(
399
+ name in model["id"]
400
+ for name in [
401
+ "babbage",
402
+ "dall-e",
403
+ "davinci",
404
+ "embedding",
405
+ "tts",
406
+ "whisper",
407
+ ]
408
+ )
409
+ ]
410
+
411
+ models = response_data
412
+ except aiohttp.ClientError as e:
413
+ # ClientError covers all aiohttp requests issues
414
+ log.exception(f"Client error: {str(e)}")
415
+ # Handle aiohttp-specific connection issues, timeout etc.
416
+ raise HTTPException(
417
+ status_code=500, detail="Open WebUI: Server Connection Error"
418
+ )
419
+ except Exception as e:
420
+ log.exception(f"Unexpected error: {e}")
421
+ # Generic error handler in case parsing JSON or other steps fail
422
+ error_detail = f"Unexpected error: {str(e)}"
423
+ raise HTTPException(status_code=500, detail=error_detail)
424
+
425
+ if user.role == "user":
426
+ # Filter models based on user access control
427
+ filtered_models = []
428
+ for model in models.get("data", []):
429
+ model_info = Models.get_model_by_id(model["id"])
430
+ if model_info:
431
+ if user.id == model_info.user_id or has_access(
432
+ user.id, type="read", access_control=model_info.access_control
433
+ ):
434
+ filtered_models.append(model)
435
+ models["data"] = filtered_models
436
+
437
+ return models
438
+
439
+
440
+ class ConnectionVerificationForm(BaseModel):
441
+ url: str
442
+ key: str
443
+
444
+
445
+ @app.post("/verify")
446
+ async def verify_connection(
447
+ form_data: ConnectionVerificationForm, user=Depends(get_admin_user)
448
+ ):
449
+ url = form_data.url
450
+ key = form_data.key
451
+
452
+ headers = {}
453
+ headers["Authorization"] = f"Bearer {key}"
454
+ headers["Content-Type"] = "application/json"
455
+
456
+ timeout = aiohttp.ClientTimeout(total=AIOHTTP_CLIENT_TIMEOUT_OPENAI_MODEL_LIST)
457
+ async with aiohttp.ClientSession(timeout=timeout) as session:
458
+ try:
459
+ async with session.get(f"{url}/models", headers=headers) as r:
460
+ if r.status != 200:
461
+ # Extract response error details if available
462
+ error_detail = f"HTTP Error: {r.status}"
463
+ res = await r.json()
464
+ if "error" in res:
465
+ error_detail = f"External Error: {res['error']}"
466
+ raise Exception(error_detail)
467
+
468
+ response_data = await r.json()
469
+ return response_data
470
+
471
+ except aiohttp.ClientError as e:
472
+ # ClientError covers all aiohttp requests issues
473
+ log.exception(f"Client error: {str(e)}")
474
+ # Handle aiohttp-specific connection issues, timeout etc.
475
+ raise HTTPException(
476
+ status_code=500, detail="Open WebUI: Server Connection Error"
477
+ )
478
+ except Exception as e:
479
+ log.exception(f"Unexpected error: {e}")
480
+ # Generic error handler in case parsing JSON or other steps fail
481
+ error_detail = f"Unexpected error: {str(e)}"
482
+ raise HTTPException(status_code=500, detail=error_detail)
483
+
484
+
485
+ @app.post("/chat/completions")
486
+ async def generate_chat_completion(
487
+ form_data: dict,
488
+ user=Depends(get_verified_user),
489
+ bypass_filter: Optional[bool] = False,
490
+ ):
491
+ idx = 0
492
+ payload = {**form_data}
493
+
494
+ if "metadata" in payload:
495
+ del payload["metadata"]
496
+
497
+ model_id = form_data.get("model")
498
+ model_info = Models.get_model_by_id(model_id)
499
+
500
+ # Check model info and override the payload
501
+ if model_info:
502
+ if model_info.base_model_id:
503
+ payload["model"] = model_info.base_model_id
504
+
505
+ params = model_info.params.model_dump()
506
+ payload = apply_model_params_to_body_openai(params, payload)
507
+ payload = apply_model_system_prompt_to_body(params, payload, user)
508
+
509
+ # Check if user has access to the model
510
+ if not bypass_filter and user.role == "user":
511
+ if not (
512
+ user.id == model_info.user_id
513
+ or has_access(
514
+ user.id, type="read", access_control=model_info.access_control
515
+ )
516
+ ):
517
+ raise HTTPException(
518
+ status_code=403,
519
+ detail="Model not found",
520
+ )
521
+ elif not bypass_filter:
522
+ if user.role != "admin":
523
+ raise HTTPException(
524
+ status_code=403,
525
+ detail="Model not found",
526
+ )
527
+
528
+ # Attemp to get urlIdx from the model
529
+ models = await get_all_models()
530
+
531
+ # Find the model from the list
532
+ model = next(
533
+ (model for model in models["data"] if model["id"] == payload.get("model")),
534
+ None,
535
+ )
536
+
537
+ if model:
538
+ idx = model["urlIdx"]
539
+ else:
540
+ raise HTTPException(
541
+ status_code=404,
542
+ detail="Model not found",
543
+ )
544
+
545
+ # Get the API config for the model
546
+ api_config = app.state.config.OPENAI_API_CONFIGS.get(
547
+ app.state.config.OPENAI_API_BASE_URLS[idx], {}
548
+ )
549
+ prefix_id = api_config.get("prefix_id", None)
550
+
551
+ if prefix_id:
552
+ payload["model"] = payload["model"].replace(f"{prefix_id}.", "")
553
+
554
+ # Add user info to the payload if the model is a pipeline
555
+ if "pipeline" in model and model.get("pipeline"):
556
+ payload["user"] = {
557
+ "name": user.name,
558
+ "id": user.id,
559
+ "email": user.email,
560
+ "role": user.role,
561
+ }
562
+
563
+ url = app.state.config.OPENAI_API_BASE_URLS[idx]
564
+ key = app.state.config.OPENAI_API_KEYS[idx]
565
+
566
+ # Fix: O1 does not support the "max_tokens" parameter, Modify "max_tokens" to "max_completion_tokens"
567
+ is_o1 = payload["model"].lower().startswith("o1-")
568
+ # Change max_completion_tokens to max_tokens (Backward compatible)
569
+ if "api.openai.com" not in url and not is_o1:
570
+ if "max_completion_tokens" in payload:
571
+ # Remove "max_completion_tokens" from the payload
572
+ payload["max_tokens"] = payload["max_completion_tokens"]
573
+ del payload["max_completion_tokens"]
574
+ else:
575
+ if is_o1 and "max_tokens" in payload:
576
+ payload["max_completion_tokens"] = payload["max_tokens"]
577
+ del payload["max_tokens"]
578
+ if "max_tokens" in payload and "max_completion_tokens" in payload:
579
+ del payload["max_tokens"]
580
+
581
+ # Fix: O1 does not support the "system" parameter, Modify "system" to "user"
582
+ if is_o1 and payload["messages"][0]["role"] == "system":
583
+ payload["messages"][0]["role"] = "user"
584
+
585
+ # Convert the modified body back to JSON
586
+ payload = json.dumps(payload)
587
+
588
+ log.debug(payload)
589
+
590
+ headers = {}
591
+ headers["Authorization"] = f"Bearer {key}"
592
+ headers["Content-Type"] = "application/json"
593
+ if "openrouter.ai" in app.state.config.OPENAI_API_BASE_URLS[idx]:
594
+ headers["HTTP-Referer"] = "https://openwebui.com/"
595
+ headers["X-Title"] = "Open WebUI"
596
+ if ENABLE_FORWARD_USER_INFO_HEADERS:
597
+ headers["X-OpenWebUI-User-Name"] = user.name
598
+ headers["X-OpenWebUI-User-Id"] = user.id
599
+ headers["X-OpenWebUI-User-Email"] = user.email
600
+ headers["X-OpenWebUI-User-Role"] = user.role
601
+
602
+ r = None
603
+ session = None
604
+ streaming = False
605
+ response = None
606
+
607
+ try:
608
+ session = aiohttp.ClientSession(
609
+ trust_env=True, timeout=aiohttp.ClientTimeout(total=AIOHTTP_CLIENT_TIMEOUT)
610
+ )
611
+ r = await session.request(
612
+ method="POST",
613
+ url=f"{url}/chat/completions",
614
+ data=payload,
615
+ headers=headers,
616
+ )
617
+
618
+ # Check if response is SSE
619
+ if "text/event-stream" in r.headers.get("Content-Type", ""):
620
+ streaming = True
621
+ return StreamingResponse(
622
+ r.content,
623
+ status_code=r.status,
624
+ headers=dict(r.headers),
625
+ background=BackgroundTask(
626
+ cleanup_response, response=r, session=session
627
+ ),
628
+ )
629
+ else:
630
+ try:
631
+ response = await r.json()
632
+ except Exception as e:
633
+ log.error(e)
634
+ response = await r.text()
635
+
636
+ r.raise_for_status()
637
+ return response
638
+ except Exception as e:
639
+ log.exception(e)
640
+ error_detail = "Open WebUI: Server Connection Error"
641
+ if isinstance(response, dict):
642
+ if "error" in response:
643
+ error_detail = f"{response['error']['message'] if 'message' in response['error'] else response['error']}"
644
+ elif isinstance(response, str):
645
+ error_detail = response
646
+
647
+ raise HTTPException(status_code=r.status if r else 500, detail=error_detail)
648
+ finally:
649
+ if not streaming and session:
650
+ if r:
651
+ r.close()
652
+ await session.close()
653
+
654
+
655
+ @app.api_route("/{path:path}", methods=["GET", "POST", "PUT", "DELETE"])
656
+ async def proxy(path: str, request: Request, user=Depends(get_verified_user)):
657
+ idx = 0
658
+
659
+ body = await request.body()
660
+
661
+ url = app.state.config.OPENAI_API_BASE_URLS[idx]
662
+ key = app.state.config.OPENAI_API_KEYS[idx]
663
+
664
+ target_url = f"{url}/{path}"
665
+
666
+ headers = {}
667
+ headers["Authorization"] = f"Bearer {key}"
668
+ headers["Content-Type"] = "application/json"
669
+ if ENABLE_FORWARD_USER_INFO_HEADERS:
670
+ headers["X-OpenWebUI-User-Name"] = user.name
671
+ headers["X-OpenWebUI-User-Id"] = user.id
672
+ headers["X-OpenWebUI-User-Email"] = user.email
673
+ headers["X-OpenWebUI-User-Role"] = user.role
674
+
675
+ r = None
676
+ session = None
677
+ streaming = False
678
+
679
+ try:
680
+ session = aiohttp.ClientSession(trust_env=True)
681
+ r = await session.request(
682
+ method=request.method,
683
+ url=target_url,
684
+ data=body,
685
+ headers=headers,
686
+ )
687
+
688
+ r.raise_for_status()
689
+
690
+ # Check if response is SSE
691
+ if "text/event-stream" in r.headers.get("Content-Type", ""):
692
+ streaming = True
693
+ return StreamingResponse(
694
+ r.content,
695
+ status_code=r.status,
696
+ headers=dict(r.headers),
697
+ background=BackgroundTask(
698
+ cleanup_response, response=r, session=session
699
+ ),
700
+ )
701
+ else:
702
+ response_data = await r.json()
703
+ return response_data
704
+ except Exception as e:
705
+ log.exception(e)
706
+ error_detail = "Open WebUI: Server Connection Error"
707
+ if r is not None:
708
+ try:
709
+ res = await r.json()
710
+ print(res)
711
+ if "error" in res:
712
+ error_detail = f"External: {res['error']['message'] if 'message' in res['error'] else res['error']}"
713
+ except Exception:
714
+ error_detail = f"External: {e}"
715
+ raise HTTPException(status_code=r.status if r else 500, detail=error_detail)
716
+ finally:
717
+ if not streaming and session:
718
+ if r:
719
+ r.close()
720
+ await session.close()
backend/open_webui/apps/retrieval/loaders/main.py ADDED
@@ -0,0 +1,190 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ import requests
2
+ import logging
3
+ import ftfy
4
+
5
+ from langchain_community.document_loaders import (
6
+ BSHTMLLoader,
7
+ CSVLoader,
8
+ Docx2txtLoader,
9
+ OutlookMessageLoader,
10
+ PyPDFLoader,
11
+ TextLoader,
12
+ UnstructuredEPubLoader,
13
+ UnstructuredExcelLoader,
14
+ UnstructuredMarkdownLoader,
15
+ UnstructuredPowerPointLoader,
16
+ UnstructuredRSTLoader,
17
+ UnstructuredXMLLoader,
18
+ YoutubeLoader,
19
+ )
20
+ from langchain_core.documents import Document
21
+ from open_webui.env import SRC_LOG_LEVELS
22
+
23
+ log = logging.getLogger(__name__)
24
+ log.setLevel(SRC_LOG_LEVELS["RAG"])
25
+
26
+ known_source_ext = [
27
+ "go",
28
+ "py",
29
+ "java",
30
+ "sh",
31
+ "bat",
32
+ "ps1",
33
+ "cmd",
34
+ "js",
35
+ "ts",
36
+ "css",
37
+ "cpp",
38
+ "hpp",
39
+ "h",
40
+ "c",
41
+ "cs",
42
+ "sql",
43
+ "log",
44
+ "ini",
45
+ "pl",
46
+ "pm",
47
+ "r",
48
+ "dart",
49
+ "dockerfile",
50
+ "env",
51
+ "php",
52
+ "hs",
53
+ "hsc",
54
+ "lua",
55
+ "nginxconf",
56
+ "conf",
57
+ "m",
58
+ "mm",
59
+ "plsql",
60
+ "perl",
61
+ "rb",
62
+ "rs",
63
+ "db2",
64
+ "scala",
65
+ "bash",
66
+ "swift",
67
+ "vue",
68
+ "svelte",
69
+ "msg",
70
+ "ex",
71
+ "exs",
72
+ "erl",
73
+ "tsx",
74
+ "jsx",
75
+ "hs",
76
+ "lhs",
77
+ ]
78
+
79
+
80
+ class TikaLoader:
81
+ def __init__(self, url, file_path, mime_type=None):
82
+ self.url = url
83
+ self.file_path = file_path
84
+ self.mime_type = mime_type
85
+
86
+ def load(self) -> list[Document]:
87
+ with open(self.file_path, "rb") as f:
88
+ data = f.read()
89
+
90
+ if self.mime_type is not None:
91
+ headers = {"Content-Type": self.mime_type}
92
+ else:
93
+ headers = {}
94
+
95
+ endpoint = self.url
96
+ if not endpoint.endswith("/"):
97
+ endpoint += "/"
98
+ endpoint += "tika/text"
99
+
100
+ r = requests.put(endpoint, data=data, headers=headers)
101
+
102
+ if r.ok:
103
+ raw_metadata = r.json()
104
+ text = raw_metadata.get("X-TIKA:content", "<No text content found>")
105
+
106
+ if "Content-Type" in raw_metadata:
107
+ headers["Content-Type"] = raw_metadata["Content-Type"]
108
+
109
+ log.info("Tika extracted text: %s", text)
110
+
111
+ return [Document(page_content=text, metadata=headers)]
112
+ else:
113
+ raise Exception(f"Error calling Tika: {r.reason}")
114
+
115
+
116
+ class Loader:
117
+ def __init__(self, engine: str = "", **kwargs):
118
+ self.engine = engine
119
+ self.kwargs = kwargs
120
+
121
+ def load(
122
+ self, filename: str, file_content_type: str, file_path: str
123
+ ) -> list[Document]:
124
+ loader = self._get_loader(filename, file_content_type, file_path)
125
+ docs = loader.load()
126
+
127
+ return [
128
+ Document(
129
+ page_content=ftfy.fix_text(doc.page_content), metadata=doc.metadata
130
+ )
131
+ for doc in docs
132
+ ]
133
+
134
+ def _get_loader(self, filename: str, file_content_type: str, file_path: str):
135
+ file_ext = filename.split(".")[-1].lower()
136
+
137
+ if self.engine == "tika" and self.kwargs.get("TIKA_SERVER_URL"):
138
+ if file_ext in known_source_ext or (
139
+ file_content_type and file_content_type.find("text/") >= 0
140
+ ):
141
+ loader = TextLoader(file_path, autodetect_encoding=True)
142
+ else:
143
+ loader = TikaLoader(
144
+ url=self.kwargs.get("TIKA_SERVER_URL"),
145
+ file_path=file_path,
146
+ mime_type=file_content_type,
147
+ )
148
+ else:
149
+ if file_ext == "pdf":
150
+ loader = PyPDFLoader(
151
+ file_path, extract_images=self.kwargs.get("PDF_EXTRACT_IMAGES")
152
+ )
153
+ elif file_ext == "csv":
154
+ loader = CSVLoader(file_path)
155
+ elif file_ext == "rst":
156
+ loader = UnstructuredRSTLoader(file_path, mode="elements")
157
+ elif file_ext == "xml":
158
+ loader = UnstructuredXMLLoader(file_path)
159
+ elif file_ext in ["htm", "html"]:
160
+ loader = BSHTMLLoader(file_path, open_encoding="unicode_escape")
161
+ elif file_ext == "md":
162
+ loader = TextLoader(file_path, autodetect_encoding=True)
163
+ elif file_content_type == "application/epub+zip":
164
+ loader = UnstructuredEPubLoader(file_path)
165
+ elif (
166
+ file_content_type
167
+ == "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
168
+ or file_ext == "docx"
169
+ ):
170
+ loader = Docx2txtLoader(file_path)
171
+ elif file_content_type in [
172
+ "application/vnd.ms-excel",
173
+ "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
174
+ ] or file_ext in ["xls", "xlsx"]:
175
+ loader = UnstructuredExcelLoader(file_path)
176
+ elif file_content_type in [
177
+ "application/vnd.ms-powerpoint",
178
+ "application/vnd.openxmlformats-officedocument.presentationml.presentation",
179
+ ] or file_ext in ["ppt", "pptx"]:
180
+ loader = UnstructuredPowerPointLoader(file_path)
181
+ elif file_ext == "msg":
182
+ loader = OutlookMessageLoader(file_path)
183
+ elif file_ext in known_source_ext or (
184
+ file_content_type and file_content_type.find("text/") >= 0
185
+ ):
186
+ loader = TextLoader(file_path, autodetect_encoding=True)
187
+ else:
188
+ loader = TextLoader(file_path, autodetect_encoding=True)
189
+
190
+ return loader
backend/open_webui/apps/retrieval/loaders/youtube.py ADDED
@@ -0,0 +1,98 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ from typing import Any, Dict, Generator, List, Optional, Sequence, Union
2
+ from urllib.parse import parse_qs, urlparse
3
+ from langchain_core.documents import Document
4
+
5
+
6
+ ALLOWED_SCHEMES = {"http", "https"}
7
+ ALLOWED_NETLOCS = {
8
+ "youtu.be",
9
+ "m.youtube.com",
10
+ "youtube.com",
11
+ "www.youtube.com",
12
+ "www.youtube-nocookie.com",
13
+ "vid.plus",
14
+ }
15
+
16
+
17
+ def _parse_video_id(url: str) -> Optional[str]:
18
+ """Parse a YouTube URL and return the video ID if valid, otherwise None."""
19
+ parsed_url = urlparse(url)
20
+
21
+ if parsed_url.scheme not in ALLOWED_SCHEMES:
22
+ return None
23
+
24
+ if parsed_url.netloc not in ALLOWED_NETLOCS:
25
+ return None
26
+
27
+ path = parsed_url.path
28
+
29
+ if path.endswith("/watch"):
30
+ query = parsed_url.query
31
+ parsed_query = parse_qs(query)
32
+ if "v" in parsed_query:
33
+ ids = parsed_query["v"]
34
+ video_id = ids if isinstance(ids, str) else ids[0]
35
+ else:
36
+ return None
37
+ else:
38
+ path = parsed_url.path.lstrip("/")
39
+ video_id = path.split("/")[-1]
40
+
41
+ if len(video_id) != 11: # Video IDs are 11 characters long
42
+ return None
43
+
44
+ return video_id
45
+
46
+
47
+ class YoutubeLoader:
48
+ """Load `YouTube` video transcripts."""
49
+
50
+ def __init__(
51
+ self,
52
+ video_id: str,
53
+ language: Union[str, Sequence[str]] = "en",
54
+ ):
55
+ """Initialize with YouTube video ID."""
56
+ _video_id = _parse_video_id(video_id)
57
+ self.video_id = _video_id if _video_id is not None else video_id
58
+ self._metadata = {"source": video_id}
59
+ self.language = language
60
+ if isinstance(language, str):
61
+ self.language = [language]
62
+ else:
63
+ self.language = language
64
+
65
+ def load(self) -> List[Document]:
66
+ """Load YouTube transcripts into `Document` objects."""
67
+ try:
68
+ from youtube_transcript_api import (
69
+ NoTranscriptFound,
70
+ TranscriptsDisabled,
71
+ YouTubeTranscriptApi,
72
+ )
73
+ except ImportError:
74
+ raise ImportError(
75
+ 'Could not import "youtube_transcript_api" Python package. '
76
+ "Please install it with `pip install youtube-transcript-api`."
77
+ )
78
+
79
+ try:
80
+ transcript_list = YouTubeTranscriptApi.list_transcripts(self.video_id)
81
+ except Exception as e:
82
+ print(e)
83
+ return []
84
+
85
+ try:
86
+ transcript = transcript_list.find_transcript(self.language)
87
+ except NoTranscriptFound:
88
+ transcript = transcript_list.find_transcript(["en"])
89
+
90
+ transcript_pieces: List[Dict[str, Any]] = transcript.fetch()
91
+
92
+ transcript = " ".join(
93
+ map(
94
+ lambda transcript_piece: transcript_piece["text"].strip(" "),
95
+ transcript_pieces,
96
+ )
97
+ )
98
+ return [Document(page_content=transcript, metadata=self._metadata)]
backend/open_webui/apps/retrieval/main.py ADDED
@@ -0,0 +1,1486 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # TODO: Merge this with the webui_app and make it a single app
2
+
3
+ import json
4
+ import logging
5
+ import mimetypes
6
+ import os
7
+ import shutil
8
+
9
+ import uuid
10
+ from datetime import datetime
11
+ from pathlib import Path
12
+ from typing import Iterator, Optional, Sequence, Union
13
+
14
+ from fastapi import Depends, FastAPI, File, Form, HTTPException, UploadFile, status
15
+ from fastapi.middleware.cors import CORSMiddleware
16
+ from pydantic import BaseModel
17
+ import tiktoken
18
+
19
+
20
+ from open_webui.storage.provider import Storage
21
+ from open_webui.apps.webui.models.knowledge import Knowledges
22
+ from open_webui.apps.retrieval.vector.connector import VECTOR_DB_CLIENT
23
+
24
+ # Document loaders
25
+ from open_webui.apps.retrieval.loaders.main import Loader
26
+ from open_webui.apps.retrieval.loaders.youtube import YoutubeLoader
27
+
28
+ # Web search engines
29
+ from open_webui.apps.retrieval.web.main import SearchResult
30
+ from open_webui.apps.retrieval.web.utils import get_web_loader
31
+ from open_webui.apps.retrieval.web.brave import search_brave
32
+ from open_webui.apps.retrieval.web.mojeek import search_mojeek
33
+ from open_webui.apps.retrieval.web.duckduckgo import search_duckduckgo
34
+ from open_webui.apps.retrieval.web.google_pse import search_google_pse
35
+ from open_webui.apps.retrieval.web.jina_search import search_jina
36
+ from open_webui.apps.retrieval.web.searchapi import search_searchapi
37
+ from open_webui.apps.retrieval.web.searxng import search_searxng
38
+ from open_webui.apps.retrieval.web.serper import search_serper
39
+ from open_webui.apps.retrieval.web.serply import search_serply
40
+ from open_webui.apps.retrieval.web.serpstack import search_serpstack
41
+ from open_webui.apps.retrieval.web.tavily import search_tavily
42
+ from open_webui.apps.retrieval.web.bing import search_bing
43
+
44
+
45
+ from open_webui.apps.retrieval.utils import (
46
+ get_embedding_function,
47
+ get_model_path,
48
+ query_collection,
49
+ query_collection_with_hybrid_search,
50
+ query_doc,
51
+ query_doc_with_hybrid_search,
52
+ )
53
+
54
+ from open_webui.apps.webui.models.files import Files
55
+ from open_webui.config import (
56
+ BRAVE_SEARCH_API_KEY,
57
+ MOJEEK_SEARCH_API_KEY,
58
+ TIKTOKEN_ENCODING_NAME,
59
+ RAG_TEXT_SPLITTER,
60
+ CHUNK_OVERLAP,
61
+ CHUNK_SIZE,
62
+ CONTENT_EXTRACTION_ENGINE,
63
+ CORS_ALLOW_ORIGIN,
64
+ ENABLE_RAG_HYBRID_SEARCH,
65
+ ENABLE_RAG_LOCAL_WEB_FETCH,
66
+ ENABLE_RAG_WEB_LOADER_SSL_VERIFICATION,
67
+ ENABLE_RAG_WEB_SEARCH,
68
+ ENV,
69
+ GOOGLE_PSE_API_KEY,
70
+ GOOGLE_PSE_ENGINE_ID,
71
+ PDF_EXTRACT_IMAGES,
72
+ RAG_EMBEDDING_ENGINE,
73
+ RAG_EMBEDDING_MODEL,
74
+ RAG_EMBEDDING_MODEL_AUTO_UPDATE,
75
+ RAG_EMBEDDING_MODEL_TRUST_REMOTE_CODE,
76
+ RAG_EMBEDDING_BATCH_SIZE,
77
+ RAG_FILE_MAX_COUNT,
78
+ RAG_FILE_MAX_SIZE,
79
+ RAG_OPENAI_API_BASE_URL,
80
+ RAG_OPENAI_API_KEY,
81
+ RAG_OLLAMA_BASE_URL,
82
+ RAG_OLLAMA_API_KEY,
83
+ RAG_RELEVANCE_THRESHOLD,
84
+ RAG_RERANKING_MODEL,
85
+ RAG_RERANKING_MODEL_AUTO_UPDATE,
86
+ RAG_RERANKING_MODEL_TRUST_REMOTE_CODE,
87
+ DEFAULT_RAG_TEMPLATE,
88
+ RAG_TEMPLATE,
89
+ RAG_TOP_K,
90
+ RAG_WEB_SEARCH_CONCURRENT_REQUESTS,
91
+ RAG_WEB_SEARCH_DOMAIN_FILTER_LIST,
92
+ RAG_WEB_SEARCH_ENGINE,
93
+ RAG_WEB_SEARCH_RESULT_COUNT,
94
+ JINA_API_KEY,
95
+ SEARCHAPI_API_KEY,
96
+ SEARCHAPI_ENGINE,
97
+ SEARXNG_QUERY_URL,
98
+ SERPER_API_KEY,
99
+ SERPLY_API_KEY,
100
+ SERPSTACK_API_KEY,
101
+ SERPSTACK_HTTPS,
102
+ TAVILY_API_KEY,
103
+ BING_SEARCH_V7_ENDPOINT,
104
+ BING_SEARCH_V7_SUBSCRIPTION_KEY,
105
+ TIKA_SERVER_URL,
106
+ UPLOAD_DIR,
107
+ YOUTUBE_LOADER_LANGUAGE,
108
+ DEFAULT_LOCALE,
109
+ AppConfig,
110
+ )
111
+ from open_webui.constants import ERROR_MESSAGES
112
+ from open_webui.env import (
113
+ SRC_LOG_LEVELS,
114
+ DEVICE_TYPE,
115
+ DOCKER,
116
+ )
117
+ from open_webui.utils.misc import (
118
+ calculate_sha256,
119
+ calculate_sha256_string,
120
+ extract_folders_after_data_docs,
121
+ sanitize_filename,
122
+ )
123
+ from open_webui.utils.utils import get_admin_user, get_verified_user
124
+
125
+ from langchain.text_splitter import RecursiveCharacterTextSplitter, TokenTextSplitter
126
+ from langchain_core.documents import Document
127
+
128
+
129
+ log = logging.getLogger(__name__)
130
+ log.setLevel(SRC_LOG_LEVELS["RAG"])
131
+
132
+ app = FastAPI(
133
+ docs_url="/docs" if ENV == "dev" else None,
134
+ openapi_url="/openapi.json" if ENV == "dev" else None,
135
+ redoc_url=None,
136
+ )
137
+
138
+ app.state.config = AppConfig()
139
+
140
+ app.state.config.TOP_K = RAG_TOP_K
141
+ app.state.config.RELEVANCE_THRESHOLD = RAG_RELEVANCE_THRESHOLD
142
+ app.state.config.FILE_MAX_SIZE = RAG_FILE_MAX_SIZE
143
+ app.state.config.FILE_MAX_COUNT = RAG_FILE_MAX_COUNT
144
+
145
+ app.state.config.ENABLE_RAG_HYBRID_SEARCH = ENABLE_RAG_HYBRID_SEARCH
146
+ app.state.config.ENABLE_RAG_WEB_LOADER_SSL_VERIFICATION = (
147
+ ENABLE_RAG_WEB_LOADER_SSL_VERIFICATION
148
+ )
149
+
150
+ app.state.config.CONTENT_EXTRACTION_ENGINE = CONTENT_EXTRACTION_ENGINE
151
+ app.state.config.TIKA_SERVER_URL = TIKA_SERVER_URL
152
+
153
+ app.state.config.TEXT_SPLITTER = RAG_TEXT_SPLITTER
154
+ app.state.config.TIKTOKEN_ENCODING_NAME = TIKTOKEN_ENCODING_NAME
155
+
156
+ app.state.config.CHUNK_SIZE = CHUNK_SIZE
157
+ app.state.config.CHUNK_OVERLAP = CHUNK_OVERLAP
158
+
159
+ app.state.config.RAG_EMBEDDING_ENGINE = RAG_EMBEDDING_ENGINE
160
+ app.state.config.RAG_EMBEDDING_MODEL = RAG_EMBEDDING_MODEL
161
+ app.state.config.RAG_EMBEDDING_BATCH_SIZE = RAG_EMBEDDING_BATCH_SIZE
162
+ app.state.config.RAG_RERANKING_MODEL = RAG_RERANKING_MODEL
163
+ app.state.config.RAG_TEMPLATE = RAG_TEMPLATE
164
+
165
+ app.state.config.OPENAI_API_BASE_URL = RAG_OPENAI_API_BASE_URL
166
+ app.state.config.OPENAI_API_KEY = RAG_OPENAI_API_KEY
167
+
168
+ app.state.config.OLLAMA_BASE_URL = RAG_OLLAMA_BASE_URL
169
+ app.state.config.OLLAMA_API_KEY = RAG_OLLAMA_API_KEY
170
+
171
+ app.state.config.PDF_EXTRACT_IMAGES = PDF_EXTRACT_IMAGES
172
+
173
+ app.state.config.YOUTUBE_LOADER_LANGUAGE = YOUTUBE_LOADER_LANGUAGE
174
+ app.state.YOUTUBE_LOADER_TRANSLATION = None
175
+
176
+
177
+ app.state.config.ENABLE_RAG_WEB_SEARCH = ENABLE_RAG_WEB_SEARCH
178
+ app.state.config.RAG_WEB_SEARCH_ENGINE = RAG_WEB_SEARCH_ENGINE
179
+ app.state.config.RAG_WEB_SEARCH_DOMAIN_FILTER_LIST = RAG_WEB_SEARCH_DOMAIN_FILTER_LIST
180
+
181
+ app.state.config.SEARXNG_QUERY_URL = SEARXNG_QUERY_URL
182
+ app.state.config.GOOGLE_PSE_API_KEY = GOOGLE_PSE_API_KEY
183
+ app.state.config.GOOGLE_PSE_ENGINE_ID = GOOGLE_PSE_ENGINE_ID
184
+ app.state.config.BRAVE_SEARCH_API_KEY = BRAVE_SEARCH_API_KEY
185
+ app.state.config.MOJEEK_SEARCH_API_KEY = MOJEEK_SEARCH_API_KEY
186
+ app.state.config.SERPSTACK_API_KEY = SERPSTACK_API_KEY
187
+ app.state.config.SERPSTACK_HTTPS = SERPSTACK_HTTPS
188
+ app.state.config.SERPER_API_KEY = SERPER_API_KEY
189
+ app.state.config.SERPLY_API_KEY = SERPLY_API_KEY
190
+ app.state.config.TAVILY_API_KEY = TAVILY_API_KEY
191
+ app.state.config.SEARCHAPI_API_KEY = SEARCHAPI_API_KEY
192
+ app.state.config.SEARCHAPI_ENGINE = SEARCHAPI_ENGINE
193
+ app.state.config.JINA_API_KEY = JINA_API_KEY
194
+ app.state.config.BING_SEARCH_V7_ENDPOINT = BING_SEARCH_V7_ENDPOINT
195
+ app.state.config.BING_SEARCH_V7_SUBSCRIPTION_KEY = BING_SEARCH_V7_SUBSCRIPTION_KEY
196
+
197
+ app.state.config.RAG_WEB_SEARCH_RESULT_COUNT = RAG_WEB_SEARCH_RESULT_COUNT
198
+ app.state.config.RAG_WEB_SEARCH_CONCURRENT_REQUESTS = RAG_WEB_SEARCH_CONCURRENT_REQUESTS
199
+
200
+
201
+ def update_embedding_model(
202
+ embedding_model: str,
203
+ auto_update: bool = False,
204
+ ):
205
+ if embedding_model and app.state.config.RAG_EMBEDDING_ENGINE == "":
206
+ from sentence_transformers import SentenceTransformer
207
+
208
+ try:
209
+ app.state.sentence_transformer_ef = SentenceTransformer(
210
+ get_model_path(embedding_model, auto_update),
211
+ device=DEVICE_TYPE,
212
+ trust_remote_code=RAG_EMBEDDING_MODEL_TRUST_REMOTE_CODE,
213
+ )
214
+ except Exception as e:
215
+ log.debug(f"Error loading SentenceTransformer: {e}")
216
+ app.state.sentence_transformer_ef = None
217
+ else:
218
+ app.state.sentence_transformer_ef = None
219
+
220
+
221
+ def update_reranking_model(
222
+ reranking_model: str,
223
+ auto_update: bool = False,
224
+ ):
225
+ if reranking_model:
226
+ if any(model in reranking_model for model in ["jinaai/jina-colbert-v2"]):
227
+ try:
228
+ from open_webui.apps.retrieval.models.colbert import ColBERT
229
+
230
+ app.state.sentence_transformer_rf = ColBERT(
231
+ get_model_path(reranking_model, auto_update),
232
+ env="docker" if DOCKER else None,
233
+ )
234
+ except Exception as e:
235
+ log.error(f"ColBERT: {e}")
236
+ app.state.sentence_transformer_rf = None
237
+ app.state.config.ENABLE_RAG_HYBRID_SEARCH = False
238
+ else:
239
+ import sentence_transformers
240
+
241
+ try:
242
+ app.state.sentence_transformer_rf = sentence_transformers.CrossEncoder(
243
+ get_model_path(reranking_model, auto_update),
244
+ device=DEVICE_TYPE,
245
+ trust_remote_code=RAG_RERANKING_MODEL_TRUST_REMOTE_CODE,
246
+ )
247
+ except:
248
+ log.error("CrossEncoder error")
249
+ app.state.sentence_transformer_rf = None
250
+ app.state.config.ENABLE_RAG_HYBRID_SEARCH = False
251
+ else:
252
+ app.state.sentence_transformer_rf = None
253
+
254
+
255
+ update_embedding_model(
256
+ app.state.config.RAG_EMBEDDING_MODEL,
257
+ RAG_EMBEDDING_MODEL_AUTO_UPDATE,
258
+ )
259
+
260
+ update_reranking_model(
261
+ app.state.config.RAG_RERANKING_MODEL,
262
+ RAG_RERANKING_MODEL_AUTO_UPDATE,
263
+ )
264
+
265
+
266
+ app.state.EMBEDDING_FUNCTION = get_embedding_function(
267
+ app.state.config.RAG_EMBEDDING_ENGINE,
268
+ app.state.config.RAG_EMBEDDING_MODEL,
269
+ app.state.sentence_transformer_ef,
270
+ (
271
+ app.state.config.OPENAI_API_BASE_URL
272
+ if app.state.config.RAG_EMBEDDING_ENGINE == "openai"
273
+ else app.state.config.OLLAMA_BASE_URL
274
+ ),
275
+ (
276
+ app.state.config.OPENAI_API_KEY
277
+ if app.state.config.RAG_EMBEDDING_ENGINE == "openai"
278
+ else app.state.config.OLLAMA_API_KEY
279
+ ),
280
+ app.state.config.RAG_EMBEDDING_BATCH_SIZE,
281
+ )
282
+
283
+ app.add_middleware(
284
+ CORSMiddleware,
285
+ allow_origins=CORS_ALLOW_ORIGIN,
286
+ allow_credentials=True,
287
+ allow_methods=["*"],
288
+ allow_headers=["*"],
289
+ )
290
+
291
+
292
+ class CollectionNameForm(BaseModel):
293
+ collection_name: Optional[str] = None
294
+
295
+
296
+ class ProcessUrlForm(CollectionNameForm):
297
+ url: str
298
+
299
+
300
+ class SearchForm(CollectionNameForm):
301
+ query: str
302
+
303
+
304
+ @app.get("/")
305
+ async def get_status():
306
+ return {
307
+ "status": True,
308
+ "chunk_size": app.state.config.CHUNK_SIZE,
309
+ "chunk_overlap": app.state.config.CHUNK_OVERLAP,
310
+ "template": app.state.config.RAG_TEMPLATE,
311
+ "embedding_engine": app.state.config.RAG_EMBEDDING_ENGINE,
312
+ "embedding_model": app.state.config.RAG_EMBEDDING_MODEL,
313
+ "reranking_model": app.state.config.RAG_RERANKING_MODEL,
314
+ "embedding_batch_size": app.state.config.RAG_EMBEDDING_BATCH_SIZE,
315
+ }
316
+
317
+
318
+ @app.get("/embedding")
319
+ async def get_embedding_config(user=Depends(get_admin_user)):
320
+ return {
321
+ "status": True,
322
+ "embedding_engine": app.state.config.RAG_EMBEDDING_ENGINE,
323
+ "embedding_model": app.state.config.RAG_EMBEDDING_MODEL,
324
+ "embedding_batch_size": app.state.config.RAG_EMBEDDING_BATCH_SIZE,
325
+ "openai_config": {
326
+ "url": app.state.config.OPENAI_API_BASE_URL,
327
+ "key": app.state.config.OPENAI_API_KEY,
328
+ },
329
+ "ollama_config": {
330
+ "url": app.state.config.OLLAMA_BASE_URL,
331
+ "key": app.state.config.OLLAMA_API_KEY,
332
+ },
333
+ }
334
+
335
+
336
+ @app.get("/reranking")
337
+ async def get_reraanking_config(user=Depends(get_admin_user)):
338
+ return {
339
+ "status": True,
340
+ "reranking_model": app.state.config.RAG_RERANKING_MODEL,
341
+ }
342
+
343
+
344
+ class OpenAIConfigForm(BaseModel):
345
+ url: str
346
+ key: str
347
+
348
+
349
+ class OllamaConfigForm(BaseModel):
350
+ url: str
351
+ key: str
352
+
353
+
354
+ class EmbeddingModelUpdateForm(BaseModel):
355
+ openai_config: Optional[OpenAIConfigForm] = None
356
+ ollama_config: Optional[OllamaConfigForm] = None
357
+ embedding_engine: str
358
+ embedding_model: str
359
+ embedding_batch_size: Optional[int] = 1
360
+
361
+
362
+ @app.post("/embedding/update")
363
+ async def update_embedding_config(
364
+ form_data: EmbeddingModelUpdateForm, user=Depends(get_admin_user)
365
+ ):
366
+ log.info(
367
+ f"Updating embedding model: {app.state.config.RAG_EMBEDDING_MODEL} to {form_data.embedding_model}"
368
+ )
369
+ try:
370
+ app.state.config.RAG_EMBEDDING_ENGINE = form_data.embedding_engine
371
+ app.state.config.RAG_EMBEDDING_MODEL = form_data.embedding_model
372
+
373
+ if app.state.config.RAG_EMBEDDING_ENGINE in ["ollama", "openai"]:
374
+ if form_data.openai_config is not None:
375
+ app.state.config.OPENAI_API_BASE_URL = form_data.openai_config.url
376
+ app.state.config.OPENAI_API_KEY = form_data.openai_config.key
377
+
378
+ if form_data.ollama_config is not None:
379
+ app.state.config.OLLAMA_BASE_URL = form_data.ollama_config.url
380
+ app.state.config.OLLAMA_API_KEY = form_data.ollama_config.key
381
+
382
+ app.state.config.RAG_EMBEDDING_BATCH_SIZE = form_data.embedding_batch_size
383
+
384
+ update_embedding_model(app.state.config.RAG_EMBEDDING_MODEL)
385
+
386
+ app.state.EMBEDDING_FUNCTION = get_embedding_function(
387
+ app.state.config.RAG_EMBEDDING_ENGINE,
388
+ app.state.config.RAG_EMBEDDING_MODEL,
389
+ app.state.sentence_transformer_ef,
390
+ (
391
+ app.state.config.OPENAI_API_BASE_URL
392
+ if app.state.config.RAG_EMBEDDING_ENGINE == "openai"
393
+ else app.state.config.OLLAMA_BASE_URL
394
+ ),
395
+ (
396
+ app.state.config.OPENAI_API_KEY
397
+ if app.state.config.RAG_EMBEDDING_ENGINE == "openai"
398
+ else app.state.config.OLLAMA_API_KEY
399
+ ),
400
+ app.state.config.RAG_EMBEDDING_BATCH_SIZE,
401
+ )
402
+
403
+ return {
404
+ "status": True,
405
+ "embedding_engine": app.state.config.RAG_EMBEDDING_ENGINE,
406
+ "embedding_model": app.state.config.RAG_EMBEDDING_MODEL,
407
+ "embedding_batch_size": app.state.config.RAG_EMBEDDING_BATCH_SIZE,
408
+ "openai_config": {
409
+ "url": app.state.config.OPENAI_API_BASE_URL,
410
+ "key": app.state.config.OPENAI_API_KEY,
411
+ },
412
+ "ollama_config": {
413
+ "url": app.state.config.OLLAMA_BASE_URL,
414
+ "key": app.state.config.OLLAMA_API_KEY,
415
+ },
416
+ }
417
+ except Exception as e:
418
+ log.exception(f"Problem updating embedding model: {e}")
419
+ raise HTTPException(
420
+ status_code=status.HTTP_500_INTERNAL_SERVER_ERROR,
421
+ detail=ERROR_MESSAGES.DEFAULT(e),
422
+ )
423
+
424
+
425
+ class RerankingModelUpdateForm(BaseModel):
426
+ reranking_model: str
427
+
428
+
429
+ @app.post("/reranking/update")
430
+ async def update_reranking_config(
431
+ form_data: RerankingModelUpdateForm, user=Depends(get_admin_user)
432
+ ):
433
+ log.info(
434
+ f"Updating reranking model: {app.state.config.RAG_RERANKING_MODEL} to {form_data.reranking_model}"
435
+ )
436
+ try:
437
+ app.state.config.RAG_RERANKING_MODEL = form_data.reranking_model
438
+
439
+ update_reranking_model(app.state.config.RAG_RERANKING_MODEL, True)
440
+
441
+ return {
442
+ "status": True,
443
+ "reranking_model": app.state.config.RAG_RERANKING_MODEL,
444
+ }
445
+ except Exception as e:
446
+ log.exception(f"Problem updating reranking model: {e}")
447
+ raise HTTPException(
448
+ status_code=status.HTTP_500_INTERNAL_SERVER_ERROR,
449
+ detail=ERROR_MESSAGES.DEFAULT(e),
450
+ )
451
+
452
+
453
+ @app.get("/config")
454
+ async def get_rag_config(user=Depends(get_admin_user)):
455
+ return {
456
+ "status": True,
457
+ "pdf_extract_images": app.state.config.PDF_EXTRACT_IMAGES,
458
+ "content_extraction": {
459
+ "engine": app.state.config.CONTENT_EXTRACTION_ENGINE,
460
+ "tika_server_url": app.state.config.TIKA_SERVER_URL,
461
+ },
462
+ "chunk": {
463
+ "text_splitter": app.state.config.TEXT_SPLITTER,
464
+ "chunk_size": app.state.config.CHUNK_SIZE,
465
+ "chunk_overlap": app.state.config.CHUNK_OVERLAP,
466
+ },
467
+ "file": {
468
+ "max_size": app.state.config.FILE_MAX_SIZE,
469
+ "max_count": app.state.config.FILE_MAX_COUNT,
470
+ },
471
+ "youtube": {
472
+ "language": app.state.config.YOUTUBE_LOADER_LANGUAGE,
473
+ "translation": app.state.YOUTUBE_LOADER_TRANSLATION,
474
+ },
475
+ "web": {
476
+ "web_loader_ssl_verification": app.state.config.ENABLE_RAG_WEB_LOADER_SSL_VERIFICATION,
477
+ "search": {
478
+ "enabled": app.state.config.ENABLE_RAG_WEB_SEARCH,
479
+ "engine": app.state.config.RAG_WEB_SEARCH_ENGINE,
480
+ "searxng_query_url": app.state.config.SEARXNG_QUERY_URL,
481
+ "google_pse_api_key": app.state.config.GOOGLE_PSE_API_KEY,
482
+ "google_pse_engine_id": app.state.config.GOOGLE_PSE_ENGINE_ID,
483
+ "brave_search_api_key": app.state.config.BRAVE_SEARCH_API_KEY,
484
+ "mojeek_search_api_key": app.state.config.MOJEEK_SEARCH_API_KEY,
485
+ "serpstack_api_key": app.state.config.SERPSTACK_API_KEY,
486
+ "serpstack_https": app.state.config.SERPSTACK_HTTPS,
487
+ "serper_api_key": app.state.config.SERPER_API_KEY,
488
+ "serply_api_key": app.state.config.SERPLY_API_KEY,
489
+ "tavily_api_key": app.state.config.TAVILY_API_KEY,
490
+ "searchapi_api_key": app.state.config.SEARCHAPI_API_KEY,
491
+ "seaarchapi_engine": app.state.config.SEARCHAPI_ENGINE,
492
+ "jina_api_key": app.state.config.JINA_API_KEY,
493
+ "bing_search_v7_endpoint": app.state.config.BING_SEARCH_V7_ENDPOINT,
494
+ "bing_search_v7_subscription_key": app.state.config.BING_SEARCH_V7_SUBSCRIPTION_KEY,
495
+ "result_count": app.state.config.RAG_WEB_SEARCH_RESULT_COUNT,
496
+ "concurrent_requests": app.state.config.RAG_WEB_SEARCH_CONCURRENT_REQUESTS,
497
+ },
498
+ },
499
+ }
500
+
501
+
502
+ class FileConfig(BaseModel):
503
+ max_size: Optional[int] = None
504
+ max_count: Optional[int] = None
505
+
506
+
507
+ class ContentExtractionConfig(BaseModel):
508
+ engine: str = ""
509
+ tika_server_url: Optional[str] = None
510
+
511
+
512
+ class ChunkParamUpdateForm(BaseModel):
513
+ text_splitter: Optional[str] = None
514
+ chunk_size: int
515
+ chunk_overlap: int
516
+
517
+
518
+ class YoutubeLoaderConfig(BaseModel):
519
+ language: list[str]
520
+ translation: Optional[str] = None
521
+
522
+
523
+ class WebSearchConfig(BaseModel):
524
+ enabled: bool
525
+ engine: Optional[str] = None
526
+ searxng_query_url: Optional[str] = None
527
+ google_pse_api_key: Optional[str] = None
528
+ google_pse_engine_id: Optional[str] = None
529
+ brave_search_api_key: Optional[str] = None
530
+ mojeek_search_api_key: Optional[str] = None
531
+ serpstack_api_key: Optional[str] = None
532
+ serpstack_https: Optional[bool] = None
533
+ serper_api_key: Optional[str] = None
534
+ serply_api_key: Optional[str] = None
535
+ tavily_api_key: Optional[str] = None
536
+ searchapi_api_key: Optional[str] = None
537
+ searchapi_engine: Optional[str] = None
538
+ jina_api_key: Optional[str] = None
539
+ bing_search_v7_endpoint: Optional[str] = None
540
+ bing_search_v7_subscription_key: Optional[str] = None
541
+ result_count: Optional[int] = None
542
+ concurrent_requests: Optional[int] = None
543
+
544
+
545
+ class WebConfig(BaseModel):
546
+ search: WebSearchConfig
547
+ web_loader_ssl_verification: Optional[bool] = None
548
+
549
+
550
+ class ConfigUpdateForm(BaseModel):
551
+ pdf_extract_images: Optional[bool] = None
552
+ file: Optional[FileConfig] = None
553
+ content_extraction: Optional[ContentExtractionConfig] = None
554
+ chunk: Optional[ChunkParamUpdateForm] = None
555
+ youtube: Optional[YoutubeLoaderConfig] = None
556
+ web: Optional[WebConfig] = None
557
+
558
+
559
+ @app.post("/config/update")
560
+ async def update_rag_config(form_data: ConfigUpdateForm, user=Depends(get_admin_user)):
561
+ app.state.config.PDF_EXTRACT_IMAGES = (
562
+ form_data.pdf_extract_images
563
+ if form_data.pdf_extract_images is not None
564
+ else app.state.config.PDF_EXTRACT_IMAGES
565
+ )
566
+
567
+ if form_data.file is not None:
568
+ app.state.config.FILE_MAX_SIZE = form_data.file.max_size
569
+ app.state.config.FILE_MAX_COUNT = form_data.file.max_count
570
+
571
+ if form_data.content_extraction is not None:
572
+ log.info(f"Updating text settings: {form_data.content_extraction}")
573
+ app.state.config.CONTENT_EXTRACTION_ENGINE = form_data.content_extraction.engine
574
+ app.state.config.TIKA_SERVER_URL = form_data.content_extraction.tika_server_url
575
+
576
+ if form_data.chunk is not None:
577
+ app.state.config.TEXT_SPLITTER = form_data.chunk.text_splitter
578
+ app.state.config.CHUNK_SIZE = form_data.chunk.chunk_size
579
+ app.state.config.CHUNK_OVERLAP = form_data.chunk.chunk_overlap
580
+
581
+ if form_data.youtube is not None:
582
+ app.state.config.YOUTUBE_LOADER_LANGUAGE = form_data.youtube.language
583
+ app.state.YOUTUBE_LOADER_TRANSLATION = form_data.youtube.translation
584
+
585
+ if form_data.web is not None:
586
+ app.state.config.ENABLE_RAG_WEB_LOADER_SSL_VERIFICATION = (
587
+ # Note: When UI "Bypass SSL verification for Websites"=True then ENABLE_RAG_WEB_LOADER_SSL_VERIFICATION=False
588
+ form_data.web.web_loader_ssl_verification
589
+ )
590
+
591
+ app.state.config.ENABLE_RAG_WEB_SEARCH = form_data.web.search.enabled
592
+ app.state.config.RAG_WEB_SEARCH_ENGINE = form_data.web.search.engine
593
+ app.state.config.SEARXNG_QUERY_URL = form_data.web.search.searxng_query_url
594
+ app.state.config.GOOGLE_PSE_API_KEY = form_data.web.search.google_pse_api_key
595
+ app.state.config.GOOGLE_PSE_ENGINE_ID = (
596
+ form_data.web.search.google_pse_engine_id
597
+ )
598
+ app.state.config.BRAVE_SEARCH_API_KEY = (
599
+ form_data.web.search.brave_search_api_key
600
+ )
601
+ app.state.config.MOJEEK_SEARCH_API_KEY = (
602
+ form_data.web.search.mojeek_search_api_key
603
+ )
604
+ app.state.config.SERPSTACK_API_KEY = form_data.web.search.serpstack_api_key
605
+ app.state.config.SERPSTACK_HTTPS = form_data.web.search.serpstack_https
606
+ app.state.config.SERPER_API_KEY = form_data.web.search.serper_api_key
607
+ app.state.config.SERPLY_API_KEY = form_data.web.search.serply_api_key
608
+ app.state.config.TAVILY_API_KEY = form_data.web.search.tavily_api_key
609
+ app.state.config.SEARCHAPI_API_KEY = form_data.web.search.searchapi_api_key
610
+ app.state.config.SEARCHAPI_ENGINE = form_data.web.search.searchapi_engine
611
+
612
+ app.state.config.JINA_API_KEY = form_data.web.search.jina_api_key
613
+ app.state.config.BING_SEARCH_V7_ENDPOINT = (
614
+ form_data.web.search.bing_search_v7_endpoint
615
+ )
616
+ app.state.config.BING_SEARCH_V7_SUBSCRIPTION_KEY = (
617
+ form_data.web.search.bing_search_v7_subscription_key
618
+ )
619
+
620
+ app.state.config.RAG_WEB_SEARCH_RESULT_COUNT = form_data.web.search.result_count
621
+ app.state.config.RAG_WEB_SEARCH_CONCURRENT_REQUESTS = (
622
+ form_data.web.search.concurrent_requests
623
+ )
624
+
625
+ return {
626
+ "status": True,
627
+ "pdf_extract_images": app.state.config.PDF_EXTRACT_IMAGES,
628
+ "file": {
629
+ "max_size": app.state.config.FILE_MAX_SIZE,
630
+ "max_count": app.state.config.FILE_MAX_COUNT,
631
+ },
632
+ "content_extraction": {
633
+ "engine": app.state.config.CONTENT_EXTRACTION_ENGINE,
634
+ "tika_server_url": app.state.config.TIKA_SERVER_URL,
635
+ },
636
+ "chunk": {
637
+ "text_splitter": app.state.config.TEXT_SPLITTER,
638
+ "chunk_size": app.state.config.CHUNK_SIZE,
639
+ "chunk_overlap": app.state.config.CHUNK_OVERLAP,
640
+ },
641
+ "youtube": {
642
+ "language": app.state.config.YOUTUBE_LOADER_LANGUAGE,
643
+ "translation": app.state.YOUTUBE_LOADER_TRANSLATION,
644
+ },
645
+ "web": {
646
+ "web_loader_ssl_verification": app.state.config.ENABLE_RAG_WEB_LOADER_SSL_VERIFICATION,
647
+ "search": {
648
+ "enabled": app.state.config.ENABLE_RAG_WEB_SEARCH,
649
+ "engine": app.state.config.RAG_WEB_SEARCH_ENGINE,
650
+ "searxng_query_url": app.state.config.SEARXNG_QUERY_URL,
651
+ "google_pse_api_key": app.state.config.GOOGLE_PSE_API_KEY,
652
+ "google_pse_engine_id": app.state.config.GOOGLE_PSE_ENGINE_ID,
653
+ "brave_search_api_key": app.state.config.BRAVE_SEARCH_API_KEY,
654
+ "mojeek_search_api_key": app.state.config.MOJEEK_SEARCH_API_KEY,
655
+ "serpstack_api_key": app.state.config.SERPSTACK_API_KEY,
656
+ "serpstack_https": app.state.config.SERPSTACK_HTTPS,
657
+ "serper_api_key": app.state.config.SERPER_API_KEY,
658
+ "serply_api_key": app.state.config.SERPLY_API_KEY,
659
+ "serachapi_api_key": app.state.config.SEARCHAPI_API_KEY,
660
+ "searchapi_engine": app.state.config.SEARCHAPI_ENGINE,
661
+ "tavily_api_key": app.state.config.TAVILY_API_KEY,
662
+ "jina_api_key": app.state.config.JINA_API_KEY,
663
+ "bing_search_v7_endpoint": app.state.config.BING_SEARCH_V7_ENDPOINT,
664
+ "bing_search_v7_subscription_key": app.state.config.BING_SEARCH_V7_SUBSCRIPTION_KEY,
665
+ "result_count": app.state.config.RAG_WEB_SEARCH_RESULT_COUNT,
666
+ "concurrent_requests": app.state.config.RAG_WEB_SEARCH_CONCURRENT_REQUESTS,
667
+ },
668
+ },
669
+ }
670
+
671
+
672
+ @app.get("/template")
673
+ async def get_rag_template(user=Depends(get_verified_user)):
674
+ return {
675
+ "status": True,
676
+ "template": app.state.config.RAG_TEMPLATE,
677
+ }
678
+
679
+
680
+ @app.get("/query/settings")
681
+ async def get_query_settings(user=Depends(get_admin_user)):
682
+ return {
683
+ "status": True,
684
+ "template": app.state.config.RAG_TEMPLATE,
685
+ "k": app.state.config.TOP_K,
686
+ "r": app.state.config.RELEVANCE_THRESHOLD,
687
+ "hybrid": app.state.config.ENABLE_RAG_HYBRID_SEARCH,
688
+ }
689
+
690
+
691
+ class QuerySettingsForm(BaseModel):
692
+ k: Optional[int] = None
693
+ r: Optional[float] = None
694
+ template: Optional[str] = None
695
+ hybrid: Optional[bool] = None
696
+
697
+
698
+ @app.post("/query/settings/update")
699
+ async def update_query_settings(
700
+ form_data: QuerySettingsForm, user=Depends(get_admin_user)
701
+ ):
702
+ app.state.config.RAG_TEMPLATE = form_data.template
703
+ app.state.config.TOP_K = form_data.k if form_data.k else 4
704
+ app.state.config.RELEVANCE_THRESHOLD = form_data.r if form_data.r else 0.0
705
+
706
+ app.state.config.ENABLE_RAG_HYBRID_SEARCH = (
707
+ form_data.hybrid if form_data.hybrid else False
708
+ )
709
+
710
+ return {
711
+ "status": True,
712
+ "template": app.state.config.RAG_TEMPLATE,
713
+ "k": app.state.config.TOP_K,
714
+ "r": app.state.config.RELEVANCE_THRESHOLD,
715
+ "hybrid": app.state.config.ENABLE_RAG_HYBRID_SEARCH,
716
+ }
717
+
718
+
719
+ ####################################
720
+ #
721
+ # Document process and retrieval
722
+ #
723
+ ####################################
724
+
725
+
726
+ def _get_docs_info(docs: list[Document]) -> str:
727
+ docs_info = set()
728
+
729
+ # Trying to select relevant metadata identifying the document.
730
+ for doc in docs:
731
+ metadata = getattr(doc, "metadata", {})
732
+ doc_name = metadata.get("name", "")
733
+ if not doc_name:
734
+ doc_name = metadata.get("title", "")
735
+ if not doc_name:
736
+ doc_name = metadata.get("source", "")
737
+ if doc_name:
738
+ docs_info.add(doc_name)
739
+
740
+ return ", ".join(docs_info)
741
+
742
+
743
+ def save_docs_to_vector_db(
744
+ docs,
745
+ collection_name,
746
+ metadata: Optional[dict] = None,
747
+ overwrite: bool = False,
748
+ split: bool = True,
749
+ add: bool = False,
750
+ ) -> bool:
751
+ log.info(
752
+ f"save_docs_to_vector_db: document {_get_docs_info(docs)} {collection_name}"
753
+ )
754
+
755
+ # Check if entries with the same hash (metadata.hash) already exist
756
+ if metadata and "hash" in metadata:
757
+ result = VECTOR_DB_CLIENT.query(
758
+ collection_name=collection_name,
759
+ filter={"hash": metadata["hash"]},
760
+ )
761
+
762
+ if result is not None:
763
+ existing_doc_ids = result.ids[0]
764
+ if existing_doc_ids:
765
+ log.info(f"Document with hash {metadata['hash']} already exists")
766
+ raise ValueError(ERROR_MESSAGES.DUPLICATE_CONTENT)
767
+
768
+ if split:
769
+ if app.state.config.TEXT_SPLITTER in ["", "character"]:
770
+ text_splitter = RecursiveCharacterTextSplitter(
771
+ chunk_size=app.state.config.CHUNK_SIZE,
772
+ chunk_overlap=app.state.config.CHUNK_OVERLAP,
773
+ add_start_index=True,
774
+ )
775
+ elif app.state.config.TEXT_SPLITTER == "token":
776
+ log.info(
777
+ f"Using token text splitter: {app.state.config.TIKTOKEN_ENCODING_NAME}"
778
+ )
779
+
780
+ tiktoken.get_encoding(str(app.state.config.TIKTOKEN_ENCODING_NAME))
781
+ text_splitter = TokenTextSplitter(
782
+ encoding_name=str(app.state.config.TIKTOKEN_ENCODING_NAME),
783
+ chunk_size=app.state.config.CHUNK_SIZE,
784
+ chunk_overlap=app.state.config.CHUNK_OVERLAP,
785
+ add_start_index=True,
786
+ )
787
+ else:
788
+ raise ValueError(ERROR_MESSAGES.DEFAULT("Invalid text splitter"))
789
+
790
+ docs = text_splitter.split_documents(docs)
791
+
792
+ if len(docs) == 0:
793
+ raise ValueError(ERROR_MESSAGES.EMPTY_CONTENT)
794
+
795
+ texts = [doc.page_content for doc in docs]
796
+ metadatas = [
797
+ {
798
+ **doc.metadata,
799
+ **(metadata if metadata else {}),
800
+ "embedding_config": json.dumps(
801
+ {
802
+ "engine": app.state.config.RAG_EMBEDDING_ENGINE,
803
+ "model": app.state.config.RAG_EMBEDDING_MODEL,
804
+ }
805
+ ),
806
+ }
807
+ for doc in docs
808
+ ]
809
+
810
+ # ChromaDB does not like datetime formats
811
+ # for meta-data so convert them to string.
812
+ for metadata in metadatas:
813
+ for key, value in metadata.items():
814
+ if isinstance(value, datetime):
815
+ metadata[key] = str(value)
816
+
817
+ try:
818
+ if VECTOR_DB_CLIENT.has_collection(collection_name=collection_name):
819
+ log.info(f"collection {collection_name} already exists")
820
+
821
+ if overwrite:
822
+ VECTOR_DB_CLIENT.delete_collection(collection_name=collection_name)
823
+ log.info(f"deleting existing collection {collection_name}")
824
+ elif add is False:
825
+ log.info(
826
+ f"collection {collection_name} already exists, overwrite is False and add is False"
827
+ )
828
+ return True
829
+
830
+ log.info(f"adding to collection {collection_name}")
831
+ embedding_function = get_embedding_function(
832
+ app.state.config.RAG_EMBEDDING_ENGINE,
833
+ app.state.config.RAG_EMBEDDING_MODEL,
834
+ app.state.sentence_transformer_ef,
835
+ (
836
+ app.state.config.OPENAI_API_BASE_URL
837
+ if app.state.config.RAG_EMBEDDING_ENGINE == "openai"
838
+ else app.state.config.OLLAMA_BASE_URL
839
+ ),
840
+ (
841
+ app.state.config.OPENAI_API_KEY
842
+ if app.state.config.RAG_EMBEDDING_ENGINE == "openai"
843
+ else app.state.config.OLLAMA_API_KEY
844
+ ),
845
+ app.state.config.RAG_EMBEDDING_BATCH_SIZE,
846
+ )
847
+
848
+ embeddings = embedding_function(
849
+ list(map(lambda x: x.replace("\n", " "), texts))
850
+ )
851
+
852
+ items = [
853
+ {
854
+ "id": str(uuid.uuid4()),
855
+ "text": text,
856
+ "vector": embeddings[idx],
857
+ "metadata": metadatas[idx],
858
+ }
859
+ for idx, text in enumerate(texts)
860
+ ]
861
+
862
+ VECTOR_DB_CLIENT.insert(
863
+ collection_name=collection_name,
864
+ items=items,
865
+ )
866
+
867
+ return True
868
+ except Exception as e:
869
+ log.exception(e)
870
+ return False
871
+
872
+
873
+ class ProcessFileForm(BaseModel):
874
+ file_id: str
875
+ content: Optional[str] = None
876
+ collection_name: Optional[str] = None
877
+
878
+
879
+ @app.post("/process/file")
880
+ def process_file(
881
+ form_data: ProcessFileForm,
882
+ user=Depends(get_verified_user),
883
+ ):
884
+ try:
885
+ file = Files.get_file_by_id(form_data.file_id)
886
+
887
+ collection_name = form_data.collection_name
888
+
889
+ if collection_name is None:
890
+ collection_name = f"file-{file.id}"
891
+
892
+ if form_data.content:
893
+ # Update the content in the file
894
+ # Usage: /files/{file_id}/data/content/update
895
+
896
+ VECTOR_DB_CLIENT.delete_collection(collection_name=f"file-{file.id}")
897
+
898
+ docs = [
899
+ Document(
900
+ page_content=form_data.content,
901
+ metadata={
902
+ **file.meta,
903
+ "name": file.filename,
904
+ "created_by": file.user_id,
905
+ "file_id": file.id,
906
+ "source": file.filename,
907
+ },
908
+ )
909
+ ]
910
+
911
+ text_content = form_data.content
912
+ elif form_data.collection_name:
913
+ # Check if the file has already been processed and save the content
914
+ # Usage: /knowledge/{id}/file/add, /knowledge/{id}/file/update
915
+
916
+ result = VECTOR_DB_CLIENT.query(
917
+ collection_name=f"file-{file.id}", filter={"file_id": file.id}
918
+ )
919
+
920
+ if result is not None and len(result.ids[0]) > 0:
921
+ docs = [
922
+ Document(
923
+ page_content=result.documents[0][idx],
924
+ metadata=result.metadatas[0][idx],
925
+ )
926
+ for idx, id in enumerate(result.ids[0])
927
+ ]
928
+ else:
929
+ docs = [
930
+ Document(
931
+ page_content=file.data.get("content", ""),
932
+ metadata={
933
+ **file.meta,
934
+ "name": file.filename,
935
+ "created_by": file.user_id,
936
+ "file_id": file.id,
937
+ "source": file.filename,
938
+ },
939
+ )
940
+ ]
941
+
942
+ text_content = file.data.get("content", "")
943
+ else:
944
+ # Process the file and save the content
945
+ # Usage: /files/
946
+ file_path = file.path
947
+ if file_path:
948
+ file_path = Storage.get_file(file_path)
949
+ loader = Loader(
950
+ engine=app.state.config.CONTENT_EXTRACTION_ENGINE,
951
+ TIKA_SERVER_URL=app.state.config.TIKA_SERVER_URL,
952
+ PDF_EXTRACT_IMAGES=app.state.config.PDF_EXTRACT_IMAGES,
953
+ )
954
+ docs = loader.load(
955
+ file.filename, file.meta.get("content_type"), file_path
956
+ )
957
+
958
+ docs = [
959
+ Document(
960
+ page_content=doc.page_content,
961
+ metadata={
962
+ **doc.metadata,
963
+ "name": file.filename,
964
+ "created_by": file.user_id,
965
+ "file_id": file.id,
966
+ "source": file.filename,
967
+ },
968
+ )
969
+ for doc in docs
970
+ ]
971
+ else:
972
+ docs = [
973
+ Document(
974
+ page_content=file.data.get("content", ""),
975
+ metadata={
976
+ **file.meta,
977
+ "name": file.filename,
978
+ "created_by": file.user_id,
979
+ "file_id": file.id,
980
+ "source": file.filename,
981
+ },
982
+ )
983
+ ]
984
+ text_content = " ".join([doc.page_content for doc in docs])
985
+
986
+ log.debug(f"text_content: {text_content}")
987
+ Files.update_file_data_by_id(
988
+ file.id,
989
+ {"content": text_content},
990
+ )
991
+
992
+ hash = calculate_sha256_string(text_content)
993
+ Files.update_file_hash_by_id(file.id, hash)
994
+
995
+ try:
996
+ result = save_docs_to_vector_db(
997
+ docs=docs,
998
+ collection_name=collection_name,
999
+ metadata={
1000
+ "file_id": file.id,
1001
+ "name": file.filename,
1002
+ "hash": hash,
1003
+ },
1004
+ add=(True if form_data.collection_name else False),
1005
+ )
1006
+
1007
+ if result:
1008
+ Files.update_file_metadata_by_id(
1009
+ file.id,
1010
+ {
1011
+ "collection_name": collection_name,
1012
+ },
1013
+ )
1014
+
1015
+ return {
1016
+ "status": True,
1017
+ "collection_name": collection_name,
1018
+ "filename": file.filename,
1019
+ "content": text_content,
1020
+ }
1021
+ except Exception as e:
1022
+ raise e
1023
+ except Exception as e:
1024
+ log.exception(e)
1025
+ if "No pandoc was found" in str(e):
1026
+ raise HTTPException(
1027
+ status_code=status.HTTP_400_BAD_REQUEST,
1028
+ detail=ERROR_MESSAGES.PANDOC_NOT_INSTALLED,
1029
+ )
1030
+ else:
1031
+ raise HTTPException(
1032
+ status_code=status.HTTP_400_BAD_REQUEST,
1033
+ detail=str(e),
1034
+ )
1035
+
1036
+
1037
+ class ProcessTextForm(BaseModel):
1038
+ name: str
1039
+ content: str
1040
+ collection_name: Optional[str] = None
1041
+
1042
+
1043
+ @app.post("/process/text")
1044
+ def process_text(
1045
+ form_data: ProcessTextForm,
1046
+ user=Depends(get_verified_user),
1047
+ ):
1048
+ collection_name = form_data.collection_name
1049
+ if collection_name is None:
1050
+ collection_name = calculate_sha256_string(form_data.content)
1051
+
1052
+ docs = [
1053
+ Document(
1054
+ page_content=form_data.content,
1055
+ metadata={"name": form_data.name, "created_by": user.id},
1056
+ )
1057
+ ]
1058
+ text_content = form_data.content
1059
+ log.debug(f"text_content: {text_content}")
1060
+
1061
+ result = save_docs_to_vector_db(docs, collection_name)
1062
+
1063
+ if result:
1064
+ return {
1065
+ "status": True,
1066
+ "collection_name": collection_name,
1067
+ "content": text_content,
1068
+ }
1069
+ else:
1070
+ raise HTTPException(
1071
+ status_code=status.HTTP_500_INTERNAL_SERVER_ERROR,
1072
+ detail=ERROR_MESSAGES.DEFAULT(),
1073
+ )
1074
+
1075
+
1076
+ @app.post("/process/youtube")
1077
+ def process_youtube_video(form_data: ProcessUrlForm, user=Depends(get_verified_user)):
1078
+ try:
1079
+ collection_name = form_data.collection_name
1080
+ if not collection_name:
1081
+ collection_name = calculate_sha256_string(form_data.url)[:63]
1082
+
1083
+ loader = YoutubeLoader(
1084
+ form_data.url, language=app.state.config.YOUTUBE_LOADER_LANGUAGE
1085
+ )
1086
+
1087
+ docs = loader.load()
1088
+ content = " ".join([doc.page_content for doc in docs])
1089
+ log.debug(f"text_content: {content}")
1090
+ save_docs_to_vector_db(docs, collection_name, overwrite=True)
1091
+
1092
+ return {
1093
+ "status": True,
1094
+ "collection_name": collection_name,
1095
+ "filename": form_data.url,
1096
+ "file": {
1097
+ "data": {
1098
+ "content": content,
1099
+ },
1100
+ "meta": {
1101
+ "name": form_data.url,
1102
+ },
1103
+ },
1104
+ }
1105
+ except Exception as e:
1106
+ log.exception(e)
1107
+ raise HTTPException(
1108
+ status_code=status.HTTP_400_BAD_REQUEST,
1109
+ detail=ERROR_MESSAGES.DEFAULT(e),
1110
+ )
1111
+
1112
+
1113
+ @app.post("/process/web")
1114
+ def process_web(form_data: ProcessUrlForm, user=Depends(get_verified_user)):
1115
+ try:
1116
+ collection_name = form_data.collection_name
1117
+ if not collection_name:
1118
+ collection_name = calculate_sha256_string(form_data.url)[:63]
1119
+
1120
+ loader = get_web_loader(
1121
+ form_data.url,
1122
+ verify_ssl=app.state.config.ENABLE_RAG_WEB_LOADER_SSL_VERIFICATION,
1123
+ requests_per_second=app.state.config.RAG_WEB_SEARCH_CONCURRENT_REQUESTS,
1124
+ )
1125
+ docs = loader.load()
1126
+ content = " ".join([doc.page_content for doc in docs])
1127
+ log.debug(f"text_content: {content}")
1128
+ save_docs_to_vector_db(docs, collection_name, overwrite=True)
1129
+
1130
+ return {
1131
+ "status": True,
1132
+ "collection_name": collection_name,
1133
+ "filename": form_data.url,
1134
+ "file": {
1135
+ "data": {
1136
+ "content": content,
1137
+ },
1138
+ "meta": {
1139
+ "name": form_data.url,
1140
+ },
1141
+ },
1142
+ }
1143
+ except Exception as e:
1144
+ log.exception(e)
1145
+ raise HTTPException(
1146
+ status_code=status.HTTP_400_BAD_REQUEST,
1147
+ detail=ERROR_MESSAGES.DEFAULT(e),
1148
+ )
1149
+
1150
+
1151
+ def search_web(engine: str, query: str) -> list[SearchResult]:
1152
+ """Search the web using a search engine and return the results as a list of SearchResult objects.
1153
+ Will look for a search engine API key in environment variables in the following order:
1154
+ - SEARXNG_QUERY_URL
1155
+ - GOOGLE_PSE_API_KEY + GOOGLE_PSE_ENGINE_ID
1156
+ - BRAVE_SEARCH_API_KEY
1157
+ - MOJEEK_SEARCH_API_KEY
1158
+ - SERPSTACK_API_KEY
1159
+ - SERPER_API_KEY
1160
+ - SERPLY_API_KEY
1161
+ - TAVILY_API_KEY
1162
+ - SEARCHAPI_API_KEY + SEARCHAPI_ENGINE (by default `google`)
1163
+ Args:
1164
+ query (str): The query to search for
1165
+ """
1166
+
1167
+ # TODO: add playwright to search the web
1168
+ if engine == "searxng":
1169
+ if app.state.config.SEARXNG_QUERY_URL:
1170
+ return search_searxng(
1171
+ app.state.config.SEARXNG_QUERY_URL,
1172
+ query,
1173
+ app.state.config.RAG_WEB_SEARCH_RESULT_COUNT,
1174
+ app.state.config.RAG_WEB_SEARCH_DOMAIN_FILTER_LIST,
1175
+ )
1176
+ else:
1177
+ raise Exception("No SEARXNG_QUERY_URL found in environment variables")
1178
+ elif engine == "google_pse":
1179
+ if (
1180
+ app.state.config.GOOGLE_PSE_API_KEY
1181
+ and app.state.config.GOOGLE_PSE_ENGINE_ID
1182
+ ):
1183
+ return search_google_pse(
1184
+ app.state.config.GOOGLE_PSE_API_KEY,
1185
+ app.state.config.GOOGLE_PSE_ENGINE_ID,
1186
+ query,
1187
+ app.state.config.RAG_WEB_SEARCH_RESULT_COUNT,
1188
+ app.state.config.RAG_WEB_SEARCH_DOMAIN_FILTER_LIST,
1189
+ )
1190
+ else:
1191
+ raise Exception(
1192
+ "No GOOGLE_PSE_API_KEY or GOOGLE_PSE_ENGINE_ID found in environment variables"
1193
+ )
1194
+ elif engine == "brave":
1195
+ if app.state.config.BRAVE_SEARCH_API_KEY:
1196
+ return search_brave(
1197
+ app.state.config.BRAVE_SEARCH_API_KEY,
1198
+ query,
1199
+ app.state.config.RAG_WEB_SEARCH_RESULT_COUNT,
1200
+ app.state.config.RAG_WEB_SEARCH_DOMAIN_FILTER_LIST,
1201
+ )
1202
+ else:
1203
+ raise Exception("No BRAVE_SEARCH_API_KEY found in environment variables")
1204
+ elif engine == "mojeek":
1205
+ if app.state.config.MOJEEK_SEARCH_API_KEY:
1206
+ return search_mojeek(
1207
+ app.state.config.MOJEEK_SEARCH_API_KEY,
1208
+ query,
1209
+ app.state.config.RAG_WEB_SEARCH_RESULT_COUNT,
1210
+ app.state.config.RAG_WEB_SEARCH_DOMAIN_FILTER_LIST,
1211
+ )
1212
+ else:
1213
+ raise Exception("No MOJEEK_SEARCH_API_KEY found in environment variables")
1214
+ elif engine == "serpstack":
1215
+ if app.state.config.SERPSTACK_API_KEY:
1216
+ return search_serpstack(
1217
+ app.state.config.SERPSTACK_API_KEY,
1218
+ query,
1219
+ app.state.config.RAG_WEB_SEARCH_RESULT_COUNT,
1220
+ app.state.config.RAG_WEB_SEARCH_DOMAIN_FILTER_LIST,
1221
+ https_enabled=app.state.config.SERPSTACK_HTTPS,
1222
+ )
1223
+ else:
1224
+ raise Exception("No SERPSTACK_API_KEY found in environment variables")
1225
+ elif engine == "serper":
1226
+ if app.state.config.SERPER_API_KEY:
1227
+ return search_serper(
1228
+ app.state.config.SERPER_API_KEY,
1229
+ query,
1230
+ app.state.config.RAG_WEB_SEARCH_RESULT_COUNT,
1231
+ app.state.config.RAG_WEB_SEARCH_DOMAIN_FILTER_LIST,
1232
+ )
1233
+ else:
1234
+ raise Exception("No SERPER_API_KEY found in environment variables")
1235
+ elif engine == "serply":
1236
+ if app.state.config.SERPLY_API_KEY:
1237
+ return search_serply(
1238
+ app.state.config.SERPLY_API_KEY,
1239
+ query,
1240
+ app.state.config.RAG_WEB_SEARCH_RESULT_COUNT,
1241
+ app.state.config.RAG_WEB_SEARCH_DOMAIN_FILTER_LIST,
1242
+ )
1243
+ else:
1244
+ raise Exception("No SERPLY_API_KEY found in environment variables")
1245
+ elif engine == "duckduckgo":
1246
+ return search_duckduckgo(
1247
+ query,
1248
+ app.state.config.RAG_WEB_SEARCH_RESULT_COUNT,
1249
+ app.state.config.RAG_WEB_SEARCH_DOMAIN_FILTER_LIST,
1250
+ )
1251
+ elif engine == "tavily":
1252
+ if app.state.config.TAVILY_API_KEY:
1253
+ return search_tavily(
1254
+ app.state.config.TAVILY_API_KEY,
1255
+ query,
1256
+ app.state.config.RAG_WEB_SEARCH_RESULT_COUNT,
1257
+ )
1258
+ else:
1259
+ raise Exception("No TAVILY_API_KEY found in environment variables")
1260
+ elif engine == "searchapi":
1261
+ if app.state.config.SEARCHAPI_API_KEY:
1262
+ return search_searchapi(
1263
+ app.state.config.SEARCHAPI_API_KEY,
1264
+ app.state.config.SEARCHAPI_ENGINE,
1265
+ query,
1266
+ app.state.config.RAG_WEB_SEARCH_RESULT_COUNT,
1267
+ app.state.config.RAG_WEB_SEARCH_DOMAIN_FILTER_LIST,
1268
+ )
1269
+ else:
1270
+ raise Exception("No SEARCHAPI_API_KEY found in environment variables")
1271
+ elif engine == "jina":
1272
+ return search_jina(
1273
+ app.state.config.JINA_API_KEY,
1274
+ query,
1275
+ app.state.config.RAG_WEB_SEARCH_RESULT_COUNT,
1276
+ )
1277
+ elif engine == "bing":
1278
+ return search_bing(
1279
+ app.state.config.BING_SEARCH_V7_SUBSCRIPTION_KEY,
1280
+ app.state.config.BING_SEARCH_V7_ENDPOINT,
1281
+ str(DEFAULT_LOCALE),
1282
+ query,
1283
+ app.state.config.RAG_WEB_SEARCH_RESULT_COUNT,
1284
+ app.state.config.RAG_WEB_SEARCH_DOMAIN_FILTER_LIST,
1285
+ )
1286
+ else:
1287
+ raise Exception("No search engine API key found in environment variables")
1288
+
1289
+
1290
+ @app.post("/process/web/search")
1291
+ def process_web_search(form_data: SearchForm, user=Depends(get_verified_user)):
1292
+ try:
1293
+ logging.info(
1294
+ f"trying to web search with {app.state.config.RAG_WEB_SEARCH_ENGINE, form_data.query}"
1295
+ )
1296
+ web_results = search_web(
1297
+ app.state.config.RAG_WEB_SEARCH_ENGINE, form_data.query
1298
+ )
1299
+ except Exception as e:
1300
+ log.exception(e)
1301
+
1302
+ print(e)
1303
+ raise HTTPException(
1304
+ status_code=status.HTTP_400_BAD_REQUEST,
1305
+ detail=ERROR_MESSAGES.WEB_SEARCH_ERROR(e),
1306
+ )
1307
+
1308
+ try:
1309
+ collection_name = form_data.collection_name
1310
+ if collection_name == "":
1311
+ collection_name = calculate_sha256_string(form_data.query)[:63]
1312
+
1313
+ urls = [result.link for result in web_results]
1314
+
1315
+ loader = get_web_loader(
1316
+ urls,
1317
+ verify_ssl=app.state.config.ENABLE_RAG_WEB_LOADER_SSL_VERIFICATION,
1318
+ requests_per_second=app.state.config.RAG_WEB_SEARCH_CONCURRENT_REQUESTS,
1319
+ )
1320
+ docs = loader.aload()
1321
+
1322
+ save_docs_to_vector_db(docs, collection_name, overwrite=True)
1323
+
1324
+ return {
1325
+ "status": True,
1326
+ "collection_name": collection_name,
1327
+ "filenames": urls,
1328
+ }
1329
+ except Exception as e:
1330
+ log.exception(e)
1331
+ raise HTTPException(
1332
+ status_code=status.HTTP_400_BAD_REQUEST,
1333
+ detail=ERROR_MESSAGES.DEFAULT(e),
1334
+ )
1335
+
1336
+
1337
+ class QueryDocForm(BaseModel):
1338
+ collection_name: str
1339
+ query: str
1340
+ k: Optional[int] = None
1341
+ r: Optional[float] = None
1342
+ hybrid: Optional[bool] = None
1343
+
1344
+
1345
+ @app.post("/query/doc")
1346
+ def query_doc_handler(
1347
+ form_data: QueryDocForm,
1348
+ user=Depends(get_verified_user),
1349
+ ):
1350
+ try:
1351
+ if app.state.config.ENABLE_RAG_HYBRID_SEARCH:
1352
+ return query_doc_with_hybrid_search(
1353
+ collection_name=form_data.collection_name,
1354
+ query=form_data.query,
1355
+ embedding_function=app.state.EMBEDDING_FUNCTION,
1356
+ k=form_data.k if form_data.k else app.state.config.TOP_K,
1357
+ reranking_function=app.state.sentence_transformer_rf,
1358
+ r=(
1359
+ form_data.r if form_data.r else app.state.config.RELEVANCE_THRESHOLD
1360
+ ),
1361
+ )
1362
+ else:
1363
+ return query_doc(
1364
+ collection_name=form_data.collection_name,
1365
+ query=form_data.query,
1366
+ embedding_function=app.state.EMBEDDING_FUNCTION,
1367
+ k=form_data.k if form_data.k else app.state.config.TOP_K,
1368
+ )
1369
+ except Exception as e:
1370
+ log.exception(e)
1371
+ raise HTTPException(
1372
+ status_code=status.HTTP_400_BAD_REQUEST,
1373
+ detail=ERROR_MESSAGES.DEFAULT(e),
1374
+ )
1375
+
1376
+
1377
+ class QueryCollectionsForm(BaseModel):
1378
+ collection_names: list[str]
1379
+ query: str
1380
+ k: Optional[int] = None
1381
+ r: Optional[float] = None
1382
+ hybrid: Optional[bool] = None
1383
+
1384
+
1385
+ @app.post("/query/collection")
1386
+ def query_collection_handler(
1387
+ form_data: QueryCollectionsForm,
1388
+ user=Depends(get_verified_user),
1389
+ ):
1390
+ try:
1391
+ if app.state.config.ENABLE_RAG_HYBRID_SEARCH:
1392
+ return query_collection_with_hybrid_search(
1393
+ collection_names=form_data.collection_names,
1394
+ query=form_data.query,
1395
+ embedding_function=app.state.EMBEDDING_FUNCTION,
1396
+ k=form_data.k if form_data.k else app.state.config.TOP_K,
1397
+ reranking_function=app.state.sentence_transformer_rf,
1398
+ r=(
1399
+ form_data.r if form_data.r else app.state.config.RELEVANCE_THRESHOLD
1400
+ ),
1401
+ )
1402
+ else:
1403
+ return query_collection(
1404
+ collection_names=form_data.collection_names,
1405
+ query=form_data.query,
1406
+ embedding_function=app.state.EMBEDDING_FUNCTION,
1407
+ k=form_data.k if form_data.k else app.state.config.TOP_K,
1408
+ )
1409
+
1410
+ except Exception as e:
1411
+ log.exception(e)
1412
+ raise HTTPException(
1413
+ status_code=status.HTTP_400_BAD_REQUEST,
1414
+ detail=ERROR_MESSAGES.DEFAULT(e),
1415
+ )
1416
+
1417
+
1418
+ ####################################
1419
+ #
1420
+ # Vector DB operations
1421
+ #
1422
+ ####################################
1423
+
1424
+
1425
+ class DeleteForm(BaseModel):
1426
+ collection_name: str
1427
+ file_id: str
1428
+
1429
+
1430
+ @app.post("/delete")
1431
+ def delete_entries_from_collection(form_data: DeleteForm, user=Depends(get_admin_user)):
1432
+ try:
1433
+ if VECTOR_DB_CLIENT.has_collection(collection_name=form_data.collection_name):
1434
+ file = Files.get_file_by_id(form_data.file_id)
1435
+ hash = file.hash
1436
+
1437
+ VECTOR_DB_CLIENT.delete(
1438
+ collection_name=form_data.collection_name,
1439
+ metadata={"hash": hash},
1440
+ )
1441
+ return {"status": True}
1442
+ else:
1443
+ return {"status": False}
1444
+ except Exception as e:
1445
+ log.exception(e)
1446
+ return {"status": False}
1447
+
1448
+
1449
+ @app.post("/reset/db")
1450
+ def reset_vector_db(user=Depends(get_admin_user)):
1451
+ VECTOR_DB_CLIENT.reset()
1452
+ Knowledges.delete_all_knowledge()
1453
+
1454
+
1455
+ @app.post("/reset/uploads")
1456
+ def reset_upload_dir(user=Depends(get_admin_user)) -> bool:
1457
+ folder = f"{UPLOAD_DIR}"
1458
+ try:
1459
+ # Check if the directory exists
1460
+ if os.path.exists(folder):
1461
+ # Iterate over all the files and directories in the specified directory
1462
+ for filename in os.listdir(folder):
1463
+ file_path = os.path.join(folder, filename)
1464
+ try:
1465
+ if os.path.isfile(file_path) or os.path.islink(file_path):
1466
+ os.unlink(file_path) # Remove the file or link
1467
+ elif os.path.isdir(file_path):
1468
+ shutil.rmtree(file_path) # Remove the directory
1469
+ except Exception as e:
1470
+ print(f"Failed to delete {file_path}. Reason: {e}")
1471
+ else:
1472
+ print(f"The directory {folder} does not exist")
1473
+ except Exception as e:
1474
+ print(f"Failed to process the directory {folder}. Reason: {e}")
1475
+ return True
1476
+
1477
+
1478
+ if ENV == "dev":
1479
+
1480
+ @app.get("/ef")
1481
+ async def get_embeddings():
1482
+ return {"result": app.state.EMBEDDING_FUNCTION("hello world")}
1483
+
1484
+ @app.get("/ef/{text}")
1485
+ async def get_embeddings_text(text: str):
1486
+ return {"result": app.state.EMBEDDING_FUNCTION(text)}
backend/open_webui/apps/retrieval/models/colbert.py ADDED
@@ -0,0 +1,81 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ import os
2
+ import torch
3
+ import numpy as np
4
+ from colbert.infra import ColBERTConfig
5
+ from colbert.modeling.checkpoint import Checkpoint
6
+
7
+
8
+ class ColBERT:
9
+ def __init__(self, name, **kwargs) -> None:
10
+ print("ColBERT: Loading model", name)
11
+ self.device = "cuda" if torch.cuda.is_available() else "cpu"
12
+
13
+ DOCKER = kwargs.get("env") == "docker"
14
+ if DOCKER:
15
+ # This is a workaround for the issue with the docker container
16
+ # where the torch extension is not loaded properly
17
+ # and the following error is thrown:
18
+ # /root/.cache/torch_extensions/py311_cpu/segmented_maxsim_cpp/segmented_maxsim_cpp.so: cannot open shared object file: No such file or directory
19
+
20
+ lock_file = (
21
+ "/root/.cache/torch_extensions/py311_cpu/segmented_maxsim_cpp/lock"
22
+ )
23
+ if os.path.exists(lock_file):
24
+ os.remove(lock_file)
25
+
26
+ self.ckpt = Checkpoint(
27
+ name,
28
+ colbert_config=ColBERTConfig(model_name=name),
29
+ ).to(self.device)
30
+ pass
31
+
32
+ def calculate_similarity_scores(self, query_embeddings, document_embeddings):
33
+
34
+ query_embeddings = query_embeddings.to(self.device)
35
+ document_embeddings = document_embeddings.to(self.device)
36
+
37
+ # Validate dimensions to ensure compatibility
38
+ if query_embeddings.dim() != 3:
39
+ raise ValueError(
40
+ f"Expected query embeddings to have 3 dimensions, but got {query_embeddings.dim()}."
41
+ )
42
+ if document_embeddings.dim() != 3:
43
+ raise ValueError(
44
+ f"Expected document embeddings to have 3 dimensions, but got {document_embeddings.dim()}."
45
+ )
46
+ if query_embeddings.size(0) not in [1, document_embeddings.size(0)]:
47
+ raise ValueError(
48
+ "There should be either one query or queries equal to the number of documents."
49
+ )
50
+
51
+ # Transpose the query embeddings to align for matrix multiplication
52
+ transposed_query_embeddings = query_embeddings.permute(0, 2, 1)
53
+ # Compute similarity scores using batch matrix multiplication
54
+ computed_scores = torch.matmul(document_embeddings, transposed_query_embeddings)
55
+ # Apply max pooling to extract the highest semantic similarity across each document's sequence
56
+ maximum_scores = torch.max(computed_scores, dim=1).values
57
+
58
+ # Sum up the maximum scores across features to get the overall document relevance scores
59
+ final_scores = maximum_scores.sum(dim=1)
60
+
61
+ normalized_scores = torch.softmax(final_scores, dim=0)
62
+
63
+ return normalized_scores.detach().cpu().numpy().astype(np.float32)
64
+
65
+ def predict(self, sentences):
66
+
67
+ query = sentences[0][0]
68
+ docs = [i[1] for i in sentences]
69
+
70
+ # Embedding the documents
71
+ embedded_docs = self.ckpt.docFromText(docs, bsize=32)[0]
72
+ # Embedding the queries
73
+ embedded_queries = self.ckpt.queryFromText([query], bsize=32)
74
+ embedded_query = embedded_queries[0]
75
+
76
+ # Calculate retrieval scores for the query against all documents
77
+ scores = self.calculate_similarity_scores(
78
+ embedded_query.unsqueeze(0), embedded_docs
79
+ )
80
+
81
+ return scores
backend/open_webui/apps/retrieval/utils.py ADDED
@@ -0,0 +1,572 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ import logging
2
+ import os
3
+ import uuid
4
+ from typing import Optional, Union
5
+
6
+ import asyncio
7
+ import requests
8
+
9
+ from huggingface_hub import snapshot_download
10
+ from langchain.retrievers import ContextualCompressionRetriever, EnsembleRetriever
11
+ from langchain_community.retrievers import BM25Retriever
12
+ from langchain_core.documents import Document
13
+
14
+ from open_webui.apps.retrieval.vector.connector import VECTOR_DB_CLIENT
15
+ from open_webui.utils.misc import get_last_user_message
16
+
17
+ from open_webui.env import SRC_LOG_LEVELS
18
+ from open_webui.config import DEFAULT_RAG_TEMPLATE
19
+
20
+
21
+ log = logging.getLogger(__name__)
22
+ log.setLevel(SRC_LOG_LEVELS["RAG"])
23
+
24
+
25
+ from typing import Any
26
+
27
+ from langchain_core.callbacks import CallbackManagerForRetrieverRun
28
+ from langchain_core.retrievers import BaseRetriever
29
+
30
+
31
+ class VectorSearchRetriever(BaseRetriever):
32
+ collection_name: Any
33
+ embedding_function: Any
34
+ top_k: int
35
+
36
+ def _get_relevant_documents(
37
+ self,
38
+ query: str,
39
+ *,
40
+ run_manager: CallbackManagerForRetrieverRun,
41
+ ) -> list[Document]:
42
+ result = VECTOR_DB_CLIENT.search(
43
+ collection_name=self.collection_name,
44
+ vectors=[self.embedding_function(query)],
45
+ limit=self.top_k,
46
+ )
47
+
48
+ ids = result.ids[0]
49
+ metadatas = result.metadatas[0]
50
+ documents = result.documents[0]
51
+
52
+ results = []
53
+ for idx in range(len(ids)):
54
+ results.append(
55
+ Document(
56
+ metadata=metadatas[idx],
57
+ page_content=documents[idx],
58
+ )
59
+ )
60
+ return results
61
+
62
+
63
+ def query_doc(
64
+ collection_name: str,
65
+ query_embedding: list[float],
66
+ k: int,
67
+ ):
68
+ try:
69
+ result = VECTOR_DB_CLIENT.search(
70
+ collection_name=collection_name,
71
+ vectors=[query_embedding],
72
+ limit=k,
73
+ )
74
+
75
+ log.info(f"query_doc:result {result.ids} {result.metadatas}")
76
+ return result
77
+ except Exception as e:
78
+ print(e)
79
+ raise e
80
+
81
+
82
+ def query_doc_with_hybrid_search(
83
+ collection_name: str,
84
+ query: str,
85
+ embedding_function,
86
+ k: int,
87
+ reranking_function,
88
+ r: float,
89
+ ) -> dict:
90
+ try:
91
+ result = VECTOR_DB_CLIENT.get(collection_name=collection_name)
92
+
93
+ bm25_retriever = BM25Retriever.from_texts(
94
+ texts=result.documents[0],
95
+ metadatas=result.metadatas[0],
96
+ )
97
+ bm25_retriever.k = k
98
+
99
+ vector_search_retriever = VectorSearchRetriever(
100
+ collection_name=collection_name,
101
+ embedding_function=embedding_function,
102
+ top_k=k,
103
+ )
104
+
105
+ ensemble_retriever = EnsembleRetriever(
106
+ retrievers=[bm25_retriever, vector_search_retriever], weights=[0.5, 0.5]
107
+ )
108
+ compressor = RerankCompressor(
109
+ embedding_function=embedding_function,
110
+ top_n=k,
111
+ reranking_function=reranking_function,
112
+ r_score=r,
113
+ )
114
+
115
+ compression_retriever = ContextualCompressionRetriever(
116
+ base_compressor=compressor, base_retriever=ensemble_retriever
117
+ )
118
+
119
+ result = compression_retriever.invoke(query)
120
+ result = {
121
+ "distances": [[d.metadata.get("score") for d in result]],
122
+ "documents": [[d.page_content for d in result]],
123
+ "metadatas": [[d.metadata for d in result]],
124
+ }
125
+
126
+ log.info(
127
+ "query_doc_with_hybrid_search:result "
128
+ + f'{result["metadatas"]} {result["distances"]}'
129
+ )
130
+ return result
131
+ except Exception as e:
132
+ raise e
133
+
134
+
135
+ def merge_and_sort_query_results(
136
+ query_results: list[dict], k: int, reverse: bool = False
137
+ ) -> list[dict]:
138
+ # Initialize lists to store combined data
139
+ combined_distances = []
140
+ combined_documents = []
141
+ combined_metadatas = []
142
+
143
+ for data in query_results:
144
+ combined_distances.extend(data["distances"][0])
145
+ combined_documents.extend(data["documents"][0])
146
+ combined_metadatas.extend(data["metadatas"][0])
147
+
148
+ # Create a list of tuples (distance, document, metadata)
149
+ combined = list(zip(combined_distances, combined_documents, combined_metadatas))
150
+
151
+ # Sort the list based on distances
152
+ combined.sort(key=lambda x: x[0], reverse=reverse)
153
+
154
+ # We don't have anything :-(
155
+ if not combined:
156
+ sorted_distances = []
157
+ sorted_documents = []
158
+ sorted_metadatas = []
159
+ else:
160
+ # Unzip the sorted list
161
+ sorted_distances, sorted_documents, sorted_metadatas = zip(*combined)
162
+
163
+ # Slicing the lists to include only k elements
164
+ sorted_distances = list(sorted_distances)[:k]
165
+ sorted_documents = list(sorted_documents)[:k]
166
+ sorted_metadatas = list(sorted_metadatas)[:k]
167
+
168
+ # Create the output dictionary
169
+ result = {
170
+ "distances": [sorted_distances],
171
+ "documents": [sorted_documents],
172
+ "metadatas": [sorted_metadatas],
173
+ }
174
+
175
+ return result
176
+
177
+
178
+ def query_collection(
179
+ collection_names: list[str],
180
+ queries: list[str],
181
+ embedding_function,
182
+ k: int,
183
+ ) -> dict:
184
+ results = []
185
+ for query in queries:
186
+ query_embedding = embedding_function(query)
187
+ for collection_name in collection_names:
188
+ if collection_name:
189
+ try:
190
+ result = query_doc(
191
+ collection_name=collection_name,
192
+ k=k,
193
+ query_embedding=query_embedding,
194
+ )
195
+ if result is not None:
196
+ results.append(result.model_dump())
197
+ except Exception as e:
198
+ log.exception(f"Error when querying the collection: {e}")
199
+ else:
200
+ pass
201
+
202
+ return merge_and_sort_query_results(results, k=k)
203
+
204
+
205
+ def query_collection_with_hybrid_search(
206
+ collection_names: list[str],
207
+ queries: list[str],
208
+ embedding_function,
209
+ k: int,
210
+ reranking_function,
211
+ r: float,
212
+ ) -> dict:
213
+ results = []
214
+ error = False
215
+ for collection_name in collection_names:
216
+ try:
217
+ for query in queries:
218
+ result = query_doc_with_hybrid_search(
219
+ collection_name=collection_name,
220
+ query=query,
221
+ embedding_function=embedding_function,
222
+ k=k,
223
+ reranking_function=reranking_function,
224
+ r=r,
225
+ )
226
+ results.append(result)
227
+ except Exception as e:
228
+ log.exception(
229
+ "Error when querying the collection with " f"hybrid_search: {e}"
230
+ )
231
+ error = True
232
+
233
+ if error:
234
+ raise Exception(
235
+ "Hybrid search failed for all collections. Using Non hybrid search as fallback."
236
+ )
237
+
238
+ return merge_and_sort_query_results(results, k=k, reverse=True)
239
+
240
+
241
+ def rag_template(template: str, context: str, query: str):
242
+ if template == "":
243
+ template = DEFAULT_RAG_TEMPLATE
244
+
245
+ if "[context]" not in template and "{{CONTEXT}}" not in template:
246
+ log.debug(
247
+ "WARNING: The RAG template does not contain the '[context]' or '{{CONTEXT}}' placeholder."
248
+ )
249
+
250
+ if "<context>" in context and "</context>" in context:
251
+ log.debug(
252
+ "WARNING: Potential prompt injection attack: the RAG "
253
+ "context contains '<context>' and '</context>'. This might be "
254
+ "nothing, or the user might be trying to hack something."
255
+ )
256
+
257
+ query_placeholders = []
258
+ if "[query]" in context:
259
+ query_placeholder = "{{QUERY" + str(uuid.uuid4()) + "}}"
260
+ template = template.replace("[query]", query_placeholder)
261
+ query_placeholders.append(query_placeholder)
262
+
263
+ if "{{QUERY}}" in context:
264
+ query_placeholder = "{{QUERY" + str(uuid.uuid4()) + "}}"
265
+ template = template.replace("{{QUERY}}", query_placeholder)
266
+ query_placeholders.append(query_placeholder)
267
+
268
+ template = template.replace("[context]", context)
269
+ template = template.replace("{{CONTEXT}}", context)
270
+ template = template.replace("[query]", query)
271
+ template = template.replace("{{QUERY}}", query)
272
+
273
+ for query_placeholder in query_placeholders:
274
+ template = template.replace(query_placeholder, query)
275
+
276
+ return template
277
+
278
+
279
+ def get_embedding_function(
280
+ embedding_engine,
281
+ embedding_model,
282
+ embedding_function,
283
+ url,
284
+ key,
285
+ embedding_batch_size,
286
+ ):
287
+ if embedding_engine == "":
288
+ return lambda query: embedding_function.encode(query).tolist()
289
+ elif embedding_engine in ["ollama", "openai"]:
290
+ func = lambda query: generate_embeddings(
291
+ engine=embedding_engine,
292
+ model=embedding_model,
293
+ text=query,
294
+ url=url,
295
+ key=key,
296
+ )
297
+
298
+ def generate_multiple(query, func):
299
+ if isinstance(query, list):
300
+ embeddings = []
301
+ for i in range(0, len(query), embedding_batch_size):
302
+ embeddings.extend(func(query[i : i + embedding_batch_size]))
303
+ return embeddings
304
+ else:
305
+ return func(query)
306
+
307
+ return lambda query: generate_multiple(query, func)
308
+
309
+
310
+ def get_sources_from_files(
311
+ files,
312
+ queries,
313
+ embedding_function,
314
+ k,
315
+ reranking_function,
316
+ r,
317
+ hybrid_search,
318
+ ):
319
+ log.debug(f"files: {files} {queries} {embedding_function} {reranking_function}")
320
+
321
+ extracted_collections = []
322
+ relevant_contexts = []
323
+
324
+ for file in files:
325
+ if file.get("context") == "full":
326
+ context = {
327
+ "documents": [[file.get("file").get("data", {}).get("content")]],
328
+ "metadatas": [[{"file_id": file.get("id"), "name": file.get("name")}]],
329
+ }
330
+ else:
331
+ context = None
332
+
333
+ collection_names = []
334
+ if file.get("type") == "collection":
335
+ if file.get("legacy"):
336
+ collection_names = file.get("collection_names", [])
337
+ else:
338
+ collection_names.append(file["id"])
339
+ elif file.get("collection_name"):
340
+ collection_names.append(file["collection_name"])
341
+ elif file.get("id"):
342
+ if file.get("legacy"):
343
+ collection_names.append(f"{file['id']}")
344
+ else:
345
+ collection_names.append(f"file-{file['id']}")
346
+
347
+ collection_names = set(collection_names).difference(extracted_collections)
348
+ if not collection_names:
349
+ log.debug(f"skipping {file} as it has already been extracted")
350
+ continue
351
+
352
+ try:
353
+ context = None
354
+ if file.get("type") == "text":
355
+ context = file["content"]
356
+ else:
357
+ if hybrid_search:
358
+ try:
359
+ context = query_collection_with_hybrid_search(
360
+ collection_names=collection_names,
361
+ queries=queries,
362
+ embedding_function=embedding_function,
363
+ k=k,
364
+ reranking_function=reranking_function,
365
+ r=r,
366
+ )
367
+ except Exception as e:
368
+ log.debug(
369
+ "Error when using hybrid search, using"
370
+ " non hybrid search as fallback."
371
+ )
372
+
373
+ if (not hybrid_search) or (context is None):
374
+ context = query_collection(
375
+ collection_names=collection_names,
376
+ queries=queries,
377
+ embedding_function=embedding_function,
378
+ k=k,
379
+ )
380
+ except Exception as e:
381
+ log.exception(e)
382
+
383
+ extracted_collections.extend(collection_names)
384
+
385
+ if context:
386
+ if "data" in file:
387
+ del file["data"]
388
+ relevant_contexts.append({**context, "file": file})
389
+
390
+ sources = []
391
+ for context in relevant_contexts:
392
+ try:
393
+ if "documents" in context:
394
+ if "metadatas" in context:
395
+ source = {
396
+ "source": context["file"],
397
+ "document": context["documents"][0],
398
+ "metadata": context["metadatas"][0],
399
+ }
400
+ if "distances" in context and context["distances"]:
401
+ source["distances"] = context["distances"][0]
402
+
403
+ sources.append(source)
404
+ except Exception as e:
405
+ log.exception(e)
406
+
407
+ return sources
408
+
409
+
410
+ def get_model_path(model: str, update_model: bool = False):
411
+ # Construct huggingface_hub kwargs with local_files_only to return the snapshot path
412
+ cache_dir = os.getenv("SENTENCE_TRANSFORMERS_HOME")
413
+
414
+ local_files_only = not update_model
415
+
416
+ snapshot_kwargs = {
417
+ "cache_dir": cache_dir,
418
+ "local_files_only": local_files_only,
419
+ }
420
+
421
+ log.debug(f"model: {model}")
422
+ log.debug(f"snapshot_kwargs: {snapshot_kwargs}")
423
+
424
+ # Inspiration from upstream sentence_transformers
425
+ if (
426
+ os.path.exists(model)
427
+ or ("\\" in model or model.count("/") > 1)
428
+ and local_files_only
429
+ ):
430
+ # If fully qualified path exists, return input, else set repo_id
431
+ return model
432
+ elif "/" not in model:
433
+ # Set valid repo_id for model short-name
434
+ model = "sentence-transformers" + "/" + model
435
+
436
+ snapshot_kwargs["repo_id"] = model
437
+
438
+ # Attempt to query the huggingface_hub library to determine the local path and/or to update
439
+ try:
440
+ model_repo_path = snapshot_download(**snapshot_kwargs)
441
+ log.debug(f"model_repo_path: {model_repo_path}")
442
+ return model_repo_path
443
+ except Exception as e:
444
+ log.exception(f"Cannot determine model snapshot path: {e}")
445
+ return model
446
+
447
+
448
+ def generate_openai_batch_embeddings(
449
+ model: str, texts: list[str], url: str = "https://api.openai.com/v1", key: str = ""
450
+ ) -> Optional[list[list[float]]]:
451
+ try:
452
+ r = requests.post(
453
+ f"{url}/embeddings",
454
+ headers={
455
+ "Content-Type": "application/json",
456
+ "Authorization": f"Bearer {key}",
457
+ },
458
+ json={"input": texts, "model": model},
459
+ )
460
+ r.raise_for_status()
461
+ data = r.json()
462
+ if "data" in data:
463
+ return [elem["embedding"] for elem in data["data"]]
464
+ else:
465
+ raise "Something went wrong :/"
466
+ except Exception as e:
467
+ print(e)
468
+ return None
469
+
470
+
471
+ def generate_ollama_batch_embeddings(
472
+ model: str, texts: list[str], url: str, key: str
473
+ ) -> Optional[list[list[float]]]:
474
+ try:
475
+ r = requests.post(
476
+ f"{url}/api/embed",
477
+ headers={
478
+ "Content-Type": "application/json",
479
+ "Authorization": f"Bearer {key}",
480
+ },
481
+ json={"input": texts, "model": model},
482
+ )
483
+ r.raise_for_status()
484
+ data = r.json()
485
+
486
+ if "embeddings" in data:
487
+ return data["embeddings"]
488
+ else:
489
+ raise "Something went wrong :/"
490
+ except Exception as e:
491
+ print(e)
492
+ return None
493
+
494
+
495
+ def generate_embeddings(engine: str, model: str, text: Union[str, list[str]], **kwargs):
496
+ url = kwargs.get("url", "")
497
+ key = kwargs.get("key", "")
498
+
499
+ if engine == "ollama":
500
+ if isinstance(text, list):
501
+ embeddings = generate_ollama_batch_embeddings(
502
+ **{"model": model, "texts": text, "url": url, "key": key}
503
+ )
504
+ else:
505
+ embeddings = generate_ollama_batch_embeddings(
506
+ **{"model": model, "texts": [text], "url": url, "key": key}
507
+ )
508
+ return embeddings[0] if isinstance(text, str) else embeddings
509
+ elif engine == "openai":
510
+ if isinstance(text, list):
511
+ embeddings = generate_openai_batch_embeddings(model, text, url, key)
512
+ else:
513
+ embeddings = generate_openai_batch_embeddings(model, [text], url, key)
514
+
515
+ return embeddings[0] if isinstance(text, str) else embeddings
516
+
517
+
518
+ import operator
519
+ from typing import Optional, Sequence
520
+
521
+ from langchain_core.callbacks import Callbacks
522
+ from langchain_core.documents import BaseDocumentCompressor, Document
523
+
524
+
525
+ class RerankCompressor(BaseDocumentCompressor):
526
+ embedding_function: Any
527
+ top_n: int
528
+ reranking_function: Any
529
+ r_score: float
530
+
531
+ class Config:
532
+ extra = "forbid"
533
+ arbitrary_types_allowed = True
534
+
535
+ def compress_documents(
536
+ self,
537
+ documents: Sequence[Document],
538
+ query: str,
539
+ callbacks: Optional[Callbacks] = None,
540
+ ) -> Sequence[Document]:
541
+ reranking = self.reranking_function is not None
542
+
543
+ if reranking:
544
+ scores = self.reranking_function.predict(
545
+ [(query, doc.page_content) for doc in documents]
546
+ )
547
+ else:
548
+ from sentence_transformers import util
549
+
550
+ query_embedding = self.embedding_function(query)
551
+ document_embedding = self.embedding_function(
552
+ [doc.page_content for doc in documents]
553
+ )
554
+ scores = util.cos_sim(query_embedding, document_embedding)[0]
555
+
556
+ docs_with_scores = list(zip(documents, scores.tolist()))
557
+ if self.r_score:
558
+ docs_with_scores = [
559
+ (d, s) for d, s in docs_with_scores if s >= self.r_score
560
+ ]
561
+
562
+ result = sorted(docs_with_scores, key=operator.itemgetter(1), reverse=True)
563
+ final_results = []
564
+ for doc, doc_score in result[: self.top_n]:
565
+ metadata = doc.metadata
566
+ metadata["score"] = doc_score
567
+ doc = Document(
568
+ page_content=doc.page_content,
569
+ metadata=metadata,
570
+ )
571
+ final_results.append(doc)
572
+ return final_results
backend/open_webui/apps/retrieval/vector/connector.py ADDED
@@ -0,0 +1,22 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ from open_webui.config import VECTOR_DB
2
+
3
+ if VECTOR_DB == "milvus":
4
+ from open_webui.apps.retrieval.vector.dbs.milvus import MilvusClient
5
+
6
+ VECTOR_DB_CLIENT = MilvusClient()
7
+ elif VECTOR_DB == "qdrant":
8
+ from open_webui.apps.retrieval.vector.dbs.qdrant import QdrantClient
9
+
10
+ VECTOR_DB_CLIENT = QdrantClient()
11
+ elif VECTOR_DB == "opensearch":
12
+ from open_webui.apps.retrieval.vector.dbs.opensearch import OpenSearchClient
13
+
14
+ VECTOR_DB_CLIENT = OpenSearchClient()
15
+ elif VECTOR_DB == "pgvector":
16
+ from open_webui.apps.retrieval.vector.dbs.pgvector import PgvectorClient
17
+
18
+ VECTOR_DB_CLIENT = PgvectorClient()
19
+ else:
20
+ from open_webui.apps.retrieval.vector.dbs.chroma import ChromaClient
21
+
22
+ VECTOR_DB_CLIENT = ChromaClient()
backend/open_webui/apps/retrieval/vector/dbs/chroma.py ADDED
@@ -0,0 +1,174 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ import chromadb
2
+ from chromadb import Settings
3
+ from chromadb.utils.batch_utils import create_batches
4
+
5
+ from typing import Optional
6
+
7
+ from open_webui.apps.retrieval.vector.main import VectorItem, SearchResult, GetResult
8
+ from open_webui.config import (
9
+ CHROMA_DATA_PATH,
10
+ CHROMA_HTTP_HOST,
11
+ CHROMA_HTTP_PORT,
12
+ CHROMA_HTTP_HEADERS,
13
+ CHROMA_HTTP_SSL,
14
+ CHROMA_TENANT,
15
+ CHROMA_DATABASE,
16
+ CHROMA_CLIENT_AUTH_PROVIDER,
17
+ CHROMA_CLIENT_AUTH_CREDENTIALS,
18
+ )
19
+
20
+
21
+ class ChromaClient:
22
+ def __init__(self):
23
+ settings_dict = {
24
+ "allow_reset": True,
25
+ "anonymized_telemetry": False,
26
+ }
27
+ if CHROMA_CLIENT_AUTH_PROVIDER is not None:
28
+ settings_dict["chroma_client_auth_provider"] = CHROMA_CLIENT_AUTH_PROVIDER
29
+ if CHROMA_CLIENT_AUTH_CREDENTIALS is not None:
30
+ settings_dict["chroma_client_auth_credentials"] = (
31
+ CHROMA_CLIENT_AUTH_CREDENTIALS
32
+ )
33
+
34
+ if CHROMA_HTTP_HOST != "":
35
+ self.client = chromadb.HttpClient(
36
+ host=CHROMA_HTTP_HOST,
37
+ port=CHROMA_HTTP_PORT,
38
+ headers=CHROMA_HTTP_HEADERS,
39
+ ssl=CHROMA_HTTP_SSL,
40
+ tenant=CHROMA_TENANT,
41
+ database=CHROMA_DATABASE,
42
+ settings=Settings(**settings_dict),
43
+ )
44
+ else:
45
+ self.client = chromadb.PersistentClient(
46
+ path=CHROMA_DATA_PATH,
47
+ settings=Settings(**settings_dict),
48
+ tenant=CHROMA_TENANT,
49
+ database=CHROMA_DATABASE,
50
+ )
51
+
52
+ def has_collection(self, collection_name: str) -> bool:
53
+ # Check if the collection exists based on the collection name.
54
+ collections = self.client.list_collections()
55
+ return collection_name in [collection.name for collection in collections]
56
+
57
+ def delete_collection(self, collection_name: str):
58
+ # Delete the collection based on the collection name.
59
+ return self.client.delete_collection(name=collection_name)
60
+
61
+ def search(
62
+ self, collection_name: str, vectors: list[list[float | int]], limit: int
63
+ ) -> Optional[SearchResult]:
64
+ # Search for the nearest neighbor items based on the vectors and return 'limit' number of results.
65
+ try:
66
+ collection = self.client.get_collection(name=collection_name)
67
+ if collection:
68
+ result = collection.query(
69
+ query_embeddings=vectors,
70
+ n_results=limit,
71
+ )
72
+
73
+ return SearchResult(
74
+ **{
75
+ "ids": result["ids"],
76
+ "distances": result["distances"],
77
+ "documents": result["documents"],
78
+ "metadatas": result["metadatas"],
79
+ }
80
+ )
81
+ return None
82
+ except Exception as e:
83
+ return None
84
+
85
+ def query(
86
+ self, collection_name: str, filter: dict, limit: Optional[int] = None
87
+ ) -> Optional[GetResult]:
88
+ # Query the items from the collection based on the filter.
89
+ try:
90
+ collection = self.client.get_collection(name=collection_name)
91
+ if collection:
92
+ result = collection.get(
93
+ where=filter,
94
+ limit=limit,
95
+ )
96
+
97
+ return GetResult(
98
+ **{
99
+ "ids": [result["ids"]],
100
+ "documents": [result["documents"]],
101
+ "metadatas": [result["metadatas"]],
102
+ }
103
+ )
104
+ return None
105
+ except Exception as e:
106
+ print(e)
107
+ return None
108
+
109
+ def get(self, collection_name: str) -> Optional[GetResult]:
110
+ # Get all the items in the collection.
111
+ collection = self.client.get_collection(name=collection_name)
112
+ if collection:
113
+ result = collection.get()
114
+ return GetResult(
115
+ **{
116
+ "ids": [result["ids"]],
117
+ "documents": [result["documents"]],
118
+ "metadatas": [result["metadatas"]],
119
+ }
120
+ )
121
+ return None
122
+
123
+ def insert(self, collection_name: str, items: list[VectorItem]):
124
+ # Insert the items into the collection, if the collection does not exist, it will be created.
125
+ collection = self.client.get_or_create_collection(
126
+ name=collection_name, metadata={"hnsw:space": "cosine"}
127
+ )
128
+
129
+ ids = [item["id"] for item in items]
130
+ documents = [item["text"] for item in items]
131
+ embeddings = [item["vector"] for item in items]
132
+ metadatas = [item["metadata"] for item in items]
133
+
134
+ for batch in create_batches(
135
+ api=self.client,
136
+ documents=documents,
137
+ embeddings=embeddings,
138
+ ids=ids,
139
+ metadatas=metadatas,
140
+ ):
141
+ collection.add(*batch)
142
+
143
+ def upsert(self, collection_name: str, items: list[VectorItem]):
144
+ # Update the items in the collection, if the items are not present, insert them. If the collection does not exist, it will be created.
145
+ collection = self.client.get_or_create_collection(
146
+ name=collection_name, metadata={"hnsw:space": "cosine"}
147
+ )
148
+
149
+ ids = [item["id"] for item in items]
150
+ documents = [item["text"] for item in items]
151
+ embeddings = [item["vector"] for item in items]
152
+ metadatas = [item["metadata"] for item in items]
153
+
154
+ collection.upsert(
155
+ ids=ids, documents=documents, embeddings=embeddings, metadatas=metadatas
156
+ )
157
+
158
+ def delete(
159
+ self,
160
+ collection_name: str,
161
+ ids: Optional[list[str]] = None,
162
+ filter: Optional[dict] = None,
163
+ ):
164
+ # Delete the items from the collection based on the ids.
165
+ collection = self.client.get_collection(name=collection_name)
166
+ if collection:
167
+ if ids:
168
+ collection.delete(ids=ids)
169
+ elif filter:
170
+ collection.delete(where=filter)
171
+
172
+ def reset(self):
173
+ # Resets the database. This will delete all collections and item entries.
174
+ return self.client.reset()
backend/open_webui/apps/retrieval/vector/dbs/milvus.py ADDED
@@ -0,0 +1,286 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ from pymilvus import MilvusClient as Client
2
+ from pymilvus import FieldSchema, DataType
3
+ import json
4
+
5
+ from typing import Optional
6
+
7
+ from open_webui.apps.retrieval.vector.main import VectorItem, SearchResult, GetResult
8
+ from open_webui.config import (
9
+ MILVUS_URI,
10
+ )
11
+
12
+
13
+ class MilvusClient:
14
+ def __init__(self):
15
+ self.collection_prefix = "open_webui"
16
+ self.client = Client(uri=MILVUS_URI)
17
+
18
+ def _result_to_get_result(self, result) -> GetResult:
19
+ ids = []
20
+ documents = []
21
+ metadatas = []
22
+
23
+ for match in result:
24
+ _ids = []
25
+ _documents = []
26
+ _metadatas = []
27
+ for item in match:
28
+ _ids.append(item.get("id"))
29
+ _documents.append(item.get("data", {}).get("text"))
30
+ _metadatas.append(item.get("metadata"))
31
+
32
+ ids.append(_ids)
33
+ documents.append(_documents)
34
+ metadatas.append(_metadatas)
35
+
36
+ return GetResult(
37
+ **{
38
+ "ids": ids,
39
+ "documents": documents,
40
+ "metadatas": metadatas,
41
+ }
42
+ )
43
+
44
+ def _result_to_search_result(self, result) -> SearchResult:
45
+ ids = []
46
+ distances = []
47
+ documents = []
48
+ metadatas = []
49
+
50
+ for match in result:
51
+ _ids = []
52
+ _distances = []
53
+ _documents = []
54
+ _metadatas = []
55
+
56
+ for item in match:
57
+ _ids.append(item.get("id"))
58
+ _distances.append(item.get("distance"))
59
+ _documents.append(item.get("entity", {}).get("data", {}).get("text"))
60
+ _metadatas.append(item.get("entity", {}).get("metadata"))
61
+
62
+ ids.append(_ids)
63
+ distances.append(_distances)
64
+ documents.append(_documents)
65
+ metadatas.append(_metadatas)
66
+
67
+ return SearchResult(
68
+ **{
69
+ "ids": ids,
70
+ "distances": distances,
71
+ "documents": documents,
72
+ "metadatas": metadatas,
73
+ }
74
+ )
75
+
76
+ def _create_collection(self, collection_name: str, dimension: int):
77
+ schema = self.client.create_schema(
78
+ auto_id=False,
79
+ enable_dynamic_field=True,
80
+ )
81
+ schema.add_field(
82
+ field_name="id",
83
+ datatype=DataType.VARCHAR,
84
+ is_primary=True,
85
+ max_length=65535,
86
+ )
87
+ schema.add_field(
88
+ field_name="vector",
89
+ datatype=DataType.FLOAT_VECTOR,
90
+ dim=dimension,
91
+ description="vector",
92
+ )
93
+ schema.add_field(field_name="data", datatype=DataType.JSON, description="data")
94
+ schema.add_field(
95
+ field_name="metadata", datatype=DataType.JSON, description="metadata"
96
+ )
97
+
98
+ index_params = self.client.prepare_index_params()
99
+ index_params.add_index(
100
+ field_name="vector",
101
+ index_type="HNSW",
102
+ metric_type="COSINE",
103
+ params={"M": 16, "efConstruction": 100},
104
+ )
105
+
106
+ self.client.create_collection(
107
+ collection_name=f"{self.collection_prefix}_{collection_name}",
108
+ schema=schema,
109
+ index_params=index_params,
110
+ )
111
+
112
+ def has_collection(self, collection_name: str) -> bool:
113
+ # Check if the collection exists based on the collection name.
114
+ collection_name = collection_name.replace("-", "_")
115
+ return self.client.has_collection(
116
+ collection_name=f"{self.collection_prefix}_{collection_name}"
117
+ )
118
+
119
+ def delete_collection(self, collection_name: str):
120
+ # Delete the collection based on the collection name.
121
+ collection_name = collection_name.replace("-", "_")
122
+ return self.client.drop_collection(
123
+ collection_name=f"{self.collection_prefix}_{collection_name}"
124
+ )
125
+
126
+ def search(
127
+ self, collection_name: str, vectors: list[list[float | int]], limit: int
128
+ ) -> Optional[SearchResult]:
129
+ # Search for the nearest neighbor items based on the vectors and return 'limit' number of results.
130
+ collection_name = collection_name.replace("-", "_")
131
+ result = self.client.search(
132
+ collection_name=f"{self.collection_prefix}_{collection_name}",
133
+ data=vectors,
134
+ limit=limit,
135
+ output_fields=["data", "metadata"],
136
+ )
137
+
138
+ return self._result_to_search_result(result)
139
+
140
+ def query(self, collection_name: str, filter: dict, limit: Optional[int] = None):
141
+ # Construct the filter string for querying
142
+ collection_name = collection_name.replace("-", "_")
143
+ if not self.has_collection(collection_name):
144
+ return None
145
+
146
+ filter_string = " && ".join(
147
+ [
148
+ f'metadata["{key}"] == {json.dumps(value)}'
149
+ for key, value in filter.items()
150
+ ]
151
+ )
152
+
153
+ max_limit = 16383 # The maximum number of records per request
154
+ all_results = []
155
+
156
+ if limit is None:
157
+ limit = float("inf") # Use infinity as a placeholder for no limit
158
+
159
+ # Initialize offset and remaining to handle pagination
160
+ offset = 0
161
+ remaining = limit
162
+
163
+ try:
164
+ # Loop until there are no more items to fetch or the desired limit is reached
165
+ while remaining > 0:
166
+ print("remaining", remaining)
167
+ current_fetch = min(
168
+ max_limit, remaining
169
+ ) # Determine how many items to fetch in this iteration
170
+
171
+ results = self.client.query(
172
+ collection_name=f"{self.collection_prefix}_{collection_name}",
173
+ filter=filter_string,
174
+ output_fields=["*"],
175
+ limit=current_fetch,
176
+ offset=offset,
177
+ )
178
+
179
+ if not results:
180
+ break
181
+
182
+ all_results.extend(results)
183
+ results_count = len(results)
184
+ remaining -= (
185
+ results_count # Decrease remaining by the number of items fetched
186
+ )
187
+ offset += results_count
188
+
189
+ # Break the loop if the results returned are less than the requested fetch count
190
+ if results_count < current_fetch:
191
+ break
192
+
193
+ print(all_results)
194
+ return self._result_to_get_result([all_results])
195
+ except Exception as e:
196
+ print(e)
197
+ return None
198
+
199
+ def get(self, collection_name: str) -> Optional[GetResult]:
200
+ # Get all the items in the collection.
201
+ collection_name = collection_name.replace("-", "_")
202
+ result = self.client.query(
203
+ collection_name=f"{self.collection_prefix}_{collection_name}",
204
+ filter='id != ""',
205
+ )
206
+ return self._result_to_get_result([result])
207
+
208
+ def insert(self, collection_name: str, items: list[VectorItem]):
209
+ # Insert the items into the collection, if the collection does not exist, it will be created.
210
+ collection_name = collection_name.replace("-", "_")
211
+ if not self.client.has_collection(
212
+ collection_name=f"{self.collection_prefix}_{collection_name}"
213
+ ):
214
+ self._create_collection(
215
+ collection_name=collection_name, dimension=len(items[0]["vector"])
216
+ )
217
+
218
+ return self.client.insert(
219
+ collection_name=f"{self.collection_prefix}_{collection_name}",
220
+ data=[
221
+ {
222
+ "id": item["id"],
223
+ "vector": item["vector"],
224
+ "data": {"text": item["text"]},
225
+ "metadata": item["metadata"],
226
+ }
227
+ for item in items
228
+ ],
229
+ )
230
+
231
+ def upsert(self, collection_name: str, items: list[VectorItem]):
232
+ # Update the items in the collection, if the items are not present, insert them. If the collection does not exist, it will be created.
233
+ collection_name = collection_name.replace("-", "_")
234
+ if not self.client.has_collection(
235
+ collection_name=f"{self.collection_prefix}_{collection_name}"
236
+ ):
237
+ self._create_collection(
238
+ collection_name=collection_name, dimension=len(items[0]["vector"])
239
+ )
240
+
241
+ return self.client.upsert(
242
+ collection_name=f"{self.collection_prefix}_{collection_name}",
243
+ data=[
244
+ {
245
+ "id": item["id"],
246
+ "vector": item["vector"],
247
+ "data": {"text": item["text"]},
248
+ "metadata": item["metadata"],
249
+ }
250
+ for item in items
251
+ ],
252
+ )
253
+
254
+ def delete(
255
+ self,
256
+ collection_name: str,
257
+ ids: Optional[list[str]] = None,
258
+ filter: Optional[dict] = None,
259
+ ):
260
+ # Delete the items from the collection based on the ids.
261
+ collection_name = collection_name.replace("-", "_")
262
+ if ids:
263
+ return self.client.delete(
264
+ collection_name=f"{self.collection_prefix}_{collection_name}",
265
+ ids=ids,
266
+ )
267
+ elif filter:
268
+ # Convert the filter dictionary to a string using JSON_CONTAINS.
269
+ filter_string = " && ".join(
270
+ [
271
+ f'metadata["{key}"] == {json.dumps(value)}'
272
+ for key, value in filter.items()
273
+ ]
274
+ )
275
+
276
+ return self.client.delete(
277
+ collection_name=f"{self.collection_prefix}_{collection_name}",
278
+ filter=filter_string,
279
+ )
280
+
281
+ def reset(self):
282
+ # Resets the database. This will delete all collections and item entries.
283
+ collection_names = self.client.list_collections()
284
+ for collection_name in collection_names:
285
+ if collection_name.startswith(self.collection_prefix):
286
+ self.client.drop_collection(collection_name=collection_name)