●Change8

b9174

📦 llama-cppView on GitHub →
✨ 6 features🐛 6 fixes⚡ 11 deprecations🔧 70 symbols

Summary

This release focuses heavily on renaming and restructuring the UI components, standardizing naming from 'webui' to 'ui' across the repository, CMake variables, CLI flags, and internal structures, while maintaining backward compatibility.

Migration Steps

  1. Update CMake usage to use `LLAMA_BUILD_UI` instead of `LLAMA_BUILD_WEBUI`.
  2. Update CMake usage to use `LLAMA_USE_PREBUILT_UI` instead of `LLAMA_USE_PREBUILT_WEBUI`.
  3. Update CLI invocations to use `--ui` instead of `--webui`.
  4. Update CLI invocations to use `--ui-config` instead of `--webui-config`.
  5. Update CLI invocations to use `--ui-config-file` instead of `--webui-config-file`.
  6. Update CLI invocations to use `--ui-mcp-proxy` instead of `--webui-mcp-proxy`.
  7. Update environment variables from LLAMA_ARG_WEBUI family to LLAMA_ARG_UI family.
  8. Update references in C++ code from `params.webui` usage to `params.ui` where appropriate, noting that old fields are synced for backward compatibility.
  9. Update CI/CD workflows, artifacts, and build scripts referencing `webui-build` or `webui-publish` to use `ui-build` or `ui-publish`.
  10. Update CODEOWNERS and README documentation references from `llama-webui` to `llama-ui` and path `/tools/server/webui/` to `/tools/ui/`.

✨ New Features

  • Restructured repository to use `tools/ui` folder for UI components.
  • Introduced new CLI flags: --ui, --ui-config, --ui-config-file, --ui-mcp-proxy.
  • Introduced new environment variables for UI configuration: LLAMA_ARG_UI, LLAMA_ARG_UI_CONFIG, LLAMA_ARG_UI_CONFIG_FILE, LLAMA_ARG_UI_MCP_PROXY.
  • Updated C++ internals to use `params.ui` and related structures.
  • JSON API now emits both old ("webui", "webui_settings") and new ("ui", "ui_settings") keys for backward compatibility.
  • Made llama-ui a linkable target in CMake.

🐛 Bug Fixes

  • Fixed small issues related to UI build process.
  • Fixed CMake.txt syntax errors.
  • Fixed `.editorconfig` settings for llama-ui.
  • Fixed UI Build output location/handling.
  • Fixed missing change in a previous commit.
  • Separated llama-ui npm build output into `build/tools/ui/dist` subfolder and switched CI to use CMake npm build instead of downloading artifacts.

Affected Symbols

tools/uitools/server/publicbuild/uiLLAMA_BUILD_WEBUILLAMA_BUILD_UILLAMA_USE_PREBUILT_WEBUILLAMA_USE_PREBUILT_UIWEBUI_SOURCEUI_SOURCEWEBUI_SOURCE_DIRUI_SOURCE_DIRLLAMA_WEBUI_HF_BUCKETLLAMA_UI_HF_BUCKETLLAMA_BUILD_WEBUILLAMA_BUILD_UILLAMA_WEBUI_DEFAULT_ENABLEDLLAMA_UI_DEFAULT_ENABLED--webui--ui--webui-config--ui-config--webui-config-file--ui-config-file--webui-mcp-proxy--ui-mcp-proxyLLAMA_ARG_UILLAMA_ARG_UI_CONFIGLLAMA_ARG_UI_CONFIG_FILELLAMA_ARG_UI_MCP_PROXYparams.uiparams.ui_config_jsonparams.ui_mcp_proxyjson_webui_settingsjson_ui_settingsserver_context_metaparams.webuiparams.ui"ui""ui_settings""webui""webui_settings"params.ui_mcp_proxyparams.webui_mcp_proxyLLAMA_BUILD_UILLAMA_BUILD_WEBUIwebui-build.ymlui-build.ymlHF_BUCKET_WEBUI_STATIC_OUTPUTHF_BUCKET_UI_STATIC_OUTPUTserver-webui.ymlserver-ui.ymlserver.ymlrelease.ymlHF_TOKEN_WEBUI_STATIC_OUTPUTHF_TOKEN_UI_STATIC_OUTPUTserver-self-hosted.ymlbuild-self-hosted.ymlHF_WEBUI_VERSIONHF_UI_VERSIONwebui-download.cmakeui-download.cmakelabeler.ymlCODEOWNERSggml-org/llama-webuiggml-org/llama-ui/tools/server/webui//tools/ui/server README.mdserver README-dev.mdAPP_NAME

⚡ Deprecations

  • The CMake variable LLAMA_BUILD_WEBUI is deprecated and will be removed; use LLAMA_BUILD_UI instead.
  • The CMake variable LLAMA_USE_PREBUILT_WEBUI is deprecated and will be removed; use LLAMA_USE_PREBUILT_UI instead.
  • CLI flag --webui is deprecated; use --ui instead.
  • CLI flag --webui-config is deprecated; use --ui-config instead.
  • CLI flag --webui-config-file is deprecated; use --ui-config-file instead.
  • CLI flag --webui-mcp-proxy is deprecated; use --ui-mcp-proxy instead.
  • Environment variables LLAMA_ARG_WEBUI, LLAMA_ARG_WEBUI_CONFIG, LLAMA_ARG_WEBUI_CONFIG_FILE, LLAMA_ARG_WEBUI_MCP_PROXY are deprecated; use LLAMA_ARG_UI, LLAMA_ARG_UI_CONFIG, LLAMA_ARG_UI_CONFIG_FILE, LLAMA_ARG_UI_MCP_PROXY respectively.
  • C++ struct fields related to webui parameters (e.g., params.webui) are being replaced by ui counterparts (e.g., params.ui).
  • Internal variable WEBUI_SOURCE is deprecated; use UI_SOURCE instead.
  • Internal variable WEBUI_SOURCE_DIR is deprecated; use UI_SOURCE_DIR instead.
  • HF bucket variable LLAMA_WEBUI_HF_BUCKET is deprecated; use LLAMA_UI_HF_BUCKET instead.