Skip to content

Add llmman integration page - #592

Open
ericcurtin wants to merge 1 commit into
deepset-ai:mainfrom
ericcurtin:llmman
Open

ericcurtin wants to merge 1 commit into
deepset-ai:mainfrom
ericcurtin:llmman

Conversation

@ericcurtin

@ericcurtin ericcurtin commented Sep 4, 2026

Copy link
Copy Markdown

Adds llmman, a local model runner that serves the Ollama API (alongside OpenAI- and Anthropic-compatible ones) on port 17434.

  • New integrations/llmman.md only, modelled on integrations/ollama.md. No code changes: OllamaChatGenerator, OllamaTextEmbedder and OllamaDocumentEmbedder from ollama-haystack work unchanged with url="http://localhost:17434", so the page documents that rather than introducing a new package.
  • Frontmatter follows the README spec; pypi is omitted since llmman is not a PyPI package (repo satisfies the "at least one of" rule). No logo rather than reusing another provider's.
  • Also shows OpenAIChatGenerator against http://localhost:17434/v1 for users who prefer to depend only on haystack-ai.

Testing: frontmatter parsed as YAML with required keys present; all 4 Python blocks ast.parsed; in a fresh venv with ollama-haystack 6.8.0 confirmed the constructor kwargs used exist and the Ollama components construct without error. Not run against a live llmman server.

AI-assisted, reviewed before submitting.

@ericcurtin
ericcurtin requested a review from a team as a code owner September 4, 2026 12:47
@vercel

vercel Bot commented Sep 4, 2026

Copy link
Copy Markdown

@ericcurtin is attempting to deploy a commit to the deepset Team on Vercel.

A member of the Team first needs to authorize it.

llmman (https://github.com/llmmanorg/llmman) is a local model runner
that serves the Ollama API, alongside OpenAI- and Anthropic-compatible
ones, on port 17434. The existing ollama-haystack components work
against it unchanged once pointed at http://localhost:17434, so the
page mirrors integrations/ollama.md rather than adding a new package.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

馃煛 Changes recommended

The installation section introduces curl | sh / irm | iex patterns that should be adjusted to safer, inspectable install steps before publishing.

Get a fresh assessment by requesting another Copilot review.

Pull request overview
  • Purpose: Add a new integration documentation page for llmman (local model runner exposing the Ollama API plus OpenAI-/Anthropic-compatible endpoints) to the Haystack integrations docs.

Changes:

  • Add integrations/llmman.md documenting how to use ollama-haystack components against http://localhost:17434.
  • Include examples for chat generation, tool calling, embedding, and using the OpenAI-compatible /v1 endpoints.
File summaries
File Description
integrations/llmman.md New integration page documenting llmman usage with existing Haystack components (Ollama + OpenAI-compatible).
Review details

Suppressed comments (2)

integrations/llmman.md:43

  • The Windows install command pipes a remote script directly into PowerShell ("irm | iex"), which can be risky and prevents easy inspection of the script contents. Prefer downloading the script first and then executing it.
irm https://raw.githubusercontent.com/llmmanorg/llmman/main/install.ps1 | iex

integrations/llmman.md:169

  • Consider adding a dedicated ### License section after the final code sample (and link it from the Table of Contents) so readers can quickly see the usage terms for llmman; upstream llmman is Apache-2.0.
### Using the OpenAI-compatible API

llmman also exposes `/v1/chat/completions`, `/v1/completions`, `/v1/models` and `/v1/responses`, so you can use [`OpenAIChatGenerator`](https://docs.haystack.deepset.ai/docs/openaichatgenerator) instead of `OllamaChatGenerator` if you prefer to depend only on `haystack-ai`:
  • Files reviewed: 1/1 changed files
  • Comments generated: 2
  • Review effort level: Lite

馃挕 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread integrations/llmman.md
Comment on lines +20 to +24
- [Usage](#usage)
- [Chat Generation](#chat-generation)
- [Tool Calling](#tool-calling)
- [Embedders](#embedders)
- [Using the OpenAI-compatible API](#using-the-openai-compatible-api)
Comment thread integrations/llmman.md
Comment on lines +39 to +40
# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/llmmanorg/llmman/main/install.sh | sh

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

馃煛 Changes recommended

The installation URLs are invalid, and the setup commands prevent the model pull from executing.

Get a fresh assessment by requesting another Copilot review.

Review details
  • Files reviewed: 1/1 changed files
  • Comments generated: 3
  • Review effort level: Balanced

Comment thread integrations/llmman.md
Comment on lines +40 to +43
curl -fsSL https://raw.githubusercontent.com/llmmanorg/llmman/main/install.sh | sh

# Windows (PowerShell)
irm https://raw.githubusercontent.com/llmmanorg/llmman/main/install.ps1 | iex
Comment thread integrations/llmman.md
Comment on lines +49 to +50
llmman serve
llmman pull gemma4
Comment thread integrations/llmman.md
- [Chat Generation](#chat-generation)
- [Tool Calling](#tool-calling)
- [Embedders](#embedders)
- [Using the OpenAI-compatible API](#using-the-openai-compatible-api)

@kacperlukawski kacperlukawski left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Thank you, @ericcurtin Happy to merge once all the Copilot's comments are addressed

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants