Add llmman integration page - #592
ericcurtin wants to merge 1 commit into
Conversation
|
@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.
There was a problem hiding this comment.
馃煛 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.mddocumenting how to useollama-haystackcomponents againsthttp://localhost:17434. - Include examples for chat generation, tool calling, embedding, and using the OpenAI-compatible
/v1endpoints.
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
### Licensesection after the final code sample (and link it from the Table of Contents) so readers can quickly see the usage terms for llmman; upstreamllmmanis 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.
| - [Usage](#usage) | ||
| - [Chat Generation](#chat-generation) | ||
| - [Tool Calling](#tool-calling) | ||
| - [Embedders](#embedders) | ||
| - [Using the OpenAI-compatible API](#using-the-openai-compatible-api) |
| # Linux / macOS | ||
| curl -fsSL https://raw.githubusercontent.com/llmmanorg/llmman/main/install.sh | sh |
There was a problem hiding this comment.
馃煛 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
| 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 |
| llmman serve | ||
| llmman pull gemma4 |
| - [Chat Generation](#chat-generation) | ||
| - [Tool Calling](#tool-calling) | ||
| - [Embedders](#embedders) | ||
| - [Using the OpenAI-compatible API](#using-the-openai-compatible-api) |
kacperlukawski
left a comment
There was a problem hiding this comment.
Thank you, @ericcurtin Happy to merge once all the Copilot's comments are addressed
Adds llmman, a local model runner that serves the Ollama API (alongside OpenAI- and Anthropic-compatible ones) on port 17434.
integrations/llmman.mdonly, modelled onintegrations/ollama.md. No code changes:OllamaChatGenerator,OllamaTextEmbedderandOllamaDocumentEmbedderfromollama-haystackwork unchanged withurl="http://localhost:17434", so the page documents that rather than introducing a new package.pypiis omitted since llmman is not a PyPI package (reposatisfies the "at least one of" rule). Nologorather than reusing another provider's.OpenAIChatGeneratoragainsthttp://localhost:17434/v1for users who prefer to depend only onhaystack-ai.Testing: frontmatter parsed as YAML with required keys present; all 4 Python blocks
ast.parsed; in a fresh venv withollama-haystack6.8.0 confirmed the constructor kwargs used exist and the Ollama components construct without error. Not run against a live llmman server.