Skip to content

Add LiteLLM integration documentation#45740

Draft
luismalves wants to merge 19 commits into
home-assistant:nextfrom
luismalves:litellm-docs
Draft

Add LiteLLM integration documentation#45740
luismalves wants to merge 19 commits into
home-assistant:nextfrom
luismalves:litellm-docs

Conversation

@luismalves
Copy link
Copy Markdown

@luismalves luismalves commented Jun 3, 2026

Proposed change

Add documentation for the new LiteLLM integration, which lets you use a self-hosted LiteLLM proxy (an OpenAI-compatible API in front of many model providers) as a conversation agent in Home Assistant. Documents the config flow (proxy URL and optional API key), prerequisites, model discovery, and the conversation-agent functionality.

Type of change

  • Spelling, grammar or other readability improvements (current branch).
  • Adjusted missing or incorrect information in the current documentation (current branch).
  • Added documentation for a new integration I'm adding to Home Assistant (next branch).
  • Added documentation for a new feature I'm adding to Home Assistant (next branch).
  • Removed stale or deprecated documentation.

Additional information

Checklist

  • This PR uses the correct branch, based on one of the following:
    • I made a change to the existing documentation and used the current branch.
    • I made a change that is related to an upcoming version of Home Assistant and used the next branch.
  • The documentation follows the Home Assistant documentation standards.

Copilot AI review requested due to automatic review settings June 3, 2026 22:17
@home-assistant home-assistant Bot added has-parent This PR has a parent PR in another repo next This PR goes into the next branch labels Jun 3, 2026
@netlify
Copy link
Copy Markdown

netlify Bot commented Jun 3, 2026

Deploy Preview for home-assistant-docs ready!

Name Link
🔨 Latest commit 4c0b458
🔍 Latest deploy log https://app.netlify.com/projects/home-assistant-docs/deploys/6a22d3154c22610008fd938a
😎 Deploy Preview https://deploy-preview-45740--home-assistant-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Adds documentation for the new LiteLLM integration, explaining setup via the config flow and what functionality is provided (conversation agent via a self-hosted LiteLLM proxy).

Changes:

  • Introduces a new integration documentation page for LiteLLM.
  • Documents configuration fields (URL, optional API key) and prerequisites for running a proxy.
  • Describes supported functionality and removal steps.

Comment thread source/_integrations/litellm.markdown Outdated
Comment thread source/_integrations/litellm.markdown Outdated
Comment thread source/_integrations/litellm.markdown
Rephrase the Prerequisites paragraph to describe model discovery
generically instead of naming internal proxy endpoint paths, which
removes the `/v1` base-path contradiction flagged in review.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@c0ffeeca7 c0ffeeca7 added the new-integration This PR adds documentation for a new Home Assistant integration label Jun 4, 2026
Copy link
Copy Markdown
Contributor

@c0ffeeca7 c0ffeeca7 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for contributing 💪

Please restore the original PR template (see PULL_REQUEST_TEMPLATE.md)

@home-assistant
Copy link
Copy Markdown

home-assistant Bot commented Jun 4, 2026

Please take a look at the requested changes, and use the Ready for review button when you are done, thanks 👍

Learn more about our pull request process.

@home-assistant home-assistant Bot marked this pull request as draft June 4, 2026 05:39
@luismalves
Copy link
Copy Markdown
Author

Should be fixed now @c0ffeeca7 , thanks for pointing ou!

@luismalves luismalves requested a review from c0ffeeca7 June 4, 2026 10:08
@luismalves luismalves marked this pull request as ready for review June 4, 2026 10:17
luismalves and others added 2 commits June 4, 2026 14:34
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Comment thread source/_integrations/litellm.markdown
Comment thread source/_integrations/litellm.markdown Outdated
Comment thread source/_integrations/litellm.markdown
@home-assistant home-assistant Bot marked this pull request as draft June 5, 2026 06:38
luismalves and others added 3 commits June 5, 2026 09:36
Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@luismalves luismalves marked this pull request as ready for review June 5, 2026 08:43
@home-assistant home-assistant Bot requested a review from c0ffeeca7 June 5, 2026 08:43
Comment thread source/_integrations/litellm.markdown Outdated
Comment thread source/_integrations/litellm.markdown
@home-assistant home-assistant Bot marked this pull request as draft June 5, 2026 10:23
luismalves and others added 2 commits June 5, 2026 14:45
Accepting suggestion to clarify this section

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
Accepting suggestion to clarify this section

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

has-parent This PR has a parent PR in another repo new-integration This PR adds documentation for a new Home Assistant integration next This PR goes into the next branch

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants