From a426f985cf4cd40d099f5e0617ffd382d6c586c7 Mon Sep 17 00:00:00 2001 From: Silentoplayz <50341825+Silentoplayz@users.noreply.github.com> Date: Fri, 20 Dec 2024 15:29:07 -0500 Subject: [PATCH] New "Chat Sharing" page New "Chat Sharing" docs page --- docs/features/PWA.md | 2 + docs/features/chat-overview/chatshare.md | 103 +++++++++++++++++- docs/features/chat-overview/favorite.md | 3 +- docs/features/chat-overview/index.mdx | 4 +- docs/features/memory.md | 2 + docs/features/oauth/index.mdx | 4 +- docs/features/ollama.md | 2 +- docs/features/playgroundbeta/index.mdx | 6 +- docs/features/tasks.md | 4 +- docs/features/usergroups/assign-user.md | 4 +- docs/features/usergroups/index.mdx | 4 +- docs/features/usergroups/providing-access.md | 4 +- docs/features/usergroups/usergroup-perms.md | 4 +- docs/features/videocall.md | 2 + docs/features/voicecall.md | 1 + docs/features/workspace/index.mdx | 4 +- docs/features/workspace/prompts.md | 4 +- docs/troubleshooting/password-reset.mdx | 9 +- docs/tutorials/integrations/web_search.md | 4 +- docs/tutorials/speech-to-text/index.mdx | 6 + docs/tutorials/speech-to-text/openai.md | 6 + docs/tutorials/speech-to-text/webapi.md | 6 + .../tutorials/speech-to-text/whisper-local.md | 6 + 23 files changed, 172 insertions(+), 22 deletions(-) create mode 100644 docs/tutorials/speech-to-text/index.mdx create mode 100644 docs/tutorials/speech-to-text/openai.md create mode 100644 docs/tutorials/speech-to-text/webapi.md create mode 100644 docs/tutorials/speech-to-text/whisper-local.md diff --git a/docs/features/PWA.md b/docs/features/PWA.md index 069401e..565d32b 100644 --- a/docs/features/PWA.md +++ b/docs/features/PWA.md @@ -3,6 +3,8 @@ sidebar_position: 18 title: "๐Ÿ“ฑ Progressive Web App" --- +COMING SOON! + ๐Ÿ“ฑ Progressive Web App for Mobile: Enjoy a native progressive web application experience on your mobile device with offline access on localhost or a personal domain, and a smooth user interface. In order for our PWA to be installable on your device, it must be delivered in a secure context. This usually means that it must be served over HTTPS. To set up a PWA, you'll need some understanding of technologies like Linux, Docker, and reverse proxies such as Nginx, Caddy, or Traefik. Using these tools can help streamline the process of building and deploying a PWA tailored to your needs. While there's no "one-click install" option available, and your available option to securely deploy your Open WebUI instance over HTTPS requires user experience, using these resources can make it easier to create and deploy a PWA tailored to your needs. diff --git a/docs/features/chat-overview/chatshare.md b/docs/features/chat-overview/chatshare.md index b84da99..357c00d 100644 --- a/docs/features/chat-overview/chatshare.md +++ b/docs/features/chat-overview/chatshare.md @@ -1,7 +1,106 @@ --- -sidebar_position: 19 +sidebar_position: 3 title: "๐Ÿ—จ๏ธ Chat Sharing" --- +### Enabling Community Sharing -๐Ÿ—จ๏ธ Local Chat Sharing: Generate and share chat links between users in an efficient and seamless manner, thereby enhancing collaboration and communication. +To enable community sharing, follow these steps: + +1. Navigate to the **Admin Panel** page as an **Admin**. +2. Click on the **Settings** tab. +3. Toggle on **Enable Community Sharing** within the **General** settings tab. + +:::note +**Note:** Only Admins can toggle the **Enable Community Sharing** option. If this option is toggled off, users and Admins will not see the **Share to Open WebUI Community** option for sharing their chats. Community sharing must be enabled by an Admin for users to share chats to the Open WebUI community. +::: + +This will enable community sharing for all users on your Open WebUI instance. + +### Sharing Chats + +To share a chat: + +1. Select the chat conversation you want to share. +2. Click on the 3-dots that appear when hovering the mouse pointer above the desired chat. +3. Then click on the **Share** option. +4. Select either **Share to Open WebUI Community** (if **Enable Community Sharing** is toggled on by an **Admin**) or **Copy Link**. + +#### Sharing to Open WebUI Community + +When you select `Share to Open WebUI Community`: + +* A new tab will open, allowing you to upload your chat as a snapshot to the Open WebUI community website (https://openwebui.com/chats/upload). +* You can control who can view your uploaded chat by choosing from the following access settings: + * **Private**: Only you can access this chat. + * **Public**: Anyone on the internet can view the messages displayed in the chat snapshot. + * **Public, Full History**: Anyone on the internet can view the full regeneration history of your chat. + +:::note +Note: You can change the permission level of your shared chats on the community platform at any time from your openwebui.com account. + +**Currently, shared chats on the community website cannot be found through search. However, future updates are planned to allow public chats to be discoverable by the public if their permission is set to `Public` or `Public, Full History`.** +::: + +Example of a shared chat to the community platform website: https://openwebui.com/c/iamg30/5e3c569f-905e-4d68-a96d-8a99cc65c90f + +#### Copying a Share Link + +When you select `Copy Link`, a unique share link is generated that can be shared with others. + +**Important Considerations:** + +* The shared chat will only include messages that existed at the time the link was created. Any new messages sent within the chat after the link is generated will not be included, unless the link is deleted and updated with a new link. +* The generated share link acts as a static snapshot of the chat at the time the link was generated. +* To view the shared chat, users must: + 1. Have an account on the Open WebUI instance where the link was generated. + 2. Be signed in to their account on that instance. +* If a user tries to access the shared link without being signed in, they will be redirected to the login page to log in before they can view the shared chat. + +### Viewing Shared Chats + +To view a shared chat: + +1. Ensure you are signed in to an account on the Open WebUI instance where the chat was shared. +2. Click on the shared link provided to you. +3. The chat will be displayed in a read-only format. +4. If the Admin of the Open WebUI instance from which the shared link was shared has Text-to-Speech set up, there may be an audio button for messages to be read aloud to you (situational). + +### Updating Shared Chats + +To update a shared chat: + +1. Select the chat conversation you want to share. +2. Click on the 3-dots that appear when hovering the mouse pointer above the desired chat. +3. Click on the **Share** option. +4. The **Share Chat** Modal should look different if you've shared a chat before. + +The **Share Chat** Modal includes the following options: + +* **before**: Opens a new tab to view the previously shared chat from the share link. +* **delete this link**: Deletes the shared link of the chat and presents the initial share chat modal. +* **Share to Open WebUI Community**: Opens a new tab for https://openwebui.com/chats/upload with the chat ready to be shared as a snapshot. +* **Update and Copy Link**: Updates the snapshot of the chat of the previously shared chat link and copies it to your device's clipboard. + +### Deleting Shared Chats + +To delete a shared chat link: + +1. Select the chat conversation you want to delete the shared link for. +2. Click on the 3-dots that appear when hovering the mouse pointer above the desired chat. +3. Click on the **Share** option. +4. The **Share Chat** Modal should look different if you've shared a chat before. +5. Click on **delete this link**. + +Once deleted, the shared link will no longer be valid, and users will not be able to view the shared chat. + +:::note +**Note:** Chats shared to the community platform cannot be deleted. To change the access level of a chat shared to the community platform: +::: + +1. Log in to your Open WebUI account on openwebui.com. +2. Click on your account username at the top right of the website. +3. Click on **Chats**. +4. Click on the chat you wish to change permission access for. +5. Scroll to the bottom of the chat and update its permission level. +6. Click the **Update Chat** button. diff --git a/docs/features/chat-overview/favorite.md b/docs/features/chat-overview/favorite.md index 043cd9d..a2df5b6 100644 --- a/docs/features/chat-overview/favorite.md +++ b/docs/features/chat-overview/favorite.md @@ -3,5 +3,4 @@ sidebar_position: 1 title: "โญ Favorite Response" --- - -Test +COMING SOON! diff --git a/docs/features/chat-overview/index.mdx b/docs/features/chat-overview/index.mdx index 2a692fe..59bc220 100644 --- a/docs/features/chat-overview/index.mdx +++ b/docs/features/chat-overview/index.mdx @@ -1,4 +1,6 @@ --- sidebar_position: 1 title: "๐Ÿ˜ Chat Overview" ---- \ No newline at end of file +--- + +COMING SOON! diff --git a/docs/features/memory.md b/docs/features/memory.md index a25e3d3..6895180 100644 --- a/docs/features/memory.md +++ b/docs/features/memory.md @@ -3,4 +3,6 @@ sidebar_position: 15 title: "๐Ÿง  Memory (Experimental)" --- +COMING SOON! + ๐Ÿง  Memory Feature: Manually add information you want your LLMs to remember via the Settings > Personalization > Memory menu. Memories can be added, edited, and deleted. diff --git a/docs/features/oauth/index.mdx b/docs/features/oauth/index.mdx index e9842c6..576b701 100644 --- a/docs/features/oauth/index.mdx +++ b/docs/features/oauth/index.mdx @@ -1,4 +1,6 @@ --- sidebar_position: 4 title: "๐Ÿ” OAuth" ---- \ No newline at end of file +--- + +COMING SOON! \ No newline at end of file diff --git a/docs/features/ollama.md b/docs/features/ollama.md index 42c2425..dec563b 100644 --- a/docs/features/ollama.md +++ b/docs/features/ollama.md @@ -3,7 +3,7 @@ sidebar_position: 6 title: "โš–๏ธ Ollama Load Balancing" --- -# Ollama Load Balancing Setup +# โš–๏ธ Ollama Load Balancing Setup This guide demonstrates how to configure Open WebUI to connect to multiple Ollama instances for load balancing within your deployment. This approach enables you to distribute processing loads across several nodes, enhancing both performance and reliability. The configuration leverages environment variables to manage connections between container updates, rebuilds, or redeployments seamlessly. diff --git a/docs/features/playgroundbeta/index.mdx b/docs/features/playgroundbeta/index.mdx index fec1eab..01ca298 100644 --- a/docs/features/playgroundbeta/index.mdx +++ b/docs/features/playgroundbeta/index.mdx @@ -3,8 +3,4 @@ sidebar_position: 2 title: "๐Ÿ› Playground (Beta)" --- -import { TopBanners } from "@site/src/components/TopBanners"; - - - -Test \ No newline at end of file +COMING SOON! diff --git a/docs/features/tasks.md b/docs/features/tasks.md index 6c9286b..bdf2c05 100644 --- a/docs/features/tasks.md +++ b/docs/features/tasks.md @@ -1,4 +1,6 @@ --- sidebar_position: 4 title: "๐Ÿ“ Task Model" ---- \ No newline at end of file +--- + +COMING SOON! \ No newline at end of file diff --git a/docs/features/usergroups/assign-user.md b/docs/features/usergroups/assign-user.md index d5a406a..13f5108 100644 --- a/docs/features/usergroups/assign-user.md +++ b/docs/features/usergroups/assign-user.md @@ -1,4 +1,6 @@ --- sidebar_position: 1 title: "๐Ÿ‘ฅ Assign Users to User Group" ---- \ No newline at end of file +--- + +COMING SOON! diff --git a/docs/features/usergroups/index.mdx b/docs/features/usergroups/index.mdx index 187692b..f35a644 100644 --- a/docs/features/usergroups/index.mdx +++ b/docs/features/usergroups/index.mdx @@ -1,4 +1,6 @@ --- sidebar_position: 3 title: "๐Ÿ‘จโ€๐Ÿ‘งโ€๐Ÿ‘ฆ User Groups" ---- \ No newline at end of file +--- + +COMING SOON! diff --git a/docs/features/usergroups/providing-access.md b/docs/features/usergroups/providing-access.md index a5b223d..aec32e9 100644 --- a/docs/features/usergroups/providing-access.md +++ b/docs/features/usergroups/providing-access.md @@ -1,4 +1,6 @@ --- sidebar_position: 2 title: "โœ… Provide User Group Access" ---- \ No newline at end of file +--- + +COMING SOON! diff --git a/docs/features/usergroups/usergroup-perms.md b/docs/features/usergroups/usergroup-perms.md index e4a83be..356ea16 100644 --- a/docs/features/usergroups/usergroup-perms.md +++ b/docs/features/usergroups/usergroup-perms.md @@ -1,4 +1,6 @@ --- sidebar_position: 0 title: "โ˜‘๏ธ User Group Permissions" ---- \ No newline at end of file +--- + +COMING SOON! diff --git a/docs/features/videocall.md b/docs/features/videocall.md index b47a33d..f47badb 100644 --- a/docs/features/videocall.md +++ b/docs/features/videocall.md @@ -3,6 +3,8 @@ sidebar_position: 21 title: "๐Ÿ“น Video Call" --- +COMING SOON! + ๐Ÿ“น Video Call Feature: Enable video calls with supported vision models like LlaVA and GPT-4o, adding a visual dimension to your communications. Both Camera & Microphone access is required using a secure connection over HTTPS for this feature to work. diff --git a/docs/features/voicecall.md b/docs/features/voicecall.md index ce40295..7075011 100644 --- a/docs/features/voicecall.md +++ b/docs/features/voicecall.md @@ -3,6 +3,7 @@ sidebar_position: 20 title: "๐ŸŽ™๏ธ Hands-Free Voice Call" --- +COMING SOON! ๐ŸŽ™๏ธ Hands-Free Voice Call Feature: Initiate voice calls without needing to use your hands, making interactions more seamless. diff --git a/docs/features/workspace/index.mdx b/docs/features/workspace/index.mdx index 10f0724..5b8b066 100644 --- a/docs/features/workspace/index.mdx +++ b/docs/features/workspace/index.mdx @@ -1,4 +1,6 @@ --- sidebar_position: 0 title: "๐Ÿ–ฅ๏ธ Workspace" ---- \ No newline at end of file +--- + +COMING SOON! diff --git a/docs/features/workspace/prompts.md b/docs/features/workspace/prompts.md index 1320947..a570551 100644 --- a/docs/features/workspace/prompts.md +++ b/docs/features/workspace/prompts.md @@ -1,4 +1,6 @@ --- sidebar_position: 2 title: "๐Ÿ“š Prompts" ---- \ No newline at end of file +--- + +COMING SOON! diff --git a/docs/troubleshooting/password-reset.mdx b/docs/troubleshooting/password-reset.mdx index 7af9aa3..e86b94b 100644 --- a/docs/troubleshooting/password-reset.mdx +++ b/docs/troubleshooting/password-reset.mdx @@ -19,9 +19,13 @@ First, you need to create a bcrypt hash of your new password. Run the following htpasswd -bnBC 10 "" your-new-password | tr -d ':\n' ``` +**Note:** The output will include a bcrypt hash with special characters that need to be handled carefully. Any `$` characters in the hash will need to be triple-escaped (replaced with `\\\`) to be used correctly in the next step. + ### Step 2: Update the Password in Docker ๐Ÿ”„ -Next, you'll update the password in your Docker deployment. Replace `HASH` in the command below with the bcrypt hash generated in Step 1. Also, replace `admin@example.com` with the email address linked to your admin account. +Next, you'll update the password in your Docker deployment. Replace `HASH` in the command below with the bcrypt hash generated in Step 1, making sure to triple-escape any `$` characters. Also, replace `admin@example.com` with the email address linked to your admin account. + +**Important:** The following command may not work in all cases. If it doesn't work for you, try the alternative command below it. ```bash docker run --rm -v open-webui:/data alpine/socat EXEC:"bash -c 'apk add sqlite && echo UPDATE auth SET password='\''HASH'\'' WHERE email='\''admin@example.com'\''; | sqlite3 /data/webui.db'", STDIO @@ -49,4 +53,5 @@ sqlite3 backend/data/webui.db "UPDATE auth SET password='HASH' WHERE email='admi --- -๐Ÿ“– By following these straightforward steps, you'll regain access to your Open WebUI admin account in no time. If you encounter any issues during the process, please consider searching for your issue on forums or community platforms. \ No newline at end of file +๐Ÿ“– By following these straightforward steps, you'll regain access to your Open WebUI admin account in no time. If you encounter any issues during the process, please consider searching for your issue on forums or community platforms. +``` \ No newline at end of file diff --git a/docs/tutorials/integrations/web_search.md b/docs/tutorials/integrations/web_search.md index 0601e0c..5feaa34 100644 --- a/docs/tutorials/integrations/web_search.md +++ b/docs/tutorials/integrations/web_search.md @@ -21,7 +21,7 @@ If you want to modify the default configuration, follow these steps: git clone https://github.com/searxng/searxng-docker.git ``` -1. Navigate to the `searxng-docker` repository: +2. Navigate to the `searxng-docker` repository: ```bash cd searxng-docker @@ -109,6 +109,8 @@ search: # json is required ``` +The port in the settings.yml file for SearXNG should match that of the port number in your docker-compose.yml file for SearXNG. So if you plan to use port `1337` for example, you'd set both to `1337`. If you want to use port `8080`, keep both on `8080`. Feel free to change the `bind_address` from `0.0.0.0` to `127.0.0.1` instead. Leaving it on `0.0.0.0` means that SearXNG can listen across all interfaces, while `127.0.0.1` just means that its listening on localhost. + 8. Your `searxng-docker/uwsgi.ini` file for SearXNG should look like: diff --git a/docs/tutorials/speech-to-text/index.mdx b/docs/tutorials/speech-to-text/index.mdx new file mode 100644 index 0000000..5f29a2b --- /dev/null +++ b/docs/tutorials/speech-to-text/index.mdx @@ -0,0 +1,6 @@ +--- +sidebar_position: 3 +title: "๐Ÿ—จ๏ธ Speech-to-Text" +--- + +Coming soon! \ No newline at end of file diff --git a/docs/tutorials/speech-to-text/openai.md b/docs/tutorials/speech-to-text/openai.md new file mode 100644 index 0000000..1ebbc78 --- /dev/null +++ b/docs/tutorials/speech-to-text/openai.md @@ -0,0 +1,6 @@ +--- +sidebar_position: 1 +title: "๐Ÿ—จ๏ธ OpenAI API" +--- + +Coming soon! diff --git a/docs/tutorials/speech-to-text/webapi.md b/docs/tutorials/speech-to-text/webapi.md new file mode 100644 index 0000000..341598e --- /dev/null +++ b/docs/tutorials/speech-to-text/webapi.md @@ -0,0 +1,6 @@ +--- +sidebar_position: 2 +title: "๐Ÿ—จ๏ธ Web API" +--- + +Coming soon! diff --git a/docs/tutorials/speech-to-text/whisper-local.md b/docs/tutorials/speech-to-text/whisper-local.md new file mode 100644 index 0000000..1ed40a3 --- /dev/null +++ b/docs/tutorials/speech-to-text/whisper-local.md @@ -0,0 +1,6 @@ +--- +sidebar_position: 0 +title: "๐Ÿ—จ๏ธ Whisper (Local)" +--- + +Coming soon! \ No newline at end of file