main.py 67 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009
  1. import asyncio
  2. import inspect
  3. import json
  4. import logging
  5. import mimetypes
  6. import os
  7. import shutil
  8. import sys
  9. import time
  10. import random
  11. from uuid import uuid4
  12. from contextlib import asynccontextmanager
  13. from urllib.parse import urlencode, parse_qs, urlparse
  14. from pydantic import BaseModel
  15. from sqlalchemy import text
  16. from typing import Optional
  17. from aiocache import cached
  18. import aiohttp
  19. import anyio.to_thread
  20. import requests
  21. from redis import Redis
  22. from fastapi import (
  23. Depends,
  24. FastAPI,
  25. File,
  26. Form,
  27. HTTPException,
  28. Request,
  29. UploadFile,
  30. status,
  31. applications,
  32. BackgroundTasks,
  33. )
  34. from fastapi.openapi.docs import get_swagger_ui_html
  35. from fastapi.middleware.cors import CORSMiddleware
  36. from fastapi.responses import FileResponse, JSONResponse, RedirectResponse
  37. from fastapi.staticfiles import StaticFiles
  38. from starlette_compress import CompressMiddleware
  39. from starlette.exceptions import HTTPException as StarletteHTTPException
  40. from starlette.middleware.base import BaseHTTPMiddleware
  41. from starlette.middleware.sessions import SessionMiddleware
  42. from starlette.responses import Response, StreamingResponse
  43. from starlette.datastructures import Headers
  44. from open_webui.utils import logger
  45. from open_webui.utils.audit import AuditLevel, AuditLoggingMiddleware
  46. from open_webui.utils.logger import start_logger
  47. from open_webui.socket.main import (
  48. app as socket_app,
  49. periodic_usage_pool_cleanup,
  50. get_event_emitter,
  51. get_models_in_use,
  52. get_active_user_ids,
  53. )
  54. from open_webui.routers import (
  55. audio,
  56. images,
  57. ollama,
  58. openai,
  59. retrieval,
  60. pipelines,
  61. tasks,
  62. auths,
  63. channels,
  64. chats,
  65. notes,
  66. folders,
  67. configs,
  68. groups,
  69. files,
  70. functions,
  71. memories,
  72. models,
  73. knowledge,
  74. prompts,
  75. evaluations,
  76. tools,
  77. users,
  78. utils,
  79. scim,
  80. )
  81. from open_webui.routers.retrieval import (
  82. get_embedding_function,
  83. get_reranking_function,
  84. get_ef,
  85. get_rf,
  86. )
  87. from open_webui.internal.db import Session, engine
  88. from open_webui.models.functions import Functions
  89. from open_webui.models.models import Models
  90. from open_webui.models.users import UserModel, Users
  91. from open_webui.models.chats import Chats
  92. from open_webui.config import (
  93. # Ollama
  94. ENABLE_OLLAMA_API,
  95. OLLAMA_BASE_URLS,
  96. OLLAMA_API_CONFIGS,
  97. # OpenAI
  98. ENABLE_OPENAI_API,
  99. ONEDRIVE_CLIENT_ID,
  100. ONEDRIVE_SHAREPOINT_URL,
  101. ONEDRIVE_SHAREPOINT_TENANT_ID,
  102. OPENAI_API_BASE_URLS,
  103. OPENAI_API_KEYS,
  104. OPENAI_API_CONFIGS,
  105. # Direct Connections
  106. ENABLE_DIRECT_CONNECTIONS,
  107. # Model list
  108. ENABLE_BASE_MODELS_CACHE,
  109. # Thread pool size for FastAPI/AnyIO
  110. THREAD_POOL_SIZE,
  111. # Tool Server Configs
  112. TOOL_SERVER_CONNECTIONS,
  113. # Code Execution
  114. ENABLE_CODE_EXECUTION,
  115. CODE_EXECUTION_ENGINE,
  116. CODE_EXECUTION_JUPYTER_URL,
  117. CODE_EXECUTION_JUPYTER_AUTH,
  118. CODE_EXECUTION_JUPYTER_AUTH_TOKEN,
  119. CODE_EXECUTION_JUPYTER_AUTH_PASSWORD,
  120. CODE_EXECUTION_JUPYTER_TIMEOUT,
  121. ENABLE_CODE_INTERPRETER,
  122. CODE_INTERPRETER_ENGINE,
  123. CODE_INTERPRETER_PROMPT_TEMPLATE,
  124. CODE_INTERPRETER_JUPYTER_URL,
  125. CODE_INTERPRETER_JUPYTER_AUTH,
  126. CODE_INTERPRETER_JUPYTER_AUTH_TOKEN,
  127. CODE_INTERPRETER_JUPYTER_AUTH_PASSWORD,
  128. CODE_INTERPRETER_JUPYTER_TIMEOUT,
  129. # Image
  130. AUTOMATIC1111_API_AUTH,
  131. AUTOMATIC1111_BASE_URL,
  132. AUTOMATIC1111_CFG_SCALE,
  133. AUTOMATIC1111_SAMPLER,
  134. AUTOMATIC1111_SCHEDULER,
  135. COMFYUI_BASE_URL,
  136. COMFYUI_API_KEY,
  137. COMFYUI_WORKFLOW,
  138. COMFYUI_WORKFLOW_NODES,
  139. ENABLE_IMAGE_GENERATION,
  140. ENABLE_IMAGE_PROMPT_GENERATION,
  141. IMAGE_GENERATION_ENGINE,
  142. IMAGE_GENERATION_MODEL,
  143. IMAGE_SIZE,
  144. IMAGE_STEPS,
  145. IMAGES_OPENAI_API_BASE_URL,
  146. IMAGES_OPENAI_API_VERSION,
  147. IMAGES_OPENAI_API_KEY,
  148. IMAGES_GEMINI_API_BASE_URL,
  149. IMAGES_GEMINI_API_KEY,
  150. # Audio
  151. AUDIO_STT_ENGINE,
  152. AUDIO_STT_MODEL,
  153. AUDIO_STT_SUPPORTED_CONTENT_TYPES,
  154. AUDIO_STT_OPENAI_API_BASE_URL,
  155. AUDIO_STT_OPENAI_API_KEY,
  156. AUDIO_STT_AZURE_API_KEY,
  157. AUDIO_STT_AZURE_REGION,
  158. AUDIO_STT_AZURE_LOCALES,
  159. AUDIO_STT_AZURE_BASE_URL,
  160. AUDIO_STT_AZURE_MAX_SPEAKERS,
  161. AUDIO_TTS_API_KEY,
  162. AUDIO_TTS_ENGINE,
  163. AUDIO_TTS_MODEL,
  164. AUDIO_TTS_OPENAI_API_BASE_URL,
  165. AUDIO_TTS_OPENAI_API_KEY,
  166. AUDIO_TTS_SPLIT_ON,
  167. AUDIO_TTS_VOICE,
  168. AUDIO_TTS_AZURE_SPEECH_REGION,
  169. AUDIO_TTS_AZURE_SPEECH_BASE_URL,
  170. AUDIO_TTS_AZURE_SPEECH_OUTPUT_FORMAT,
  171. PLAYWRIGHT_WS_URL,
  172. PLAYWRIGHT_TIMEOUT,
  173. FIRECRAWL_API_BASE_URL,
  174. FIRECRAWL_API_KEY,
  175. WEB_LOADER_ENGINE,
  176. WEB_LOADER_CONCURRENT_REQUESTS,
  177. WHISPER_MODEL,
  178. WHISPER_VAD_FILTER,
  179. WHISPER_LANGUAGE,
  180. DEEPGRAM_API_KEY,
  181. WHISPER_MODEL_AUTO_UPDATE,
  182. WHISPER_MODEL_DIR,
  183. # Retrieval
  184. RAG_TEMPLATE,
  185. DEFAULT_RAG_TEMPLATE,
  186. RAG_FULL_CONTEXT,
  187. BYPASS_EMBEDDING_AND_RETRIEVAL,
  188. RAG_EMBEDDING_MODEL,
  189. RAG_EMBEDDING_MODEL_AUTO_UPDATE,
  190. RAG_EMBEDDING_MODEL_TRUST_REMOTE_CODE,
  191. RAG_RERANKING_ENGINE,
  192. RAG_RERANKING_MODEL,
  193. RAG_EXTERNAL_RERANKER_URL,
  194. RAG_EXTERNAL_RERANKER_API_KEY,
  195. RAG_RERANKING_MODEL_AUTO_UPDATE,
  196. RAG_RERANKING_MODEL_TRUST_REMOTE_CODE,
  197. RAG_EMBEDDING_ENGINE,
  198. RAG_EMBEDDING_BATCH_SIZE,
  199. RAG_TOP_K,
  200. RAG_TOP_K_RERANKER,
  201. RAG_RELEVANCE_THRESHOLD,
  202. RAG_HYBRID_BM25_WEIGHT,
  203. RAG_ALLOWED_FILE_EXTENSIONS,
  204. RAG_FILE_MAX_COUNT,
  205. RAG_FILE_MAX_SIZE,
  206. FILE_IMAGE_COMPRESSION_WIDTH,
  207. FILE_IMAGE_COMPRESSION_HEIGHT,
  208. RAG_OPENAI_API_BASE_URL,
  209. RAG_OPENAI_API_KEY,
  210. RAG_AZURE_OPENAI_BASE_URL,
  211. RAG_AZURE_OPENAI_API_KEY,
  212. RAG_AZURE_OPENAI_API_VERSION,
  213. RAG_OLLAMA_BASE_URL,
  214. RAG_OLLAMA_API_KEY,
  215. CHUNK_OVERLAP,
  216. CHUNK_SIZE,
  217. CONTENT_EXTRACTION_ENGINE,
  218. DATALAB_MARKER_API_KEY,
  219. DATALAB_MARKER_API_BASE_URL,
  220. DATALAB_MARKER_ADDITIONAL_CONFIG,
  221. DATALAB_MARKER_SKIP_CACHE,
  222. DATALAB_MARKER_FORCE_OCR,
  223. DATALAB_MARKER_PAGINATE,
  224. DATALAB_MARKER_STRIP_EXISTING_OCR,
  225. DATALAB_MARKER_DISABLE_IMAGE_EXTRACTION,
  226. DATALAB_MARKER_FORMAT_LINES,
  227. DATALAB_MARKER_OUTPUT_FORMAT,
  228. DATALAB_MARKER_USE_LLM,
  229. EXTERNAL_DOCUMENT_LOADER_URL,
  230. EXTERNAL_DOCUMENT_LOADER_API_KEY,
  231. TIKA_SERVER_URL,
  232. DOCLING_SERVER_URL,
  233. DOCLING_OCR_ENGINE,
  234. DOCLING_OCR_LANG,
  235. DOCLING_DO_PICTURE_DESCRIPTION,
  236. DOCLING_PICTURE_DESCRIPTION_MODE,
  237. DOCLING_PICTURE_DESCRIPTION_LOCAL,
  238. DOCLING_PICTURE_DESCRIPTION_API,
  239. DOCUMENT_INTELLIGENCE_ENDPOINT,
  240. DOCUMENT_INTELLIGENCE_KEY,
  241. MISTRAL_OCR_API_KEY,
  242. RAG_TEXT_SPLITTER,
  243. TIKTOKEN_ENCODING_NAME,
  244. PDF_EXTRACT_IMAGES,
  245. YOUTUBE_LOADER_LANGUAGE,
  246. YOUTUBE_LOADER_PROXY_URL,
  247. # Retrieval (Web Search)
  248. ENABLE_WEB_SEARCH,
  249. WEB_SEARCH_ENGINE,
  250. BYPASS_WEB_SEARCH_EMBEDDING_AND_RETRIEVAL,
  251. BYPASS_WEB_SEARCH_WEB_LOADER,
  252. WEB_SEARCH_RESULT_COUNT,
  253. WEB_SEARCH_CONCURRENT_REQUESTS,
  254. WEB_SEARCH_TRUST_ENV,
  255. WEB_SEARCH_DOMAIN_FILTER_LIST,
  256. JINA_API_KEY,
  257. SEARCHAPI_API_KEY,
  258. SEARCHAPI_ENGINE,
  259. SERPAPI_API_KEY,
  260. SERPAPI_ENGINE,
  261. SEARXNG_QUERY_URL,
  262. YACY_QUERY_URL,
  263. YACY_USERNAME,
  264. YACY_PASSWORD,
  265. SERPER_API_KEY,
  266. SERPLY_API_KEY,
  267. SERPSTACK_API_KEY,
  268. SERPSTACK_HTTPS,
  269. TAVILY_API_KEY,
  270. TAVILY_EXTRACT_DEPTH,
  271. BING_SEARCH_V7_ENDPOINT,
  272. BING_SEARCH_V7_SUBSCRIPTION_KEY,
  273. BRAVE_SEARCH_API_KEY,
  274. EXA_API_KEY,
  275. PERPLEXITY_API_KEY,
  276. PERPLEXITY_MODEL,
  277. PERPLEXITY_SEARCH_CONTEXT_USAGE,
  278. SOUGOU_API_SID,
  279. SOUGOU_API_SK,
  280. KAGI_SEARCH_API_KEY,
  281. MOJEEK_SEARCH_API_KEY,
  282. BOCHA_SEARCH_API_KEY,
  283. GOOGLE_PSE_API_KEY,
  284. GOOGLE_PSE_ENGINE_ID,
  285. GOOGLE_DRIVE_CLIENT_ID,
  286. GOOGLE_DRIVE_API_KEY,
  287. ONEDRIVE_CLIENT_ID,
  288. ONEDRIVE_SHAREPOINT_URL,
  289. ONEDRIVE_SHAREPOINT_TENANT_ID,
  290. ENABLE_RAG_HYBRID_SEARCH,
  291. ENABLE_RAG_LOCAL_WEB_FETCH,
  292. ENABLE_WEB_LOADER_SSL_VERIFICATION,
  293. ENABLE_GOOGLE_DRIVE_INTEGRATION,
  294. ENABLE_ONEDRIVE_INTEGRATION,
  295. UPLOAD_DIR,
  296. EXTERNAL_WEB_SEARCH_URL,
  297. EXTERNAL_WEB_SEARCH_API_KEY,
  298. EXTERNAL_WEB_LOADER_URL,
  299. EXTERNAL_WEB_LOADER_API_KEY,
  300. # WebUI
  301. WEBUI_AUTH,
  302. WEBUI_NAME,
  303. WEBUI_BANNERS,
  304. WEBHOOK_URL,
  305. ADMIN_EMAIL,
  306. SHOW_ADMIN_DETAILS,
  307. JWT_EXPIRES_IN,
  308. ENABLE_SIGNUP,
  309. ENABLE_LOGIN_FORM,
  310. ENABLE_API_KEY,
  311. ENABLE_API_KEY_ENDPOINT_RESTRICTIONS,
  312. API_KEY_ALLOWED_ENDPOINTS,
  313. ENABLE_CHANNELS,
  314. ENABLE_NOTES,
  315. ENABLE_COMMUNITY_SHARING,
  316. ENABLE_MESSAGE_RATING,
  317. ENABLE_USER_WEBHOOKS,
  318. ENABLE_EVALUATION_ARENA_MODELS,
  319. BYPASS_ADMIN_ACCESS_CONTROL,
  320. USER_PERMISSIONS,
  321. DEFAULT_USER_ROLE,
  322. PENDING_USER_OVERLAY_CONTENT,
  323. PENDING_USER_OVERLAY_TITLE,
  324. DEFAULT_PROMPT_SUGGESTIONS,
  325. DEFAULT_MODELS,
  326. DEFAULT_ARENA_MODEL,
  327. MODEL_ORDER_LIST,
  328. EVALUATION_ARENA_MODELS,
  329. # WebUI (OAuth)
  330. ENABLE_OAUTH_ROLE_MANAGEMENT,
  331. OAUTH_ROLES_CLAIM,
  332. OAUTH_EMAIL_CLAIM,
  333. OAUTH_PICTURE_CLAIM,
  334. OAUTH_USERNAME_CLAIM,
  335. OAUTH_ALLOWED_ROLES,
  336. OAUTH_ADMIN_ROLES,
  337. # WebUI (LDAP)
  338. ENABLE_LDAP,
  339. LDAP_SERVER_LABEL,
  340. LDAP_SERVER_HOST,
  341. LDAP_SERVER_PORT,
  342. LDAP_ATTRIBUTE_FOR_MAIL,
  343. LDAP_ATTRIBUTE_FOR_USERNAME,
  344. LDAP_SEARCH_FILTERS,
  345. LDAP_SEARCH_BASE,
  346. LDAP_APP_DN,
  347. LDAP_APP_PASSWORD,
  348. LDAP_USE_TLS,
  349. LDAP_CA_CERT_FILE,
  350. LDAP_VALIDATE_CERT,
  351. LDAP_CIPHERS,
  352. # LDAP Group Management
  353. ENABLE_LDAP_GROUP_MANAGEMENT,
  354. ENABLE_LDAP_GROUP_CREATION,
  355. LDAP_ATTRIBUTE_FOR_GROUPS,
  356. # Misc
  357. ENV,
  358. CACHE_DIR,
  359. STATIC_DIR,
  360. FRONTEND_BUILD_DIR,
  361. CORS_ALLOW_ORIGIN,
  362. DEFAULT_LOCALE,
  363. OAUTH_PROVIDERS,
  364. WEBUI_URL,
  365. RESPONSE_WATERMARK,
  366. # Admin
  367. ENABLE_ADMIN_CHAT_ACCESS,
  368. BYPASS_ADMIN_ACCESS_CONTROL,
  369. ENABLE_ADMIN_EXPORT,
  370. # Tasks
  371. TASK_MODEL,
  372. TASK_MODEL_EXTERNAL,
  373. ENABLE_TAGS_GENERATION,
  374. ENABLE_TITLE_GENERATION,
  375. ENABLE_FOLLOW_UP_GENERATION,
  376. ENABLE_SEARCH_QUERY_GENERATION,
  377. ENABLE_RETRIEVAL_QUERY_GENERATION,
  378. ENABLE_AUTOCOMPLETE_GENERATION,
  379. TITLE_GENERATION_PROMPT_TEMPLATE,
  380. FOLLOW_UP_GENERATION_PROMPT_TEMPLATE,
  381. TAGS_GENERATION_PROMPT_TEMPLATE,
  382. IMAGE_PROMPT_GENERATION_PROMPT_TEMPLATE,
  383. TOOLS_FUNCTION_CALLING_PROMPT_TEMPLATE,
  384. QUERY_GENERATION_PROMPT_TEMPLATE,
  385. AUTOCOMPLETE_GENERATION_PROMPT_TEMPLATE,
  386. AUTOCOMPLETE_GENERATION_INPUT_MAX_LENGTH,
  387. AppConfig,
  388. reset_config,
  389. )
  390. from open_webui.env import (
  391. LICENSE_KEY,
  392. AUDIT_EXCLUDED_PATHS,
  393. AUDIT_LOG_LEVEL,
  394. CHANGELOG,
  395. REDIS_URL,
  396. REDIS_CLUSTER,
  397. REDIS_KEY_PREFIX,
  398. REDIS_SENTINEL_HOSTS,
  399. REDIS_SENTINEL_PORT,
  400. GLOBAL_LOG_LEVEL,
  401. MAX_BODY_LOG_SIZE,
  402. SAFE_MODE,
  403. SRC_LOG_LEVELS,
  404. VERSION,
  405. INSTANCE_ID,
  406. WEBUI_BUILD_HASH,
  407. WEBUI_SECRET_KEY,
  408. WEBUI_SESSION_COOKIE_SAME_SITE,
  409. WEBUI_SESSION_COOKIE_SECURE,
  410. ENABLE_SIGNUP_PASSWORD_CONFIRMATION,
  411. WEBUI_AUTH_TRUSTED_EMAIL_HEADER,
  412. WEBUI_AUTH_TRUSTED_NAME_HEADER,
  413. WEBUI_AUTH_SIGNOUT_REDIRECT_URL,
  414. # SCIM
  415. SCIM_ENABLED,
  416. SCIM_TOKEN,
  417. ENABLE_COMPRESSION_MIDDLEWARE,
  418. ENABLE_WEBSOCKET_SUPPORT,
  419. BYPASS_MODEL_ACCESS_CONTROL,
  420. RESET_CONFIG_ON_START,
  421. ENABLE_VERSION_UPDATE_CHECK,
  422. ENABLE_OTEL,
  423. EXTERNAL_PWA_MANIFEST_URL,
  424. AIOHTTP_CLIENT_SESSION_SSL,
  425. )
  426. from open_webui.utils.models import (
  427. get_all_models,
  428. get_all_base_models,
  429. check_model_access,
  430. )
  431. from open_webui.utils.chat import (
  432. generate_chat_completion as chat_completion_handler,
  433. chat_completed as chat_completed_handler,
  434. chat_action as chat_action_handler,
  435. )
  436. from open_webui.utils.embeddings import generate_embeddings
  437. from open_webui.utils.middleware import process_chat_payload, process_chat_response
  438. from open_webui.utils.access_control import has_access
  439. from open_webui.utils.auth import (
  440. get_license_data,
  441. get_http_authorization_cred,
  442. decode_token,
  443. get_admin_user,
  444. get_verified_user,
  445. )
  446. from open_webui.utils.plugin import install_tool_and_function_dependencies
  447. from open_webui.utils.oauth import OAuthManager
  448. from open_webui.utils.security_headers import SecurityHeadersMiddleware
  449. from open_webui.utils.redis import get_redis_connection
  450. from open_webui.tasks import (
  451. redis_task_command_listener,
  452. list_task_ids_by_item_id,
  453. create_task,
  454. stop_task,
  455. list_tasks,
  456. ) # Import from tasks.py
  457. from open_webui.utils.redis import get_sentinels_from_env
  458. from open_webui.constants import ERROR_MESSAGES
  459. if SAFE_MODE:
  460. print("SAFE MODE ENABLED")
  461. Functions.deactivate_all_functions()
  462. logging.basicConfig(stream=sys.stdout, level=GLOBAL_LOG_LEVEL)
  463. log = logging.getLogger(__name__)
  464. log.setLevel(SRC_LOG_LEVELS["MAIN"])
  465. class SPAStaticFiles(StaticFiles):
  466. async def get_response(self, path: str, scope):
  467. try:
  468. return await super().get_response(path, scope)
  469. except (HTTPException, StarletteHTTPException) as ex:
  470. if ex.status_code == 404:
  471. if path.endswith(".js"):
  472. # Return 404 for javascript files
  473. raise ex
  474. else:
  475. return await super().get_response("index.html", scope)
  476. else:
  477. raise ex
  478. print(
  479. rf"""
  480. ██████╗ ██████╗ ███████╗███╗ ██╗ ██╗ ██╗███████╗██████╗ ██╗ ██╗██╗
  481. ██╔═══██╗██╔══██╗██╔════╝████╗ ██║ ██║ ██║██╔════╝██╔══██╗██║ ██║██║
  482. ██║ ██║██████╔╝█████╗ ██╔██╗ ██║ ██║ █╗ ██║█████╗ ██████╔╝██║ ██║██║
  483. ██║ ██║██╔═══╝ ██╔══╝ ██║╚██╗██║ ██║███╗██║██╔══╝ ██╔══██╗██║ ██║██║
  484. ╚██████╔╝██║ ███████╗██║ ╚████║ ╚███╔███╔╝███████╗██████╔╝╚██████╔╝██║
  485. ╚═════╝ ╚═╝ ╚══════╝╚═╝ ╚═══╝ ╚══╝╚══╝ ╚══════╝╚═════╝ ╚═════╝ ╚═╝
  486. v{VERSION} - building the best AI user interface.
  487. {f"Commit: {WEBUI_BUILD_HASH}" if WEBUI_BUILD_HASH != "dev-build" else ""}
  488. https://github.com/open-webui/open-webui
  489. """
  490. )
  491. @asynccontextmanager
  492. async def lifespan(app: FastAPI):
  493. app.state.instance_id = INSTANCE_ID
  494. start_logger()
  495. if RESET_CONFIG_ON_START:
  496. reset_config()
  497. if LICENSE_KEY:
  498. get_license_data(app, LICENSE_KEY)
  499. # This should be blocking (sync) so functions are not deactivated on first /get_models calls
  500. # when the first user lands on the / route.
  501. log.info("Installing external dependencies of functions and tools...")
  502. install_tool_and_function_dependencies()
  503. app.state.redis = get_redis_connection(
  504. redis_url=REDIS_URL,
  505. redis_sentinels=get_sentinels_from_env(
  506. REDIS_SENTINEL_HOSTS, REDIS_SENTINEL_PORT
  507. ),
  508. redis_cluster=REDIS_CLUSTER,
  509. async_mode=True,
  510. )
  511. if app.state.redis is not None:
  512. app.state.redis_task_command_listener = asyncio.create_task(
  513. redis_task_command_listener(app)
  514. )
  515. if THREAD_POOL_SIZE and THREAD_POOL_SIZE > 0:
  516. limiter = anyio.to_thread.current_default_thread_limiter()
  517. limiter.total_tokens = THREAD_POOL_SIZE
  518. asyncio.create_task(periodic_usage_pool_cleanup())
  519. if app.state.config.ENABLE_BASE_MODELS_CACHE:
  520. await get_all_models(
  521. Request(
  522. # Creating a mock request object to pass to get_all_models
  523. {
  524. "type": "http",
  525. "asgi.version": "3.0",
  526. "asgi.spec_version": "2.0",
  527. "method": "GET",
  528. "path": "/internal",
  529. "query_string": b"",
  530. "headers": Headers({}).raw,
  531. "client": ("127.0.0.1", 12345),
  532. "server": ("127.0.0.1", 80),
  533. "scheme": "http",
  534. "app": app,
  535. }
  536. ),
  537. None,
  538. )
  539. yield
  540. if hasattr(app.state, "redis_task_command_listener"):
  541. app.state.redis_task_command_listener.cancel()
  542. app = FastAPI(
  543. title="Open WebUI",
  544. docs_url="/docs" if ENV == "dev" else None,
  545. openapi_url="/openapi.json" if ENV == "dev" else None,
  546. redoc_url=None,
  547. lifespan=lifespan,
  548. )
  549. oauth_manager = OAuthManager(app)
  550. app.state.oauth_manager = oauth_manager
  551. app.state.instance_id = None
  552. app.state.config = AppConfig(
  553. redis_url=REDIS_URL,
  554. redis_sentinels=get_sentinels_from_env(REDIS_SENTINEL_HOSTS, REDIS_SENTINEL_PORT),
  555. redis_cluster=REDIS_CLUSTER,
  556. redis_key_prefix=REDIS_KEY_PREFIX,
  557. )
  558. app.state.redis = None
  559. app.state.WEBUI_NAME = WEBUI_NAME
  560. app.state.LICENSE_METADATA = None
  561. ########################################
  562. #
  563. # OPENTELEMETRY
  564. #
  565. ########################################
  566. if ENABLE_OTEL:
  567. from open_webui.utils.telemetry.setup import setup as setup_opentelemetry
  568. setup_opentelemetry(app=app, db_engine=engine)
  569. ########################################
  570. #
  571. # OLLAMA
  572. #
  573. ########################################
  574. app.state.config.ENABLE_OLLAMA_API = ENABLE_OLLAMA_API
  575. app.state.config.OLLAMA_BASE_URLS = OLLAMA_BASE_URLS
  576. app.state.config.OLLAMA_API_CONFIGS = OLLAMA_API_CONFIGS
  577. app.state.OLLAMA_MODELS = {}
  578. ########################################
  579. #
  580. # OPENAI
  581. #
  582. ########################################
  583. app.state.config.ENABLE_OPENAI_API = ENABLE_OPENAI_API
  584. app.state.config.OPENAI_API_BASE_URLS = OPENAI_API_BASE_URLS
  585. app.state.config.OPENAI_API_KEYS = OPENAI_API_KEYS
  586. app.state.config.OPENAI_API_CONFIGS = OPENAI_API_CONFIGS
  587. app.state.OPENAI_MODELS = {}
  588. ########################################
  589. #
  590. # TOOL SERVERS
  591. #
  592. ########################################
  593. app.state.config.TOOL_SERVER_CONNECTIONS = TOOL_SERVER_CONNECTIONS
  594. app.state.TOOL_SERVERS = []
  595. ########################################
  596. #
  597. # DIRECT CONNECTIONS
  598. #
  599. ########################################
  600. app.state.config.ENABLE_DIRECT_CONNECTIONS = ENABLE_DIRECT_CONNECTIONS
  601. ########################################
  602. #
  603. # SCIM
  604. #
  605. ########################################
  606. app.state.SCIM_ENABLED = SCIM_ENABLED
  607. app.state.SCIM_TOKEN = SCIM_TOKEN
  608. ########################################
  609. #
  610. # MODELS
  611. #
  612. ########################################
  613. app.state.config.ENABLE_BASE_MODELS_CACHE = ENABLE_BASE_MODELS_CACHE
  614. app.state.BASE_MODELS = []
  615. ########################################
  616. #
  617. # WEBUI
  618. #
  619. ########################################
  620. app.state.config.WEBUI_URL = WEBUI_URL
  621. app.state.config.ENABLE_SIGNUP = ENABLE_SIGNUP
  622. app.state.config.ENABLE_LOGIN_FORM = ENABLE_LOGIN_FORM
  623. app.state.config.ENABLE_API_KEY = ENABLE_API_KEY
  624. app.state.config.ENABLE_API_KEY_ENDPOINT_RESTRICTIONS = (
  625. ENABLE_API_KEY_ENDPOINT_RESTRICTIONS
  626. )
  627. app.state.config.API_KEY_ALLOWED_ENDPOINTS = API_KEY_ALLOWED_ENDPOINTS
  628. app.state.config.JWT_EXPIRES_IN = JWT_EXPIRES_IN
  629. app.state.config.SHOW_ADMIN_DETAILS = SHOW_ADMIN_DETAILS
  630. app.state.config.ADMIN_EMAIL = ADMIN_EMAIL
  631. app.state.config.DEFAULT_MODELS = DEFAULT_MODELS
  632. app.state.config.DEFAULT_PROMPT_SUGGESTIONS = DEFAULT_PROMPT_SUGGESTIONS
  633. app.state.config.DEFAULT_USER_ROLE = DEFAULT_USER_ROLE
  634. app.state.config.PENDING_USER_OVERLAY_CONTENT = PENDING_USER_OVERLAY_CONTENT
  635. app.state.config.PENDING_USER_OVERLAY_TITLE = PENDING_USER_OVERLAY_TITLE
  636. app.state.config.RESPONSE_WATERMARK = RESPONSE_WATERMARK
  637. app.state.config.USER_PERMISSIONS = USER_PERMISSIONS
  638. app.state.config.WEBHOOK_URL = WEBHOOK_URL
  639. app.state.config.BANNERS = WEBUI_BANNERS
  640. app.state.config.MODEL_ORDER_LIST = MODEL_ORDER_LIST
  641. app.state.config.ENABLE_CHANNELS = ENABLE_CHANNELS
  642. app.state.config.ENABLE_NOTES = ENABLE_NOTES
  643. app.state.config.ENABLE_COMMUNITY_SHARING = ENABLE_COMMUNITY_SHARING
  644. app.state.config.ENABLE_MESSAGE_RATING = ENABLE_MESSAGE_RATING
  645. app.state.config.ENABLE_USER_WEBHOOKS = ENABLE_USER_WEBHOOKS
  646. app.state.config.ENABLE_EVALUATION_ARENA_MODELS = ENABLE_EVALUATION_ARENA_MODELS
  647. app.state.config.EVALUATION_ARENA_MODELS = EVALUATION_ARENA_MODELS
  648. app.state.config.OAUTH_USERNAME_CLAIM = OAUTH_USERNAME_CLAIM
  649. app.state.config.OAUTH_PICTURE_CLAIM = OAUTH_PICTURE_CLAIM
  650. app.state.config.OAUTH_EMAIL_CLAIM = OAUTH_EMAIL_CLAIM
  651. app.state.config.ENABLE_OAUTH_ROLE_MANAGEMENT = ENABLE_OAUTH_ROLE_MANAGEMENT
  652. app.state.config.OAUTH_ROLES_CLAIM = OAUTH_ROLES_CLAIM
  653. app.state.config.OAUTH_ALLOWED_ROLES = OAUTH_ALLOWED_ROLES
  654. app.state.config.OAUTH_ADMIN_ROLES = OAUTH_ADMIN_ROLES
  655. app.state.config.ENABLE_LDAP = ENABLE_LDAP
  656. app.state.config.LDAP_SERVER_LABEL = LDAP_SERVER_LABEL
  657. app.state.config.LDAP_SERVER_HOST = LDAP_SERVER_HOST
  658. app.state.config.LDAP_SERVER_PORT = LDAP_SERVER_PORT
  659. app.state.config.LDAP_ATTRIBUTE_FOR_MAIL = LDAP_ATTRIBUTE_FOR_MAIL
  660. app.state.config.LDAP_ATTRIBUTE_FOR_USERNAME = LDAP_ATTRIBUTE_FOR_USERNAME
  661. app.state.config.LDAP_APP_DN = LDAP_APP_DN
  662. app.state.config.LDAP_APP_PASSWORD = LDAP_APP_PASSWORD
  663. app.state.config.LDAP_SEARCH_BASE = LDAP_SEARCH_BASE
  664. app.state.config.LDAP_SEARCH_FILTERS = LDAP_SEARCH_FILTERS
  665. app.state.config.LDAP_USE_TLS = LDAP_USE_TLS
  666. app.state.config.LDAP_CA_CERT_FILE = LDAP_CA_CERT_FILE
  667. app.state.config.LDAP_VALIDATE_CERT = LDAP_VALIDATE_CERT
  668. app.state.config.LDAP_CIPHERS = LDAP_CIPHERS
  669. # For LDAP Group Management
  670. app.state.config.ENABLE_LDAP_GROUP_MANAGEMENT = ENABLE_LDAP_GROUP_MANAGEMENT
  671. app.state.config.ENABLE_LDAP_GROUP_CREATION = ENABLE_LDAP_GROUP_CREATION
  672. app.state.config.LDAP_ATTRIBUTE_FOR_GROUPS = LDAP_ATTRIBUTE_FOR_GROUPS
  673. app.state.AUTH_TRUSTED_EMAIL_HEADER = WEBUI_AUTH_TRUSTED_EMAIL_HEADER
  674. app.state.AUTH_TRUSTED_NAME_HEADER = WEBUI_AUTH_TRUSTED_NAME_HEADER
  675. app.state.WEBUI_AUTH_SIGNOUT_REDIRECT_URL = WEBUI_AUTH_SIGNOUT_REDIRECT_URL
  676. app.state.EXTERNAL_PWA_MANIFEST_URL = EXTERNAL_PWA_MANIFEST_URL
  677. app.state.USER_COUNT = None
  678. app.state.TOOLS = {}
  679. app.state.TOOL_CONTENTS = {}
  680. app.state.FUNCTIONS = {}
  681. app.state.FUNCTION_CONTENTS = {}
  682. ########################################
  683. #
  684. # RETRIEVAL
  685. #
  686. ########################################
  687. app.state.config.TOP_K = RAG_TOP_K
  688. app.state.config.TOP_K_RERANKER = RAG_TOP_K_RERANKER
  689. app.state.config.RELEVANCE_THRESHOLD = RAG_RELEVANCE_THRESHOLD
  690. app.state.config.HYBRID_BM25_WEIGHT = RAG_HYBRID_BM25_WEIGHT
  691. app.state.config.ALLOWED_FILE_EXTENSIONS = RAG_ALLOWED_FILE_EXTENSIONS
  692. app.state.config.FILE_MAX_SIZE = RAG_FILE_MAX_SIZE
  693. app.state.config.FILE_MAX_COUNT = RAG_FILE_MAX_COUNT
  694. app.state.config.FILE_IMAGE_COMPRESSION_WIDTH = FILE_IMAGE_COMPRESSION_WIDTH
  695. app.state.config.FILE_IMAGE_COMPRESSION_HEIGHT = FILE_IMAGE_COMPRESSION_HEIGHT
  696. app.state.config.RAG_FULL_CONTEXT = RAG_FULL_CONTEXT
  697. app.state.config.BYPASS_EMBEDDING_AND_RETRIEVAL = BYPASS_EMBEDDING_AND_RETRIEVAL
  698. app.state.config.ENABLE_RAG_HYBRID_SEARCH = ENABLE_RAG_HYBRID_SEARCH
  699. app.state.config.ENABLE_WEB_LOADER_SSL_VERIFICATION = ENABLE_WEB_LOADER_SSL_VERIFICATION
  700. app.state.config.CONTENT_EXTRACTION_ENGINE = CONTENT_EXTRACTION_ENGINE
  701. app.state.config.DATALAB_MARKER_API_KEY = DATALAB_MARKER_API_KEY
  702. app.state.config.DATALAB_MARKER_API_BASE_URL = DATALAB_MARKER_API_BASE_URL
  703. app.state.config.DATALAB_MARKER_ADDITIONAL_CONFIG = DATALAB_MARKER_ADDITIONAL_CONFIG
  704. app.state.config.DATALAB_MARKER_SKIP_CACHE = DATALAB_MARKER_SKIP_CACHE
  705. app.state.config.DATALAB_MARKER_FORCE_OCR = DATALAB_MARKER_FORCE_OCR
  706. app.state.config.DATALAB_MARKER_PAGINATE = DATALAB_MARKER_PAGINATE
  707. app.state.config.DATALAB_MARKER_STRIP_EXISTING_OCR = DATALAB_MARKER_STRIP_EXISTING_OCR
  708. app.state.config.DATALAB_MARKER_DISABLE_IMAGE_EXTRACTION = (
  709. DATALAB_MARKER_DISABLE_IMAGE_EXTRACTION
  710. )
  711. app.state.config.DATALAB_MARKER_FORMAT_LINES = DATALAB_MARKER_FORMAT_LINES
  712. app.state.config.DATALAB_MARKER_USE_LLM = DATALAB_MARKER_USE_LLM
  713. app.state.config.DATALAB_MARKER_OUTPUT_FORMAT = DATALAB_MARKER_OUTPUT_FORMAT
  714. app.state.config.EXTERNAL_DOCUMENT_LOADER_URL = EXTERNAL_DOCUMENT_LOADER_URL
  715. app.state.config.EXTERNAL_DOCUMENT_LOADER_API_KEY = EXTERNAL_DOCUMENT_LOADER_API_KEY
  716. app.state.config.TIKA_SERVER_URL = TIKA_SERVER_URL
  717. app.state.config.DOCLING_SERVER_URL = DOCLING_SERVER_URL
  718. app.state.config.DOCLING_OCR_ENGINE = DOCLING_OCR_ENGINE
  719. app.state.config.DOCLING_OCR_LANG = DOCLING_OCR_LANG
  720. app.state.config.DOCLING_DO_PICTURE_DESCRIPTION = DOCLING_DO_PICTURE_DESCRIPTION
  721. app.state.config.DOCLING_PICTURE_DESCRIPTION_MODE = DOCLING_PICTURE_DESCRIPTION_MODE
  722. app.state.config.DOCLING_PICTURE_DESCRIPTION_LOCAL = DOCLING_PICTURE_DESCRIPTION_LOCAL
  723. app.state.config.DOCLING_PICTURE_DESCRIPTION_API = DOCLING_PICTURE_DESCRIPTION_API
  724. app.state.config.DOCUMENT_INTELLIGENCE_ENDPOINT = DOCUMENT_INTELLIGENCE_ENDPOINT
  725. app.state.config.DOCUMENT_INTELLIGENCE_KEY = DOCUMENT_INTELLIGENCE_KEY
  726. app.state.config.MISTRAL_OCR_API_KEY = MISTRAL_OCR_API_KEY
  727. app.state.config.TEXT_SPLITTER = RAG_TEXT_SPLITTER
  728. app.state.config.TIKTOKEN_ENCODING_NAME = TIKTOKEN_ENCODING_NAME
  729. app.state.config.CHUNK_SIZE = CHUNK_SIZE
  730. app.state.config.CHUNK_OVERLAP = CHUNK_OVERLAP
  731. app.state.config.RAG_EMBEDDING_ENGINE = RAG_EMBEDDING_ENGINE
  732. app.state.config.RAG_EMBEDDING_MODEL = RAG_EMBEDDING_MODEL
  733. app.state.config.RAG_EMBEDDING_BATCH_SIZE = RAG_EMBEDDING_BATCH_SIZE
  734. app.state.config.RAG_RERANKING_ENGINE = RAG_RERANKING_ENGINE
  735. app.state.config.RAG_RERANKING_MODEL = RAG_RERANKING_MODEL
  736. app.state.config.RAG_EXTERNAL_RERANKER_URL = RAG_EXTERNAL_RERANKER_URL
  737. app.state.config.RAG_EXTERNAL_RERANKER_API_KEY = RAG_EXTERNAL_RERANKER_API_KEY
  738. app.state.config.RAG_TEMPLATE = RAG_TEMPLATE
  739. app.state.config.RAG_OPENAI_API_BASE_URL = RAG_OPENAI_API_BASE_URL
  740. app.state.config.RAG_OPENAI_API_KEY = RAG_OPENAI_API_KEY
  741. app.state.config.RAG_AZURE_OPENAI_BASE_URL = RAG_AZURE_OPENAI_BASE_URL
  742. app.state.config.RAG_AZURE_OPENAI_API_KEY = RAG_AZURE_OPENAI_API_KEY
  743. app.state.config.RAG_AZURE_OPENAI_API_VERSION = RAG_AZURE_OPENAI_API_VERSION
  744. app.state.config.RAG_OLLAMA_BASE_URL = RAG_OLLAMA_BASE_URL
  745. app.state.config.RAG_OLLAMA_API_KEY = RAG_OLLAMA_API_KEY
  746. app.state.config.PDF_EXTRACT_IMAGES = PDF_EXTRACT_IMAGES
  747. app.state.config.YOUTUBE_LOADER_LANGUAGE = YOUTUBE_LOADER_LANGUAGE
  748. app.state.config.YOUTUBE_LOADER_PROXY_URL = YOUTUBE_LOADER_PROXY_URL
  749. app.state.config.ENABLE_WEB_SEARCH = ENABLE_WEB_SEARCH
  750. app.state.config.WEB_SEARCH_ENGINE = WEB_SEARCH_ENGINE
  751. app.state.config.WEB_SEARCH_DOMAIN_FILTER_LIST = WEB_SEARCH_DOMAIN_FILTER_LIST
  752. app.state.config.WEB_SEARCH_RESULT_COUNT = WEB_SEARCH_RESULT_COUNT
  753. app.state.config.WEB_SEARCH_CONCURRENT_REQUESTS = WEB_SEARCH_CONCURRENT_REQUESTS
  754. app.state.config.WEB_LOADER_ENGINE = WEB_LOADER_ENGINE
  755. app.state.config.WEB_LOADER_CONCURRENT_REQUESTS = WEB_LOADER_CONCURRENT_REQUESTS
  756. app.state.config.WEB_SEARCH_TRUST_ENV = WEB_SEARCH_TRUST_ENV
  757. app.state.config.BYPASS_WEB_SEARCH_EMBEDDING_AND_RETRIEVAL = (
  758. BYPASS_WEB_SEARCH_EMBEDDING_AND_RETRIEVAL
  759. )
  760. app.state.config.BYPASS_WEB_SEARCH_WEB_LOADER = BYPASS_WEB_SEARCH_WEB_LOADER
  761. app.state.config.ENABLE_GOOGLE_DRIVE_INTEGRATION = ENABLE_GOOGLE_DRIVE_INTEGRATION
  762. app.state.config.ENABLE_ONEDRIVE_INTEGRATION = ENABLE_ONEDRIVE_INTEGRATION
  763. app.state.config.SEARXNG_QUERY_URL = SEARXNG_QUERY_URL
  764. app.state.config.YACY_QUERY_URL = YACY_QUERY_URL
  765. app.state.config.YACY_USERNAME = YACY_USERNAME
  766. app.state.config.YACY_PASSWORD = YACY_PASSWORD
  767. app.state.config.GOOGLE_PSE_API_KEY = GOOGLE_PSE_API_KEY
  768. app.state.config.GOOGLE_PSE_ENGINE_ID = GOOGLE_PSE_ENGINE_ID
  769. app.state.config.BRAVE_SEARCH_API_KEY = BRAVE_SEARCH_API_KEY
  770. app.state.config.KAGI_SEARCH_API_KEY = KAGI_SEARCH_API_KEY
  771. app.state.config.MOJEEK_SEARCH_API_KEY = MOJEEK_SEARCH_API_KEY
  772. app.state.config.BOCHA_SEARCH_API_KEY = BOCHA_SEARCH_API_KEY
  773. app.state.config.SERPSTACK_API_KEY = SERPSTACK_API_KEY
  774. app.state.config.SERPSTACK_HTTPS = SERPSTACK_HTTPS
  775. app.state.config.SERPER_API_KEY = SERPER_API_KEY
  776. app.state.config.SERPLY_API_KEY = SERPLY_API_KEY
  777. app.state.config.TAVILY_API_KEY = TAVILY_API_KEY
  778. app.state.config.SEARCHAPI_API_KEY = SEARCHAPI_API_KEY
  779. app.state.config.SEARCHAPI_ENGINE = SEARCHAPI_ENGINE
  780. app.state.config.SERPAPI_API_KEY = SERPAPI_API_KEY
  781. app.state.config.SERPAPI_ENGINE = SERPAPI_ENGINE
  782. app.state.config.JINA_API_KEY = JINA_API_KEY
  783. app.state.config.BING_SEARCH_V7_ENDPOINT = BING_SEARCH_V7_ENDPOINT
  784. app.state.config.BING_SEARCH_V7_SUBSCRIPTION_KEY = BING_SEARCH_V7_SUBSCRIPTION_KEY
  785. app.state.config.EXA_API_KEY = EXA_API_KEY
  786. app.state.config.PERPLEXITY_API_KEY = PERPLEXITY_API_KEY
  787. app.state.config.PERPLEXITY_MODEL = PERPLEXITY_MODEL
  788. app.state.config.PERPLEXITY_SEARCH_CONTEXT_USAGE = PERPLEXITY_SEARCH_CONTEXT_USAGE
  789. app.state.config.SOUGOU_API_SID = SOUGOU_API_SID
  790. app.state.config.SOUGOU_API_SK = SOUGOU_API_SK
  791. app.state.config.EXTERNAL_WEB_SEARCH_URL = EXTERNAL_WEB_SEARCH_URL
  792. app.state.config.EXTERNAL_WEB_SEARCH_API_KEY = EXTERNAL_WEB_SEARCH_API_KEY
  793. app.state.config.EXTERNAL_WEB_LOADER_URL = EXTERNAL_WEB_LOADER_URL
  794. app.state.config.EXTERNAL_WEB_LOADER_API_KEY = EXTERNAL_WEB_LOADER_API_KEY
  795. app.state.config.PLAYWRIGHT_WS_URL = PLAYWRIGHT_WS_URL
  796. app.state.config.PLAYWRIGHT_TIMEOUT = PLAYWRIGHT_TIMEOUT
  797. app.state.config.FIRECRAWL_API_BASE_URL = FIRECRAWL_API_BASE_URL
  798. app.state.config.FIRECRAWL_API_KEY = FIRECRAWL_API_KEY
  799. app.state.config.TAVILY_EXTRACT_DEPTH = TAVILY_EXTRACT_DEPTH
  800. app.state.EMBEDDING_FUNCTION = None
  801. app.state.RERANKING_FUNCTION = None
  802. app.state.ef = None
  803. app.state.rf = None
  804. app.state.YOUTUBE_LOADER_TRANSLATION = None
  805. try:
  806. app.state.ef = get_ef(
  807. app.state.config.RAG_EMBEDDING_ENGINE,
  808. app.state.config.RAG_EMBEDDING_MODEL,
  809. RAG_EMBEDDING_MODEL_AUTO_UPDATE,
  810. )
  811. if (
  812. app.state.config.ENABLE_RAG_HYBRID_SEARCH
  813. and not app.state.config.BYPASS_EMBEDDING_AND_RETRIEVAL
  814. ):
  815. app.state.rf = get_rf(
  816. app.state.config.RAG_RERANKING_ENGINE,
  817. app.state.config.RAG_RERANKING_MODEL,
  818. app.state.config.RAG_EXTERNAL_RERANKER_URL,
  819. app.state.config.RAG_EXTERNAL_RERANKER_API_KEY,
  820. RAG_RERANKING_MODEL_AUTO_UPDATE,
  821. )
  822. else:
  823. app.state.rf = None
  824. except Exception as e:
  825. log.error(f"Error updating models: {e}")
  826. pass
  827. app.state.EMBEDDING_FUNCTION = get_embedding_function(
  828. app.state.config.RAG_EMBEDDING_ENGINE,
  829. app.state.config.RAG_EMBEDDING_MODEL,
  830. embedding_function=app.state.ef,
  831. url=(
  832. app.state.config.RAG_OPENAI_API_BASE_URL
  833. if app.state.config.RAG_EMBEDDING_ENGINE == "openai"
  834. else (
  835. app.state.config.RAG_OLLAMA_BASE_URL
  836. if app.state.config.RAG_EMBEDDING_ENGINE == "ollama"
  837. else app.state.config.RAG_AZURE_OPENAI_BASE_URL
  838. )
  839. ),
  840. key=(
  841. app.state.config.RAG_OPENAI_API_KEY
  842. if app.state.config.RAG_EMBEDDING_ENGINE == "openai"
  843. else (
  844. app.state.config.RAG_OLLAMA_API_KEY
  845. if app.state.config.RAG_EMBEDDING_ENGINE == "ollama"
  846. else app.state.config.RAG_AZURE_OPENAI_API_KEY
  847. )
  848. ),
  849. embedding_batch_size=app.state.config.RAG_EMBEDDING_BATCH_SIZE,
  850. azure_api_version=(
  851. app.state.config.RAG_AZURE_OPENAI_API_VERSION
  852. if app.state.config.RAG_EMBEDDING_ENGINE == "azure_openai"
  853. else None
  854. ),
  855. )
  856. app.state.RERANKING_FUNCTION = get_reranking_function(
  857. app.state.config.RAG_RERANKING_ENGINE,
  858. app.state.config.RAG_RERANKING_MODEL,
  859. reranking_function=app.state.rf,
  860. )
  861. ########################################
  862. #
  863. # CODE EXECUTION
  864. #
  865. ########################################
  866. app.state.config.ENABLE_CODE_EXECUTION = ENABLE_CODE_EXECUTION
  867. app.state.config.CODE_EXECUTION_ENGINE = CODE_EXECUTION_ENGINE
  868. app.state.config.CODE_EXECUTION_JUPYTER_URL = CODE_EXECUTION_JUPYTER_URL
  869. app.state.config.CODE_EXECUTION_JUPYTER_AUTH = CODE_EXECUTION_JUPYTER_AUTH
  870. app.state.config.CODE_EXECUTION_JUPYTER_AUTH_TOKEN = CODE_EXECUTION_JUPYTER_AUTH_TOKEN
  871. app.state.config.CODE_EXECUTION_JUPYTER_AUTH_PASSWORD = (
  872. CODE_EXECUTION_JUPYTER_AUTH_PASSWORD
  873. )
  874. app.state.config.CODE_EXECUTION_JUPYTER_TIMEOUT = CODE_EXECUTION_JUPYTER_TIMEOUT
  875. app.state.config.ENABLE_CODE_INTERPRETER = ENABLE_CODE_INTERPRETER
  876. app.state.config.CODE_INTERPRETER_ENGINE = CODE_INTERPRETER_ENGINE
  877. app.state.config.CODE_INTERPRETER_PROMPT_TEMPLATE = CODE_INTERPRETER_PROMPT_TEMPLATE
  878. app.state.config.CODE_INTERPRETER_JUPYTER_URL = CODE_INTERPRETER_JUPYTER_URL
  879. app.state.config.CODE_INTERPRETER_JUPYTER_AUTH = CODE_INTERPRETER_JUPYTER_AUTH
  880. app.state.config.CODE_INTERPRETER_JUPYTER_AUTH_TOKEN = (
  881. CODE_INTERPRETER_JUPYTER_AUTH_TOKEN
  882. )
  883. app.state.config.CODE_INTERPRETER_JUPYTER_AUTH_PASSWORD = (
  884. CODE_INTERPRETER_JUPYTER_AUTH_PASSWORD
  885. )
  886. app.state.config.CODE_INTERPRETER_JUPYTER_TIMEOUT = CODE_INTERPRETER_JUPYTER_TIMEOUT
  887. ########################################
  888. #
  889. # IMAGES
  890. #
  891. ########################################
  892. app.state.config.IMAGE_GENERATION_ENGINE = IMAGE_GENERATION_ENGINE
  893. app.state.config.ENABLE_IMAGE_GENERATION = ENABLE_IMAGE_GENERATION
  894. app.state.config.ENABLE_IMAGE_PROMPT_GENERATION = ENABLE_IMAGE_PROMPT_GENERATION
  895. app.state.config.IMAGES_OPENAI_API_BASE_URL = IMAGES_OPENAI_API_BASE_URL
  896. app.state.config.IMAGES_OPENAI_API_VERSION = IMAGES_OPENAI_API_VERSION
  897. app.state.config.IMAGES_OPENAI_API_KEY = IMAGES_OPENAI_API_KEY
  898. app.state.config.IMAGES_GEMINI_API_BASE_URL = IMAGES_GEMINI_API_BASE_URL
  899. app.state.config.IMAGES_GEMINI_API_KEY = IMAGES_GEMINI_API_KEY
  900. app.state.config.IMAGE_GENERATION_MODEL = IMAGE_GENERATION_MODEL
  901. app.state.config.AUTOMATIC1111_BASE_URL = AUTOMATIC1111_BASE_URL
  902. app.state.config.AUTOMATIC1111_API_AUTH = AUTOMATIC1111_API_AUTH
  903. app.state.config.AUTOMATIC1111_CFG_SCALE = AUTOMATIC1111_CFG_SCALE
  904. app.state.config.AUTOMATIC1111_SAMPLER = AUTOMATIC1111_SAMPLER
  905. app.state.config.AUTOMATIC1111_SCHEDULER = AUTOMATIC1111_SCHEDULER
  906. app.state.config.COMFYUI_BASE_URL = COMFYUI_BASE_URL
  907. app.state.config.COMFYUI_API_KEY = COMFYUI_API_KEY
  908. app.state.config.COMFYUI_WORKFLOW = COMFYUI_WORKFLOW
  909. app.state.config.COMFYUI_WORKFLOW_NODES = COMFYUI_WORKFLOW_NODES
  910. app.state.config.IMAGE_SIZE = IMAGE_SIZE
  911. app.state.config.IMAGE_STEPS = IMAGE_STEPS
  912. ########################################
  913. #
  914. # AUDIO
  915. #
  916. ########################################
  917. app.state.config.STT_ENGINE = AUDIO_STT_ENGINE
  918. app.state.config.STT_MODEL = AUDIO_STT_MODEL
  919. app.state.config.STT_SUPPORTED_CONTENT_TYPES = AUDIO_STT_SUPPORTED_CONTENT_TYPES
  920. app.state.config.STT_OPENAI_API_BASE_URL = AUDIO_STT_OPENAI_API_BASE_URL
  921. app.state.config.STT_OPENAI_API_KEY = AUDIO_STT_OPENAI_API_KEY
  922. app.state.config.WHISPER_MODEL = WHISPER_MODEL
  923. app.state.config.WHISPER_VAD_FILTER = WHISPER_VAD_FILTER
  924. app.state.config.DEEPGRAM_API_KEY = DEEPGRAM_API_KEY
  925. app.state.config.AUDIO_STT_AZURE_API_KEY = AUDIO_STT_AZURE_API_KEY
  926. app.state.config.AUDIO_STT_AZURE_REGION = AUDIO_STT_AZURE_REGION
  927. app.state.config.AUDIO_STT_AZURE_LOCALES = AUDIO_STT_AZURE_LOCALES
  928. app.state.config.AUDIO_STT_AZURE_BASE_URL = AUDIO_STT_AZURE_BASE_URL
  929. app.state.config.AUDIO_STT_AZURE_MAX_SPEAKERS = AUDIO_STT_AZURE_MAX_SPEAKERS
  930. app.state.config.TTS_OPENAI_API_BASE_URL = AUDIO_TTS_OPENAI_API_BASE_URL
  931. app.state.config.TTS_OPENAI_API_KEY = AUDIO_TTS_OPENAI_API_KEY
  932. app.state.config.TTS_ENGINE = AUDIO_TTS_ENGINE
  933. app.state.config.TTS_MODEL = AUDIO_TTS_MODEL
  934. app.state.config.TTS_VOICE = AUDIO_TTS_VOICE
  935. app.state.config.TTS_API_KEY = AUDIO_TTS_API_KEY
  936. app.state.config.TTS_SPLIT_ON = AUDIO_TTS_SPLIT_ON
  937. app.state.config.TTS_AZURE_SPEECH_REGION = AUDIO_TTS_AZURE_SPEECH_REGION
  938. app.state.config.TTS_AZURE_SPEECH_BASE_URL = AUDIO_TTS_AZURE_SPEECH_BASE_URL
  939. app.state.config.TTS_AZURE_SPEECH_OUTPUT_FORMAT = AUDIO_TTS_AZURE_SPEECH_OUTPUT_FORMAT
  940. app.state.faster_whisper_model = None
  941. app.state.speech_synthesiser = None
  942. app.state.speech_speaker_embeddings_dataset = None
  943. ########################################
  944. #
  945. # TASKS
  946. #
  947. ########################################
  948. app.state.config.TASK_MODEL = TASK_MODEL
  949. app.state.config.TASK_MODEL_EXTERNAL = TASK_MODEL_EXTERNAL
  950. app.state.config.ENABLE_SEARCH_QUERY_GENERATION = ENABLE_SEARCH_QUERY_GENERATION
  951. app.state.config.ENABLE_RETRIEVAL_QUERY_GENERATION = ENABLE_RETRIEVAL_QUERY_GENERATION
  952. app.state.config.ENABLE_AUTOCOMPLETE_GENERATION = ENABLE_AUTOCOMPLETE_GENERATION
  953. app.state.config.ENABLE_TAGS_GENERATION = ENABLE_TAGS_GENERATION
  954. app.state.config.ENABLE_TITLE_GENERATION = ENABLE_TITLE_GENERATION
  955. app.state.config.ENABLE_FOLLOW_UP_GENERATION = ENABLE_FOLLOW_UP_GENERATION
  956. app.state.config.TITLE_GENERATION_PROMPT_TEMPLATE = TITLE_GENERATION_PROMPT_TEMPLATE
  957. app.state.config.TAGS_GENERATION_PROMPT_TEMPLATE = TAGS_GENERATION_PROMPT_TEMPLATE
  958. app.state.config.IMAGE_PROMPT_GENERATION_PROMPT_TEMPLATE = (
  959. IMAGE_PROMPT_GENERATION_PROMPT_TEMPLATE
  960. )
  961. app.state.config.FOLLOW_UP_GENERATION_PROMPT_TEMPLATE = (
  962. FOLLOW_UP_GENERATION_PROMPT_TEMPLATE
  963. )
  964. app.state.config.TOOLS_FUNCTION_CALLING_PROMPT_TEMPLATE = (
  965. TOOLS_FUNCTION_CALLING_PROMPT_TEMPLATE
  966. )
  967. app.state.config.QUERY_GENERATION_PROMPT_TEMPLATE = QUERY_GENERATION_PROMPT_TEMPLATE
  968. app.state.config.AUTOCOMPLETE_GENERATION_PROMPT_TEMPLATE = (
  969. AUTOCOMPLETE_GENERATION_PROMPT_TEMPLATE
  970. )
  971. app.state.config.AUTOCOMPLETE_GENERATION_INPUT_MAX_LENGTH = (
  972. AUTOCOMPLETE_GENERATION_INPUT_MAX_LENGTH
  973. )
  974. ########################################
  975. #
  976. # WEBUI
  977. #
  978. ########################################
  979. app.state.MODELS = {}
  980. class RedirectMiddleware(BaseHTTPMiddleware):
  981. async def dispatch(self, request: Request, call_next):
  982. # Check if the request is a GET request
  983. if request.method == "GET":
  984. path = request.url.path
  985. query_params = dict(parse_qs(urlparse(str(request.url)).query))
  986. # Check for the specific watch path and the presence of 'v' parameter
  987. if path.endswith("/watch") and "v" in query_params:
  988. # Extract the first 'v' parameter
  989. video_id = query_params["v"][0]
  990. encoded_video_id = urlencode({"youtube": video_id})
  991. redirect_url = f"/?{encoded_video_id}"
  992. return RedirectResponse(url=redirect_url)
  993. # Proceed with the normal flow of other requests
  994. response = await call_next(request)
  995. return response
  996. # Add the middleware to the app
  997. if ENABLE_COMPRESSION_MIDDLEWARE:
  998. app.add_middleware(CompressMiddleware)
  999. app.add_middleware(RedirectMiddleware)
  1000. app.add_middleware(SecurityHeadersMiddleware)
  1001. @app.middleware("http")
  1002. async def commit_session_after_request(request: Request, call_next):
  1003. response = await call_next(request)
  1004. # log.debug("Commit session after request")
  1005. Session.commit()
  1006. return response
  1007. @app.middleware("http")
  1008. async def check_url(request: Request, call_next):
  1009. start_time = int(time.time())
  1010. request.state.token = get_http_authorization_cred(
  1011. request.headers.get("Authorization")
  1012. )
  1013. request.state.enable_api_key = app.state.config.ENABLE_API_KEY
  1014. response = await call_next(request)
  1015. process_time = int(time.time()) - start_time
  1016. response.headers["X-Process-Time"] = str(process_time)
  1017. return response
  1018. @app.middleware("http")
  1019. async def inspect_websocket(request: Request, call_next):
  1020. if (
  1021. "/ws/socket.io" in request.url.path
  1022. and request.query_params.get("transport") == "websocket"
  1023. ):
  1024. upgrade = (request.headers.get("Upgrade") or "").lower()
  1025. connection = (request.headers.get("Connection") or "").lower().split(",")
  1026. # Check that there's the correct headers for an upgrade, else reject the connection
  1027. # This is to work around this upstream issue: https://github.com/miguelgrinberg/python-engineio/issues/367
  1028. if upgrade != "websocket" or "upgrade" not in connection:
  1029. return JSONResponse(
  1030. status_code=status.HTTP_400_BAD_REQUEST,
  1031. content={"detail": "Invalid WebSocket upgrade request"},
  1032. )
  1033. return await call_next(request)
  1034. app.add_middleware(
  1035. CORSMiddleware,
  1036. allow_origins=CORS_ALLOW_ORIGIN,
  1037. allow_credentials=True,
  1038. allow_methods=["*"],
  1039. allow_headers=["*"],
  1040. )
  1041. app.mount("/ws", socket_app)
  1042. app.include_router(ollama.router, prefix="/ollama", tags=["ollama"])
  1043. app.include_router(openai.router, prefix="/openai", tags=["openai"])
  1044. app.include_router(pipelines.router, prefix="/api/v1/pipelines", tags=["pipelines"])
  1045. app.include_router(tasks.router, prefix="/api/v1/tasks", tags=["tasks"])
  1046. app.include_router(images.router, prefix="/api/v1/images", tags=["images"])
  1047. app.include_router(audio.router, prefix="/api/v1/audio", tags=["audio"])
  1048. app.include_router(retrieval.router, prefix="/api/v1/retrieval", tags=["retrieval"])
  1049. app.include_router(configs.router, prefix="/api/v1/configs", tags=["configs"])
  1050. app.include_router(auths.router, prefix="/api/v1/auths", tags=["auths"])
  1051. app.include_router(users.router, prefix="/api/v1/users", tags=["users"])
  1052. app.include_router(channels.router, prefix="/api/v1/channels", tags=["channels"])
  1053. app.include_router(chats.router, prefix="/api/v1/chats", tags=["chats"])
  1054. app.include_router(notes.router, prefix="/api/v1/notes", tags=["notes"])
  1055. app.include_router(models.router, prefix="/api/v1/models", tags=["models"])
  1056. app.include_router(knowledge.router, prefix="/api/v1/knowledge", tags=["knowledge"])
  1057. app.include_router(prompts.router, prefix="/api/v1/prompts", tags=["prompts"])
  1058. app.include_router(tools.router, prefix="/api/v1/tools", tags=["tools"])
  1059. app.include_router(memories.router, prefix="/api/v1/memories", tags=["memories"])
  1060. app.include_router(folders.router, prefix="/api/v1/folders", tags=["folders"])
  1061. app.include_router(groups.router, prefix="/api/v1/groups", tags=["groups"])
  1062. app.include_router(files.router, prefix="/api/v1/files", tags=["files"])
  1063. app.include_router(functions.router, prefix="/api/v1/functions", tags=["functions"])
  1064. app.include_router(
  1065. evaluations.router, prefix="/api/v1/evaluations", tags=["evaluations"]
  1066. )
  1067. app.include_router(utils.router, prefix="/api/v1/utils", tags=["utils"])
  1068. # SCIM 2.0 API for identity management
  1069. if SCIM_ENABLED:
  1070. app.include_router(scim.router, prefix="/api/v1/scim/v2", tags=["scim"])
  1071. try:
  1072. audit_level = AuditLevel(AUDIT_LOG_LEVEL)
  1073. except ValueError as e:
  1074. logger.error(f"Invalid audit level: {AUDIT_LOG_LEVEL}. Error: {e}")
  1075. audit_level = AuditLevel.NONE
  1076. if audit_level != AuditLevel.NONE:
  1077. app.add_middleware(
  1078. AuditLoggingMiddleware,
  1079. audit_level=audit_level,
  1080. excluded_paths=AUDIT_EXCLUDED_PATHS,
  1081. max_body_size=MAX_BODY_LOG_SIZE,
  1082. )
  1083. ##################################
  1084. #
  1085. # Chat Endpoints
  1086. #
  1087. ##################################
  1088. @app.get("/api/models")
  1089. @app.get("/api/v1/models") # Experimental: Compatibility with OpenAI API
  1090. async def get_models(
  1091. request: Request, refresh: bool = False, user=Depends(get_verified_user)
  1092. ):
  1093. def get_filtered_models(models, user):
  1094. filtered_models = []
  1095. for model in models:
  1096. if model.get("arena"):
  1097. if has_access(
  1098. user.id,
  1099. type="read",
  1100. access_control=model.get("info", {})
  1101. .get("meta", {})
  1102. .get("access_control", {}),
  1103. ):
  1104. filtered_models.append(model)
  1105. continue
  1106. model_info = Models.get_model_by_id(model["id"])
  1107. if model_info:
  1108. if (
  1109. (user.role == "admin" and BYPASS_ADMIN_ACCESS_CONTROL)
  1110. or user.id == model_info.user_id
  1111. or has_access(
  1112. user.id, type="read", access_control=model_info.access_control
  1113. )
  1114. ):
  1115. filtered_models.append(model)
  1116. return filtered_models
  1117. all_models = await get_all_models(request, refresh=refresh, user=user)
  1118. models = []
  1119. for model in all_models:
  1120. # Filter out filter pipelines
  1121. if "pipeline" in model and model["pipeline"].get("type", None) == "filter":
  1122. continue
  1123. try:
  1124. model_tags = [
  1125. tag.get("name")
  1126. for tag in model.get("info", {}).get("meta", {}).get("tags", [])
  1127. ]
  1128. tags = [tag.get("name") for tag in model.get("tags", [])]
  1129. tags = list(set(model_tags + tags))
  1130. model["tags"] = [{"name": tag} for tag in tags]
  1131. except Exception as e:
  1132. log.debug(f"Error processing model tags: {e}")
  1133. model["tags"] = []
  1134. pass
  1135. models.append(model)
  1136. model_order_list = request.app.state.config.MODEL_ORDER_LIST
  1137. if model_order_list:
  1138. model_order_dict = {model_id: i for i, model_id in enumerate(model_order_list)}
  1139. # Sort models by order list priority, with fallback for those not in the list
  1140. models.sort(
  1141. key=lambda model: (
  1142. model_order_dict.get(model.get("id", ""), float("inf")),
  1143. (model.get("name", "") or ""),
  1144. )
  1145. )
  1146. # Filter out models that the user does not have access to
  1147. if (
  1148. user.role == "user"
  1149. or (user.role == "admin" and not BYPASS_ADMIN_ACCESS_CONTROL)
  1150. ) and not BYPASS_MODEL_ACCESS_CONTROL:
  1151. models = get_filtered_models(models, user)
  1152. log.debug(
  1153. f"/api/models returned filtered models accessible to the user: {json.dumps([model.get('id') for model in models])}"
  1154. )
  1155. return {"data": models}
  1156. @app.get("/api/models/base")
  1157. async def get_base_models(request: Request, user=Depends(get_admin_user)):
  1158. models = await get_all_base_models(request, user=user)
  1159. return {"data": models}
  1160. ##################################
  1161. # Embeddings
  1162. ##################################
  1163. @app.post("/api/embeddings")
  1164. @app.post("/api/v1/embeddings") # Experimental: Compatibility with OpenAI API
  1165. async def embeddings(
  1166. request: Request, form_data: dict, user=Depends(get_verified_user)
  1167. ):
  1168. """
  1169. OpenAI-compatible embeddings endpoint.
  1170. This handler:
  1171. - Performs user/model checks and dispatches to the correct backend.
  1172. - Supports OpenAI, Ollama, arena models, pipelines, and any compatible provider.
  1173. Args:
  1174. request (Request): Request context.
  1175. form_data (dict): OpenAI-like payload (e.g., {"model": "...", "input": [...]})
  1176. user (UserModel): Authenticated user.
  1177. Returns:
  1178. dict: OpenAI-compatible embeddings response.
  1179. """
  1180. # Make sure models are loaded in app state
  1181. if not request.app.state.MODELS:
  1182. await get_all_models(request, user=user)
  1183. # Use generic dispatcher in utils.embeddings
  1184. return await generate_embeddings(request, form_data, user)
  1185. @app.post("/api/chat/completions")
  1186. @app.post("/api/v1/chat/completions") # Experimental: Compatibility with OpenAI API
  1187. async def chat_completion(
  1188. request: Request,
  1189. form_data: dict,
  1190. user=Depends(get_verified_user),
  1191. ):
  1192. if not request.app.state.MODELS:
  1193. await get_all_models(request, user=user)
  1194. model_id = form_data.get("model", None)
  1195. model_item = form_data.pop("model_item", {})
  1196. tasks = form_data.pop("background_tasks", None)
  1197. oauth_token = None
  1198. try:
  1199. oauth_token = request.app.state.oauth_manager.get_oauth_token(
  1200. user.id, request.cookies.get("oauth_session_id", None)
  1201. )
  1202. except Exception as e:
  1203. log.error(f"Error getting OAuth token: {e}")
  1204. metadata = {}
  1205. try:
  1206. if not model_item.get("direct", False):
  1207. if model_id not in request.app.state.MODELS:
  1208. raise Exception("Model not found")
  1209. model = request.app.state.MODELS[model_id]
  1210. model_info = Models.get_model_by_id(model_id)
  1211. # Check if user has access to the model
  1212. if not BYPASS_MODEL_ACCESS_CONTROL and (
  1213. user.role != "admin" or not BYPASS_ADMIN_ACCESS_CONTROL
  1214. ):
  1215. try:
  1216. check_model_access(user, model)
  1217. except Exception as e:
  1218. raise e
  1219. else:
  1220. model = model_item
  1221. model_info = None
  1222. request.state.direct = True
  1223. request.state.model = model
  1224. model_info_params = (
  1225. model_info.params.model_dump() if model_info and model_info.params else {}
  1226. )
  1227. # Chat Params
  1228. stream_delta_chunk_size = form_data.get("params", {}).get(
  1229. "stream_delta_chunk_size"
  1230. )
  1231. reasoning_tags = form_data.get("params", {}).get("reasoning_tags")
  1232. # Model Params
  1233. if model_info_params.get("stream_delta_chunk_size"):
  1234. stream_delta_chunk_size = model_info_params.get("stream_delta_chunk_size")
  1235. if model_info_params.get("reasoning_tags") is not None:
  1236. reasoning_tags = model_info_params.get("reasoning_tags")
  1237. metadata = {
  1238. "user_id": user.id,
  1239. "chat_id": form_data.pop("chat_id", None),
  1240. "message_id": form_data.pop("id", None),
  1241. "session_id": form_data.pop("session_id", None),
  1242. "filter_ids": form_data.pop("filter_ids", []),
  1243. "tool_ids": form_data.get("tool_ids", None),
  1244. "tool_servers": form_data.pop("tool_servers", None),
  1245. "files": form_data.get("files", None),
  1246. "features": form_data.get("features", {}),
  1247. "variables": form_data.get("variables", {}),
  1248. "model": model,
  1249. "direct": model_item.get("direct", False),
  1250. "params": {
  1251. "stream_delta_chunk_size": stream_delta_chunk_size,
  1252. "reasoning_tags": reasoning_tags,
  1253. "function_calling": (
  1254. "native"
  1255. if (
  1256. form_data.get("params", {}).get("function_calling") == "native"
  1257. or model_info_params.get("function_calling") == "native"
  1258. )
  1259. else "default"
  1260. ),
  1261. },
  1262. }
  1263. if metadata.get("chat_id") and (user and user.role != "admin"):
  1264. if metadata["chat_id"] != "local":
  1265. chat = Chats.get_chat_by_id_and_user_id(metadata["chat_id"], user.id)
  1266. if chat is None:
  1267. raise HTTPException(
  1268. status_code=status.HTTP_404_NOT_FOUND,
  1269. detail=ERROR_MESSAGES.DEFAULT(),
  1270. )
  1271. request.state.metadata = metadata
  1272. form_data["metadata"] = metadata
  1273. except Exception as e:
  1274. log.debug(f"Error processing chat metadata: {e}")
  1275. raise HTTPException(
  1276. status_code=status.HTTP_400_BAD_REQUEST,
  1277. detail=str(e),
  1278. )
  1279. async def process_chat(request, form_data, user, metadata, model):
  1280. try:
  1281. form_data, metadata, events = await process_chat_payload(
  1282. request, form_data, user, metadata, model
  1283. )
  1284. response = await chat_completion_handler(request, form_data, user)
  1285. if metadata.get("chat_id") and metadata.get("message_id"):
  1286. try:
  1287. Chats.upsert_message_to_chat_by_id_and_message_id(
  1288. metadata["chat_id"],
  1289. metadata["message_id"],
  1290. {
  1291. "model": model_id,
  1292. },
  1293. )
  1294. except:
  1295. pass
  1296. return await process_chat_response(
  1297. request, response, form_data, user, metadata, model, events, tasks
  1298. )
  1299. except asyncio.CancelledError:
  1300. log.info("Chat processing was cancelled")
  1301. try:
  1302. event_emitter = get_event_emitter(metadata)
  1303. await event_emitter(
  1304. {"type": "chat:tasks:cancel"},
  1305. )
  1306. except Exception as e:
  1307. pass
  1308. except Exception as e:
  1309. log.debug(f"Error processing chat payload: {e}")
  1310. if metadata.get("chat_id") and metadata.get("message_id"):
  1311. # Update the chat message with the error
  1312. try:
  1313. Chats.upsert_message_to_chat_by_id_and_message_id(
  1314. metadata["chat_id"],
  1315. metadata["message_id"],
  1316. {
  1317. "error": {"content": str(e)},
  1318. },
  1319. )
  1320. event_emitter = get_event_emitter(metadata)
  1321. await event_emitter(
  1322. {
  1323. "type": "chat:message:error",
  1324. "data": {"error": {"content": str(e)}},
  1325. }
  1326. )
  1327. await event_emitter(
  1328. {"type": "chat:tasks:cancel"},
  1329. )
  1330. except:
  1331. pass
  1332. if (
  1333. metadata.get("session_id")
  1334. and metadata.get("chat_id")
  1335. and metadata.get("message_id")
  1336. ):
  1337. # Asynchronous Chat Processing
  1338. task_id, _ = await create_task(
  1339. request.app.state.redis,
  1340. process_chat(request, form_data, user, metadata, model),
  1341. id=metadata["chat_id"],
  1342. )
  1343. return {"status": True, "task_id": task_id}
  1344. else:
  1345. return await process_chat(request, form_data, user, metadata, model)
  1346. # Alias for chat_completion (Legacy)
  1347. generate_chat_completions = chat_completion
  1348. generate_chat_completion = chat_completion
  1349. @app.post("/api/chat/completed")
  1350. async def chat_completed(
  1351. request: Request, form_data: dict, user=Depends(get_verified_user)
  1352. ):
  1353. try:
  1354. model_item = form_data.pop("model_item", {})
  1355. if model_item.get("direct", False):
  1356. request.state.direct = True
  1357. request.state.model = model_item
  1358. return await chat_completed_handler(request, form_data, user)
  1359. except Exception as e:
  1360. raise HTTPException(
  1361. status_code=status.HTTP_400_BAD_REQUEST,
  1362. detail=str(e),
  1363. )
  1364. @app.post("/api/chat/actions/{action_id}")
  1365. async def chat_action(
  1366. request: Request, action_id: str, form_data: dict, user=Depends(get_verified_user)
  1367. ):
  1368. try:
  1369. model_item = form_data.pop("model_item", {})
  1370. if model_item.get("direct", False):
  1371. request.state.direct = True
  1372. request.state.model = model_item
  1373. return await chat_action_handler(request, action_id, form_data, user)
  1374. except Exception as e:
  1375. raise HTTPException(
  1376. status_code=status.HTTP_400_BAD_REQUEST,
  1377. detail=str(e),
  1378. )
  1379. @app.post("/api/tasks/stop/{task_id}")
  1380. async def stop_task_endpoint(
  1381. request: Request, task_id: str, user=Depends(get_verified_user)
  1382. ):
  1383. try:
  1384. result = await stop_task(request.app.state.redis, task_id)
  1385. return result
  1386. except ValueError as e:
  1387. raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail=str(e))
  1388. @app.get("/api/tasks")
  1389. async def list_tasks_endpoint(request: Request, user=Depends(get_verified_user)):
  1390. return {"tasks": await list_tasks(request.app.state.redis)}
  1391. @app.get("/api/tasks/chat/{chat_id}")
  1392. async def list_tasks_by_chat_id_endpoint(
  1393. request: Request, chat_id: str, user=Depends(get_verified_user)
  1394. ):
  1395. chat = Chats.get_chat_by_id(chat_id)
  1396. if chat is None or chat.user_id != user.id:
  1397. return {"task_ids": []}
  1398. task_ids = await list_task_ids_by_item_id(request.app.state.redis, chat_id)
  1399. log.debug(f"Task IDs for chat {chat_id}: {task_ids}")
  1400. return {"task_ids": task_ids}
  1401. ##################################
  1402. #
  1403. # Config Endpoints
  1404. #
  1405. ##################################
  1406. @app.get("/api/config")
  1407. async def get_app_config(request: Request):
  1408. user = None
  1409. token = None
  1410. auth_header = request.headers.get("Authorization")
  1411. if auth_header:
  1412. cred = get_http_authorization_cred(auth_header)
  1413. if cred:
  1414. token = cred.credentials
  1415. if not token and "token" in request.cookies:
  1416. token = request.cookies.get("token")
  1417. if token:
  1418. try:
  1419. data = decode_token(token)
  1420. except Exception as e:
  1421. log.debug(e)
  1422. raise HTTPException(
  1423. status_code=status.HTTP_401_UNAUTHORIZED,
  1424. detail="Invalid token",
  1425. )
  1426. if data is not None and "id" in data:
  1427. user = Users.get_user_by_id(data["id"])
  1428. user_count = Users.get_num_users()
  1429. onboarding = False
  1430. if user is None:
  1431. onboarding = user_count == 0
  1432. return {
  1433. **({"onboarding": True} if onboarding else {}),
  1434. "status": True,
  1435. "name": app.state.WEBUI_NAME,
  1436. "version": VERSION,
  1437. "default_locale": str(DEFAULT_LOCALE),
  1438. "oauth": {
  1439. "providers": {
  1440. name: config.get("name", name)
  1441. for name, config in OAUTH_PROVIDERS.items()
  1442. }
  1443. },
  1444. "features": {
  1445. "auth": WEBUI_AUTH,
  1446. "auth_trusted_header": bool(app.state.AUTH_TRUSTED_EMAIL_HEADER),
  1447. "enable_signup_password_confirmation": ENABLE_SIGNUP_PASSWORD_CONFIRMATION,
  1448. "enable_ldap": app.state.config.ENABLE_LDAP,
  1449. "enable_api_key": app.state.config.ENABLE_API_KEY,
  1450. "enable_signup": app.state.config.ENABLE_SIGNUP,
  1451. "enable_login_form": app.state.config.ENABLE_LOGIN_FORM,
  1452. "enable_websocket": ENABLE_WEBSOCKET_SUPPORT,
  1453. "enable_version_update_check": ENABLE_VERSION_UPDATE_CHECK,
  1454. **(
  1455. {
  1456. "enable_direct_connections": app.state.config.ENABLE_DIRECT_CONNECTIONS,
  1457. "enable_channels": app.state.config.ENABLE_CHANNELS,
  1458. "enable_notes": app.state.config.ENABLE_NOTES,
  1459. "enable_web_search": app.state.config.ENABLE_WEB_SEARCH,
  1460. "enable_code_execution": app.state.config.ENABLE_CODE_EXECUTION,
  1461. "enable_code_interpreter": app.state.config.ENABLE_CODE_INTERPRETER,
  1462. "enable_image_generation": app.state.config.ENABLE_IMAGE_GENERATION,
  1463. "enable_autocomplete_generation": app.state.config.ENABLE_AUTOCOMPLETE_GENERATION,
  1464. "enable_community_sharing": app.state.config.ENABLE_COMMUNITY_SHARING,
  1465. "enable_message_rating": app.state.config.ENABLE_MESSAGE_RATING,
  1466. "enable_user_webhooks": app.state.config.ENABLE_USER_WEBHOOKS,
  1467. "enable_admin_export": ENABLE_ADMIN_EXPORT,
  1468. "enable_admin_chat_access": ENABLE_ADMIN_CHAT_ACCESS,
  1469. "enable_google_drive_integration": app.state.config.ENABLE_GOOGLE_DRIVE_INTEGRATION,
  1470. "enable_onedrive_integration": app.state.config.ENABLE_ONEDRIVE_INTEGRATION,
  1471. }
  1472. if user is not None
  1473. else {}
  1474. ),
  1475. },
  1476. **(
  1477. {
  1478. "default_models": app.state.config.DEFAULT_MODELS,
  1479. "default_prompt_suggestions": app.state.config.DEFAULT_PROMPT_SUGGESTIONS,
  1480. "user_count": user_count,
  1481. "code": {
  1482. "engine": app.state.config.CODE_EXECUTION_ENGINE,
  1483. },
  1484. "audio": {
  1485. "tts": {
  1486. "engine": app.state.config.TTS_ENGINE,
  1487. "voice": app.state.config.TTS_VOICE,
  1488. "split_on": app.state.config.TTS_SPLIT_ON,
  1489. },
  1490. "stt": {
  1491. "engine": app.state.config.STT_ENGINE,
  1492. },
  1493. },
  1494. "file": {
  1495. "max_size": app.state.config.FILE_MAX_SIZE,
  1496. "max_count": app.state.config.FILE_MAX_COUNT,
  1497. "image_compression": {
  1498. "width": app.state.config.FILE_IMAGE_COMPRESSION_WIDTH,
  1499. "height": app.state.config.FILE_IMAGE_COMPRESSION_HEIGHT,
  1500. },
  1501. },
  1502. "permissions": {**app.state.config.USER_PERMISSIONS},
  1503. "google_drive": {
  1504. "client_id": GOOGLE_DRIVE_CLIENT_ID.value,
  1505. "api_key": GOOGLE_DRIVE_API_KEY.value,
  1506. },
  1507. "onedrive": {
  1508. "client_id": ONEDRIVE_CLIENT_ID.value,
  1509. "sharepoint_url": ONEDRIVE_SHAREPOINT_URL.value,
  1510. "sharepoint_tenant_id": ONEDRIVE_SHAREPOINT_TENANT_ID.value,
  1511. },
  1512. "ui": {
  1513. "pending_user_overlay_title": app.state.config.PENDING_USER_OVERLAY_TITLE,
  1514. "pending_user_overlay_content": app.state.config.PENDING_USER_OVERLAY_CONTENT,
  1515. "response_watermark": app.state.config.RESPONSE_WATERMARK,
  1516. },
  1517. "license_metadata": app.state.LICENSE_METADATA,
  1518. **(
  1519. {
  1520. "active_entries": app.state.USER_COUNT,
  1521. }
  1522. if user.role == "admin"
  1523. else {}
  1524. ),
  1525. }
  1526. if user is not None and (user.role in ["admin", "user"])
  1527. else {
  1528. **(
  1529. {
  1530. "ui": {
  1531. "pending_user_overlay_title": app.state.config.PENDING_USER_OVERLAY_TITLE,
  1532. "pending_user_overlay_content": app.state.config.PENDING_USER_OVERLAY_CONTENT,
  1533. }
  1534. }
  1535. if user and user.role == "pending"
  1536. else {}
  1537. ),
  1538. **(
  1539. {
  1540. "metadata": {
  1541. "login_footer": app.state.LICENSE_METADATA.get(
  1542. "login_footer", ""
  1543. ),
  1544. "auth_logo_position": app.state.LICENSE_METADATA.get(
  1545. "auth_logo_position", ""
  1546. ),
  1547. }
  1548. }
  1549. if app.state.LICENSE_METADATA
  1550. else {}
  1551. ),
  1552. }
  1553. ),
  1554. }
  1555. class UrlForm(BaseModel):
  1556. url: str
  1557. @app.get("/api/webhook")
  1558. async def get_webhook_url(user=Depends(get_admin_user)):
  1559. return {
  1560. "url": app.state.config.WEBHOOK_URL,
  1561. }
  1562. @app.post("/api/webhook")
  1563. async def update_webhook_url(form_data: UrlForm, user=Depends(get_admin_user)):
  1564. app.state.config.WEBHOOK_URL = form_data.url
  1565. app.state.WEBHOOK_URL = app.state.config.WEBHOOK_URL
  1566. return {"url": app.state.config.WEBHOOK_URL}
  1567. @app.get("/api/version")
  1568. async def get_app_version():
  1569. return {
  1570. "version": VERSION,
  1571. }
  1572. @app.get("/api/version/updates")
  1573. async def get_app_latest_release_version(user=Depends(get_verified_user)):
  1574. if not ENABLE_VERSION_UPDATE_CHECK:
  1575. log.debug(
  1576. f"Version update check is disabled, returning current version as latest version"
  1577. )
  1578. return {"current": VERSION, "latest": VERSION}
  1579. try:
  1580. timeout = aiohttp.ClientTimeout(total=1)
  1581. async with aiohttp.ClientSession(timeout=timeout, trust_env=True) as session:
  1582. async with session.get(
  1583. "https://api.github.com/repos/open-webui/open-webui/releases/latest",
  1584. ssl=AIOHTTP_CLIENT_SESSION_SSL,
  1585. ) as response:
  1586. response.raise_for_status()
  1587. data = await response.json()
  1588. latest_version = data["tag_name"]
  1589. return {"current": VERSION, "latest": latest_version[1:]}
  1590. except Exception as e:
  1591. log.debug(e)
  1592. return {"current": VERSION, "latest": VERSION}
  1593. @app.get("/api/changelog")
  1594. async def get_app_changelog():
  1595. return {key: CHANGELOG[key] for idx, key in enumerate(CHANGELOG) if idx < 5}
  1596. @app.get("/api/usage")
  1597. async def get_current_usage(user=Depends(get_verified_user)):
  1598. """
  1599. Get current usage statistics for Open WebUI.
  1600. This is an experimental endpoint and subject to change.
  1601. """
  1602. try:
  1603. return {"model_ids": get_models_in_use(), "user_ids": get_active_user_ids()}
  1604. except Exception as e:
  1605. log.error(f"Error getting usage statistics: {e}")
  1606. raise HTTPException(status_code=500, detail="Internal Server Error")
  1607. ############################
  1608. # OAuth Login & Callback
  1609. ############################
  1610. # SessionMiddleware is used by authlib for oauth
  1611. if len(OAUTH_PROVIDERS) > 0:
  1612. app.add_middleware(
  1613. SessionMiddleware,
  1614. secret_key=WEBUI_SECRET_KEY,
  1615. session_cookie="oui-session",
  1616. same_site=WEBUI_SESSION_COOKIE_SAME_SITE,
  1617. https_only=WEBUI_SESSION_COOKIE_SECURE,
  1618. )
  1619. @app.get("/oauth/{provider}/login")
  1620. async def oauth_login(provider: str, request: Request):
  1621. return await oauth_manager.handle_login(request, provider)
  1622. # OAuth login logic is as follows:
  1623. # 1. Attempt to find a user with matching subject ID, tied to the provider
  1624. # 2. If OAUTH_MERGE_ACCOUNTS_BY_EMAIL is true, find a user with the email address provided via OAuth
  1625. # - This is considered insecure in general, as OAuth providers do not always verify email addresses
  1626. # 3. If there is no user, and ENABLE_OAUTH_SIGNUP is true, create a user
  1627. # - Email addresses are considered unique, so we fail registration if the email address is already taken
  1628. @app.get("/oauth/{provider}/callback")
  1629. async def oauth_callback(provider: str, request: Request, response: Response):
  1630. return await oauth_manager.handle_callback(request, provider, response)
  1631. @app.get("/manifest.json")
  1632. async def get_manifest_json():
  1633. if app.state.EXTERNAL_PWA_MANIFEST_URL:
  1634. return requests.get(app.state.EXTERNAL_PWA_MANIFEST_URL).json()
  1635. else:
  1636. return {
  1637. "name": app.state.WEBUI_NAME,
  1638. "short_name": app.state.WEBUI_NAME,
  1639. "description": f"{app.state.WEBUI_NAME} is an open, extensible, user-friendly interface for AI that adapts to your workflow.",
  1640. "start_url": "/",
  1641. "display": "standalone",
  1642. "background_color": "#343541",
  1643. "icons": [
  1644. {
  1645. "src": "/static/logo.png",
  1646. "type": "image/png",
  1647. "sizes": "500x500",
  1648. "purpose": "any",
  1649. },
  1650. {
  1651. "src": "/static/logo.png",
  1652. "type": "image/png",
  1653. "sizes": "500x500",
  1654. "purpose": "maskable",
  1655. },
  1656. ],
  1657. }
  1658. @app.get("/opensearch.xml")
  1659. async def get_opensearch_xml():
  1660. xml_content = rf"""
  1661. <OpenSearchDescription xmlns="http://a9.com/-/spec/opensearch/1.1/" xmlns:moz="http://www.mozilla.org/2006/browser/search/">
  1662. <ShortName>{app.state.WEBUI_NAME}</ShortName>
  1663. <Description>Search {app.state.WEBUI_NAME}</Description>
  1664. <InputEncoding>UTF-8</InputEncoding>
  1665. <Image width="16" height="16" type="image/x-icon">{app.state.config.WEBUI_URL}/static/favicon.png</Image>
  1666. <Url type="text/html" method="get" template="{app.state.config.WEBUI_URL}/?q={"{searchTerms}"}"/>
  1667. <moz:SearchForm>{app.state.config.WEBUI_URL}</moz:SearchForm>
  1668. </OpenSearchDescription>
  1669. """
  1670. return Response(content=xml_content, media_type="application/xml")
  1671. @app.get("/health")
  1672. async def healthcheck():
  1673. return {"status": True}
  1674. @app.get("/health/db")
  1675. async def healthcheck_with_db():
  1676. Session.execute(text("SELECT 1;")).all()
  1677. return {"status": True}
  1678. app.mount("/static", StaticFiles(directory=STATIC_DIR), name="static")
  1679. @app.get("/cache/{path:path}")
  1680. async def serve_cache_file(
  1681. path: str,
  1682. user=Depends(get_verified_user),
  1683. ):
  1684. file_path = os.path.abspath(os.path.join(CACHE_DIR, path))
  1685. # prevent path traversal
  1686. if not file_path.startswith(os.path.abspath(CACHE_DIR)):
  1687. raise HTTPException(status_code=404, detail="File not found")
  1688. if not os.path.isfile(file_path):
  1689. raise HTTPException(status_code=404, detail="File not found")
  1690. return FileResponse(file_path)
  1691. def swagger_ui_html(*args, **kwargs):
  1692. return get_swagger_ui_html(
  1693. *args,
  1694. **kwargs,
  1695. swagger_js_url="/static/swagger-ui/swagger-ui-bundle.js",
  1696. swagger_css_url="/static/swagger-ui/swagger-ui.css",
  1697. swagger_favicon_url="/static/swagger-ui/favicon.png",
  1698. )
  1699. applications.get_swagger_ui_html = swagger_ui_html
  1700. if os.path.exists(FRONTEND_BUILD_DIR):
  1701. mimetypes.add_type("text/javascript", ".js")
  1702. app.mount(
  1703. "/",
  1704. SPAStaticFiles(directory=FRONTEND_BUILD_DIR, html=True),
  1705. name="spa-static-files",
  1706. )
  1707. else:
  1708. log.warning(
  1709. f"Frontend build directory not found at '{FRONTEND_BUILD_DIR}'. Serving API only."
  1710. )