Skip to content

docs(agent): Add ollama instruction docs - #8002

Merged
danieljanes merged 1 commit into
mainfrom
docs/agent-ollama-how-to-instructions
Aug 25, 2026
Merged

docs(agent): Add ollama instruction docs#8002
danieljanes merged 1 commit into
mainfrom
docs/agent-ollama-how-to-instructions

Conversation

@dstripelis

Copy link
Copy Markdown
Member

Summary

Add a new guide explaining how to run a Flower AgentApp locally with Ollama.

Why

Developers need a documented way to use Flower Agent without a Flower account or external model API key. Ollama provides a local OpenAI-compatible Responses endpoint that can be connected to a local SuperLink.

What

  • Adds the Run an AgentApp with Ollama guide.
  • Documents the required AgentApp and Flower project configuration.
  • Explains how to install and start Ollama and pull a model.
  • Configures SuperLink to use Ollama’s /v1/responses endpoint.
  • Shows how to run the app and override its model and prompt.
  • Includes troubleshooting steps for common Ollama and SuperLink issues.
  • Adds the guide to the Agent documentation navigation immediately after the local SuperLink guide.

Copilot AI lite review requested due to automatic review settings August 25, 2026 18:40
@dstripelis dstripelis changed the title Adding instruction docs docs(agent): Add ollama instruction docs Aug 25, 2026

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.

Pull request overview

Adds a new Agent documentation guide describing how to run a Flower AgentApp fully locally by connecting a local SuperLink to Ollama’s OpenAI-compatible Responses endpoint, avoiding the need for a Flower account or external model API keys.

Changes:

  • Adds a new how-to guide: “Run an AgentApp with a local SuperLink and Ollama”.
  • Documents required project setup (AgentApp, pyproject.toml), Ollama setup, SuperLink configuration, and basic troubleshooting.
  • Adds the new guide to the Agent docs navigation immediately after the local SuperLink guide.

Critical issues

  • None found.

Simplicity/readability suggestions

  • None required.

Consistency concerns

  • None found (the guide aligns with the existing local SuperLink guide patterns, including FLWR_MODEL_API_ENDPOINT using a full /v1/responses URL).

Whether the PR should be split

  • No.

Overall verdict

  • Looks ready as a documentation-only addition with consistent setup and commands.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File Description
agent/docs/source/index.md Adds the new Ollama guide to the Agent docs toctree immediately after the local SuperLink guide.
agent/docs/source/how-to-guides/run-with-ollama.md New end-to-end guide for running an AgentApp locally using SuperLink + Ollama’s /v1/responses endpoint, including troubleshooting.

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

@danieljanes
danieljanes merged commit 67badfb into main Aug 25, 2026
70 of 71 checks passed
@danieljanes
danieljanes deleted the docs/agent-ollama-how-to-instructions branch August 25, 2026 19:03
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.

4 participants