Models deployed via localAI can be used in LLM functions, but they cannot be used in agents. #21008

Closed
opened 2026-02-21 20:10:14 -05:00 by yindo · 1 comment
Owner

Originally created by @lululu-1997 on GitHub (Dec 12, 2025).

Self Checks

  • I have read the Contributing Guide and Language Policy.
  • This is only for bug report, if you would like to ask a question, please head to Discussions.
  • I have searched for existing issues search for existing issues, including closed ones.
  • I confirm that I am using English to submit this report, otherwise it will be closed.
  • 【中文用户 & Non English User】请使用英语提交,否则会被关闭 :)
  • Please do not modify this template :) and fill in all the required fields.

Dify version

1.9.2

Cloud or Self Hosted

Self Hosted (Docker)

Steps to reproduce

1.Add a model that deployed via LocalAI
2.Use it in Agent

✔️ Expected Behavior

Use it in Agent, like LLM

Image Image

Actual Behavior

Image Image
Originally created by @lululu-1997 on GitHub (Dec 12, 2025). ### Self Checks - [x] I have read the [Contributing Guide](https://github.com/langgenius/dify/blob/main/CONTRIBUTING.md) and [Language Policy](https://github.com/langgenius/dify/issues/1542). - [x] This is only for bug report, if you would like to ask a question, please head to [Discussions](https://github.com/langgenius/dify/discussions/categories/general). - [x] I have searched for existing issues [search for existing issues](https://github.com/langgenius/dify/issues), including closed ones. - [x] I confirm that I am using English to submit this report, otherwise it will be closed. - [x] 【中文用户 & Non English User】请使用英语提交,否则会被关闭 :) - [x] Please do not modify this template :) and fill in all the required fields. ### Dify version 1.9.2 ### Cloud or Self Hosted Self Hosted (Docker) ### Steps to reproduce 1.Add a model that deployed via LocalAI 2.Use it in Agent ### ✔️ Expected Behavior Use it in Agent, like LLM <img width="1770" height="618" alt="Image" src="https://github.com/user-attachments/assets/c71bdbbe-8d02-4b31-beaf-76b858f1e0c0" /> <img width="3351" height="1710" alt="Image" src="https://github.com/user-attachments/assets/2c9c2c9d-d19d-4624-83aa-3f85aee0d3ab" /> ### ❌ Actual Behavior <img width="3351" height="1712" alt="Image" src="https://github.com/user-attachments/assets/10eab6fc-67c9-4066-8695-350ab12968f3" /> <img width="3351" height="1722" alt="Image" src="https://github.com/user-attachments/assets/5dcdb68b-eac7-49e5-b6f0-e3b8c5112dc3" />
yindo added the 🐞 bug label 2026-02-21 20:10:14 -05:00
yindo closed this issue 2026-02-21 20:10:14 -05:00
Author
Owner

@dosubot[bot] commented on GitHub (Dec 12, 2025):

This is a known limitation in Dify: agent nodes only allow models that support agent strategies like function calling or ReACT. Most local models, including those deployed via LocalAI, do not appear in the agent selection unless they support these methods. The backend and UI are designed to show only models that guarantee consistent API interaction, which usually means online models, so local models are excluded from agent selection unless they meet these requirements. Full support for arbitrary local models in agent strategies is not yet implemented as of v1.9.21 2 3 .

If your LocalAI model supports function calling, double-check your plugin configuration and refresh the UI after adding new models—sometimes they don't appear until you do so. Also, make sure your plugin is up to date and properly configured. If the model still doesn't show up, you can use default LLM parameters in the agent node as a workaround. Most issues with models not appearing in agents are due to plugin compatibility or configuration, not the core Dify code4 5 .

To reply, just mention @dosu.


How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other

Chat with Dosu Open in Cursor Join Discord Share on X

@dosubot[bot] commented on GitHub (Dec 12, 2025): <!-- Answer --> This is a known limitation in Dify: agent nodes only allow models that support agent strategies like function calling or ReACT. Most local models, including those deployed via LocalAI, do not appear in the agent selection unless they support these methods. The backend and UI are designed to show only models that guarantee consistent API interaction, which usually means online models, so local models are excluded from agent selection unless they meet these requirements. Full support for arbitrary local models in agent strategies is not yet implemented as of v1.9.2[^1][^2][^3]. If your LocalAI model supports function calling, double-check your plugin configuration and refresh the UI after adding new models—sometimes they don't appear until you do so. Also, make sure your plugin is up to date and properly configured. If the model still doesn't show up, you can use default LLM parameters in the agent node as a workaround. Most issues with models not appearing in agents are due to plugin compatibility or configuration, not the core Dify code[^4][^5]. [^1]: [Agent tool filters for models compatible with agent strategies](https://github.com/langgenius/dify/issues/23997#issuecomment-3191107882) [^2]: [Known limitation for local models in agent strategies](https://github.com/langgenius/dify/issues/23230#issuecomment-3139206855) [^3]: [Community discussion of LocalAI models in agents](https://github.com/langgenius/dify/discussions/29580) [^4]: [Plugin compatibility and configuration issues](https://github.com/langgenius/dify-official-plugins/issues/1110) [^5]: [Similar issue with Ollama/vLLM models](https://github.com/langgenius/dify/issues/19749#issuecomment-2883016328) <!-- Dosu Comment Footer --> *To reply, just mention [@dosu](https://go.dosu.dev/dosubot).* --- <sup>How did I do? [Good](https://app.dosu.dev/response-feedback/0552f8f4-73e7-46c7-85d7-cbc832873a6e?feedback_type=great_response) | [Irrelevant](https://app.dosu.dev/response-feedback/0552f8f4-73e7-46c7-85d7-cbc832873a6e?feedback_type=irrelevant_answer) | [Incorrect](https://app.dosu.dev/response-feedback/0552f8f4-73e7-46c7-85d7-cbc832873a6e?feedback_type=incorrect_sources) | [Verbose](https://app.dosu.dev/response-feedback/0552f8f4-73e7-46c7-85d7-cbc832873a6e?feedback_type=too_verbose) | [Hallucination](https://app.dosu.dev/response-feedback/0552f8f4-73e7-46c7-85d7-cbc832873a6e?feedback_type=hallucination) | [Report 🐛](https://app.dosu.dev/response-feedback/0552f8f4-73e7-46c7-85d7-cbc832873a6e?feedback_type=bug_report) | [Other](https://app.dosu.dev/response-feedback/0552f8f4-73e7-46c7-85d7-cbc832873a6e?feedback_type=other)</sup> [![Chat with Dosu](https://dosu.dev/dosu-chat-badge.svg)](https://app.dosu.dev/6088a4f4-073a-43f3-b3d4-4f06fb0c05a0/ask?utm_source=github)&nbsp;[![Open in Cursor](https://dosu.dev/dosu-in-cursor.svg)](https://cursor.com/link/prompt?text=This%20is%20a%20known%20limitation%20in%20Dify%3A%20agent%20nodes%20only%20allow%20models%20that%20support%20agent%20strategies%20like%20function%20calling%20or%20ReACT.%20Most%20local%20models%2C%20including%20those%20deployed%20via%20LocalAI%2C%20do%20not%20appear%20in%20the%20agent%20selection%20unless%20they%20support%20these%20methods.%20The%20backend%20and%20UI%20are%20designed%20to%20show%20only%20models%20that%20guarantee%20consistent%20API%20interaction%2C%20which%20usually%20means%20online%20models%2C%20so%20local%20models%20are%20excluded%20from%20agent%20selection%20unless%20they%20meet%20these%20requirements.%20Full%20support%20for%20arbitrary%20local%20models%20in%20agent%20strategies%20is%20not%20yet%20implemented%20as%20of%20v1.9.2%5B%5E1%5D%5B%5E2%5D%5B%5E3%5D.%0A%0AIf%20your%20LocalAI%20model%20supports%20function%20calling%2C%20double-check%20your%20plugin%20configuration%20and%20refresh%20the%20UI%20after%20adding%20new%20models%E2%80%94sometimes%20they%20don%27t%20appear%20until%20you%20do%20so.%20Also%2C%20make%20sure%20your%20plugin%20is%20up%20to%20date%20and%20properly%20configured.%20If%20the%20model%20still%20doesn%27t%20show%20up%2C%20you%20can%20use%20default%20LLM%20parameters%20in%20the%20agent%20node%20as%20a%20workaround.%20Most%20issues%20with%20models%20not%20appearing%20in%20agents%20are%20due%20to%20plugin%20compatibility%20or%20configuration%2C%20not%20the%20core%20Dify%20code%5B%5E4%5D%5B%5E5%5D.%0A%0A%5B%5E1%5D%3A%20%5BAgent%20tool%20filters%20for%20models%20compatible%20with%20agent%20strategies%5D%28https%3A//github.com/langgenius/dify/issues/23997%23issuecomment-3191107882%29%0A%5B%5E2%5D%3A%20%5BKnown%20limitation%20for%20local%20models%20in%20agent%20strategies%5D%28https%3A//github.com/langgenius/dify/issues/23230%23issuecomment-3139206855%29%0A%5B%5E3%5D%3A%20%5BCommunity%20discussion%20of%20LocalAI%20models%20in%20agents%5D%28https%3A//github.com/langgenius/dify/discussions/29580%29%0A%5B%5E4%5D%3A%20%5BPlugin%20compatibility%20and%20configuration%20issues%5D%28https%3A//github.com/langgenius/dify-official-plugins/issues/1110%29%0A%5B%5E5%5D%3A%20%5BSimilar%20issue%20with%20Ollama/vLLM%20models%5D%28https%3A//github.com/langgenius/dify/issues/19749%23issuecomment-2883016328%29)&nbsp;[![Join Discord](https://img.shields.io/badge/join-5865F2?logo=discord&logoColor=white&label=)](https://go.dosu.dev/discord-bot)&nbsp;[![Share on X](https://img.shields.io/badge/X-share-black)](https://twitter.com/intent/tweet?text=%40dosu_ai%20helped%20me%20solve%20this%20issue!&url=https%3A//github.com/langgenius/dify/issues/29582)
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: langgenius/dify#21008