Dify 1.5.1stable Released Jul 02, 2025
Impact Score: 5/10

Dify: v1.5.1

Source available β€” automated, not human-reviewed

Component: dify Β· Channel: stable. Automated analysis, not a compatibility certification. How this works.

Analysis updated: 2026-11-01.

Compatibility not verified β€” check source notes
πŸ“„ .MD
⚑ Executive Summary (TL;DR)

Dify 1.5.1. Source highlight: πŸŽ‰ What’s New in v1.5.1? πŸŽ‰

Who Does This Impact? (Role-Based Analysis)

πŸ’» Software Engineers & Devs

Check the source notes against the package and APIs you use before upgrading.

πŸ“Š Product & Engineering Leads

Use the documented changes to assess relevance to your product; release frequency alone is not a quality measure.

βš™οΈ DevOps & Security

Verify the target version, runtime requirements and rollback procedure in the official documentation.

✨ New Features & Capabilities (6)

  • **Knowledge Basis Indexing**: Introduced KB indexing by @Gevtolev in #20868. It optimizes the access and retrieval speeds for your data treasures.
  • **Model Provider Validation**: Added model provider validation in the API by @khoazero123 in #21582. Ensure your models are always in check.
  • **Dynamic Select Parameter**: Implemented DYNAMIC_SELECT for dynamic options in parameter entities by @Yeuoly in #21425. Say goodbye to static param limits!
  • **Structured Output Plugin**: Now invoke LLMs with structured output via a new API endpoint by @Yeuoly in #21624.
  • **Adaptive Panel Width Management**: A refactor to add adaptive width observer for panels by @ZeroZ-lab in #21576.
  • **New Plugin Enhancements**: Default value autofill in plugin settings by @leslie2046 in #21669.

⚑ Performance & Enhancements (2)

  • **Front-End UX**: Improved tooltip for workflow run node names and input restrictions by @CorrectRoadH in #21564 and #21562.
  • Improve Langfuse trace readability

πŸ”§ Bug Fixes & Patches (6)

  • **UI and Style Tweaks**: Various style fixes and enhancements, including decreasing navbar z-index for clarity by @douxc in #21612.
  • **Langfuse Trace Readability**: Enhanced the clarity of Langfuse traces, making debugging and performance tracking clearer by @DavideDelbianco in #21777.
  • **Various UI and API Fixes**: Addressed pop logic in tool selectors, variable inspection, and numerous API-related bugs to ensure a smoother experience.
  • Fixed incorrect doc links and context insertion in prompt editors by @iamjoel and @zxhlyh.
  • Resolved false token numbers and auto-increment errors in question-answer models by @NeatGuyCoding in #21574.
  • Fixed node validation, hover effects, and modal presentations to fully support your workflows by multiple contributors.
πŸ“„ View Raw Release Notes (Original Developer Log)
# πŸŽ‰ What’s New in v1.5.1? πŸŽ‰ In this release, we've packed a punch with a host of new features, enhancements, and fixes designed to make your experience smoother and more intuitive. ## πŸš€ New Features - **Knowledge Basis Indexing**: Introduced KB indexing by @Gevtolev in #20868. It optimizes the access and retrieval speeds for your data treasures. - **Model Provider Validation**: Added model provider validation in the API by @khoazero123 in #21582. Ensure your models are always in check. - **Dynamic Select Parameter**: Implemented DYNAMIC_SELECT for dynamic options in parameter entities by @Yeuoly in #21425. Say goodbye to static param limits! - **Structured Output Plugin**: Now invoke LLMs with structured output via a new API endpoint by @Yeuoly in #21624. - **Adaptive Panel Width Management**: A refactor to add adaptive width observer for panels by @ZeroZ-lab in #21576. - **New Plugin Enhancements**: Default value autofill in plugin settings by @leslie2046 in #21669. ## 🌟 Enhancements - **Front-End UX**: Improved tooltip for workflow run node names and input restrictions by @CorrectRoadH in #21564 and #21562. - **UI and Style Tweaks**: Various style fixes and enhancements, including decreasing navbar z-index for clarity by @douxc in #21612. - **Langfuse Trace Readability**: Enhanced the clarity of Langfuse traces, making debugging and performance tracking clearer by @DavideDelbianco in #21777. ## πŸ› οΈ Bug Fixes - **Various UI and API Fixes**: Addressed pop logic in tool selectors, variable inspection, and numerous API-related bugs to ensure a smoother experience. - Fixed incorrect doc links and context insertion in prompt editors by @iamjoel and @zxhlyh. - Resolved false token numbers and auto-increment errors in question-answer models by @NeatGuyCoding in #21574. - Fixed node validation, hover effects, and modal presentations to fully support your workflows by multiple contributors. - **Error Handling & Reset Issues**: - Enhanced error handling in code interpreters and fixed system variable resets by @quicksandznzn and @iamjoel. - Adjusted reset system variable to avoid server crashes, thanks to @QuantumGhost in #21604. - **Integration and Language Support**: - Improved integrations with services like Notion and document detail services by @baonudesifeizhai and others. - Fixed dollar-sign escaping in LaTeX for smoother document processing by @ShadowJobs in #21796. This latest release blends a blend of functional enrichment and optimized usability across the board. Dive in and make the most of these updates - we can't wait to see what you build next! Happy developing! πŸŽ¨πŸ› οΈ --- ## Upgrade Guide ### Docker Compose Deployments 1. Back up your customized docker-compose YAML file (optional) ```bash cd docker cp docker-compose.yaml docker-compose.yaml.$(date +%s).bak ``` 2. Get the latest code from the main branch ```bash git checkout main git pull origin main ``` 3. Stop the service. Please execute in the docker directory ```bash docker compose down ``` 4. Back up data ```bash tar -cvf volumes-$(date +%s).tgz volumes ``` 5. Upgrade services ```bash docker compose up -d ``` ### Source Code Deployments 1. Stop the API server, Worker, and Web frontend Server. 2. Get the latest code from the release branch: ```bash git checkout 1.5.1 ``` 3. Update Python dependencies: ```bash cd api uv sync ``` 7. Then, let's run the migration script: ```bash uv run flask db upgrade ``` 8. Finally, run the API server, Worker, and Web frontend Server again. --- ## What's Changed * Feat/kb index by @Gevtolev in https://github.com/langgenius/dify/pull/20868 * feat: add a magic field in the cancel invite api response by @GareArc in https://github.com/langgenius/dify/pull/21505 * fix: var inspect doc link error by @iamjoel in https://github.com/langgenius/dify/pull/21515 * fix: prompt editor insert context by @zxhlyh in https://github.com/langgenius/dify/pull/21526 * Fix minor comment missing by @NeatGuyCoding in https://github.com/langgenius/dify/pull/21517 * feat: refactor: test_dataset unit tests #21499 by @NeatGuyCoding in https://github.com/langgenius/dify/pull/21502 * chore: remove unused code by @jiangbo721 in https://github.com/langgenius/dify/pull/21497 * chore: Simplify code logic by @jiangbo721 in https://github.com/langgenius/dify/pull/21496 * fix: update retrieval method cache by @WTW0313 in https://github.com/langgenius/dify/pull/21409 * feat: add tooltip to workflow run node name by @CorrectRoadH in https://github.com/langgenius/dify/pull/21564 * feat: prevent input of non-numeric values ​​in numer input by @CorrectRoadH in https://github.com/langgenius/dify/pull/21562 * fix(web): optimize the pop logic of the tool selector (#21558) by @HyaCiovo in https://github.com/langgenius/dify/pull/21559 * fix: fix create custom modal overlay add tool by @CorrectRoadH in https://github.com/langgenius/dify/pull/21553 * feat: add DYNAMIC_SELECT parameter type for dynamic options in parameter entities by @Yeuoly in https://github.com/langgenius/dify/pull/21425 * fix: wrong token number when using qa_model and answer is updated. by @NeatGuyCoding in https://github.com/langgenius/dify/pull/21574 * Feat/api validate model provider by @khoazero123 in https://github.com/langgenius/dify/pull/21582 * feat: Add display control logic for the variable inspection panel by @ZeroZ-lab in https://github.com/langgenius/dify/pull/21539 * feat: to add tag when tag input is unfocus by @CorrectRoadH in https://github.com/langgenius/dify/pull/21555 * fix: value_selector will be empty string by @crazywoola in https://github.com/langgenius/dify/pull/21598 * feat: Refactor panel component, add adaptive width observer to optimize panel width management by @ZeroZ-lab in https://github.com/langgenius/dify/pull/21576 * style: decrease navbar z-index value from 30 to 15, fix style error by @douxc in https://github.com/langgenius/dify/pull/21612 * fix: Resolving conflicts caused by tablestore dependency on enum34 by @wanttobeamaster in https://github.com/langgenius/dify/pull/21605 * refactor: move structured output support outside LLM Node by @Yeuoly in https://github.com/langgenius/dify/pull/21565 * fix: annotation remove functionality Fixes #21448 by @guangtouwangba in https://github.com/langgenius/dify/pull/21616 * feat(plugin): Add API endpoint for invoking LLM with structured output by @Yeuoly in https://github.com/langgenius/dify/pull/21624 * chore: Add missing svg icon sources by @DavideDelbianco in https://github.com/langgenius/dify/pull/21627 * Add Env 'CELERY_SENTINEL_PASSWORD' for celery connect redis sentinel. by @zhanluxianshen in https://github.com/langgenius/dify/pull/21198 * feat(inner-api/workspace): include tenant details in CreateWorkspace response by @zhangx1n in https://github.com/langgenius/dify/pull/21636 * feat: Add autofill by default value in endpoint plugin setting page. by @leslie2046 in https://github.com/langgenius/dify/pull/21669 * fix(ui): no hover effect in copy button of code node by @Minamiyama in https://github.com/langgenius/dify/pull/21671 * fix: #21427 correct segment settings when creating documents via API by @guangtouwangba in https://github.com/langgenius/dify/pull/21673 * fix: keep search params in web app url when needs authorize by @douxc in https://github.com/langgenius/dify/pull/21717 * fix: enter and exit full canvas cause nav items missing by @hjlarry in https://github.com/langgenius/dify/pull/21691 * Add get document detail service api by @ZombieBlue in https://github.com/langgenius/dify/pull/21700 * fix: copy inspect variable value get extra quotes by @hjlarry in https://github.com/langgenius/dify/pull/21680 * fix: fix node valid detect by @Minamiyama in https://github.com/langgenius/dify/pull/21709 * [fix] #21678 User input of remote file link on the run page form causes conversation/message interface error by @dlmu-lq in https://github.com/langgenius/dify/pull/21683 * Fix/ serveral bugs fixed in enterprise by @douxc in https://github.com/langgenius/dify/pull/21729 * Fixes issue 21157/20661 extra quote in agent node by @wanghan5 in https://github.com/langgenius/dify/pull/21674 * fix: user cannot select 'Customer Service & Operations' category by @douxc in https://github.com/langgenius/dify/pull/21733 * chore: translate i18n files by @github-actions in https://github.com/langgenius/dify/pull/21732 * Feat: sync input variable names to main() function by @Minamiyama in https://github.com/langgenius/dify/pull/21667 * fix: set the func.coalesce() second paramter default value #21239 by @kgpp34 in https://github.com/langgenius/dify/pull/21240 * feat: Retain LLM Configuration Settings When Changing Model by @fdb02983rhy in https://github.com/langgenius/dify/pull/21247 * Release db.session connection before workflow new thread long time operation by @dlmu-lq in https://github.com/langgenius/dify/pull/21726 * refactor: define the Dify project version in pyproject.toml by @bowenliang123 in https://github.com/langgenius/dify/pull/20910 * fix: can not reset system variables by @iamjoel in https://github.com/langgenius/dify/pull/21750 * chore: upgrade package versions for security reason by @iamjoel in https://github.com/langgenius/dify/pull/21751 * fix: code Interpreter error handling not work by @quicksandznzn in https://github.com/langgenius/dify/pull/21736 * fix: handle configure button for notion internal integration by @baonudesifeizhai in https://github.com/langgenius/dify/pull/21412 * fix: incorrect api module version in pyproject.toml by @bowenliang123 in https://github.com/langgenius/dify/pull/21755 * fix: if parameter is not required, continue by @jiangbo721 in https://github.com/langgenius/dify/pull/21761 * minor fix: add parameters in error msg of Plugin service returned no options by @NeatGuyCoding in https://github.com/langgenius/dify/pull/21662 * fix: notion kownledge datasets can't add new page by @hjlarry in https://github.com/langgenius/dify/pull/21779 * Improve Langfuse trace readability by @DavideDelbianco in https://github.com/langgenius/dify/pull/21777 * fix: when config plugin endpoint choose no start form app cause page crashed by @iamjoel in https://github.com/langgenius/dify/pull/21789 * chore: new inspected variable add to top position instead of bottom by @iamjoel in https://github.com/langgenius/dify/pull/21793 * FIX: dollar-sign escaping in preprocessLaTeX code‐block handling by @ShadowJobs in https://github.com/langgenius/dify/pull/21796 * fix: Make the latency and logs of web applications consistent. by @jiangbo721 in https://github.com/langgenius/dify/pull/21578 * fix(api): Fix resetting sys var causing internal server error by @QuantumGhost in https://github.com/langgenius/dify/pull/21604 * fix(api): files not returned in the answer node by @QuantumGhost in https://github.com/langgenius/dify/pull/21807 * Fix: prevent SQL errors when metadata filter Constant value is None or blank by @efreykongcn in https://github.com/langgenius/dify/pull/21803 * chore: put new run var to the top by @iamjoel in https://github.com/langgenius/dify/pull/21816 * chore(version): bump to 1.5.1 by @laipz8200 in https://github.com/langgenius/dify/pull/21808 ## New Contributors * @khoazero123 made their first contribution in https://github.com/langgenius/dify/pull/21582 * @dlmu-lq made their first contribution in https://github.com/langgenius/dify/pull/21683 * @baonudesifeizhai made their first contribution in https://github.com/langgenius/dify/pull/21412 * @efreykongcn made their first contribution in https://github.com/langgenius/dify/pull/21803 **Full Changelog**: https://github.com/langgenius/dify/compare/1.5.0...1.5.1