Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 36 additions & 0 deletions docs/server/apps/goose.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@

# Running Goose agents with Lemonade Server

## Overview

[Goose](https://block.github.io/goose/) is an open source local AI agent by Block and is part of the [Agentic AI Foundation](https://aaif.io/). Goose includes a desktop application as well as a console application and both support Mac, Windows, and Linux.
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.

Suggested change
[Goose](https://block.github.io/goose/) is an open source local AI agent by Block and is part of the [Agentic AI Foundation](https://aaif.io/). Goose includes a desktop application as well as a console application and both support Mac, Windows, and Linux.
[Goose](https://block.github.io/goose/) is an open source local AI agent by Block and is part of the [Agentic AI Foundation](https://aaif.io/). Goose includes a desktop application as well as a console application and supports Mac, Windows, and Linux.


## Setup

### Prerequisites

1. Install Lemonade Server by following the [Lemonade Server Instructions](../README.md)
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.

Suggested change
1. Install Lemonade Server by following the [Lemonade Server Instructions](../README.md)
1. Install Lemonade Server by following the [Lemonade Server Instructions](https://lemonade-server.ai/install_options.html)


2. Install and set up Goose from the quickstart documentation Goose provides [here](https://block.github.io/goose/docs/quickstart).

### Configure Goose to Use Lemonade

From the goose cli, you can use `goose configure` to enter configuration mode for goose. You will choose `Configure Providers`. Choose the OpenAI provider. You will be prompted for an OpenAI key. If asked to configure advanced settings, agree to update the OPENAI_HOST. Set this to your lemonade server. The OPENAI_BASE_PATH can remain the default. Finally, you should be able to search for a model you have installed in Lemonade Server and choose the model you wish to use.
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.

In the prerequisite steps, the instructions say to just install Goose using their documentation, which provides 2 paths: app or CLI. However, in the configuration, the instructions are only CLI based.
Recommendation, provide instructions for configuring within the app and with the CLI. As well, these instructions could use an example of what the correct configuration settings are in order to work with Lemonade Server.


The configuration should exit. The next time you run goose you will be using the Lemonade Server.

**Note:** Goose expects to be configured with a model that has tool calling enabled. You will receive an error if you choose a model that does not support tool calling.

Configuration is similar for the Goose desktop app.

## Subagents with Goose

Goose supports using subagents and recipes. You can have a separate recipe for each model your Lemonade Server supports if you like, or even mix and match other providers like Claude or Gemini.

With the variety of model options available in Lemonade Server, from NPU models to Vulkan support, goose can create subagents and recipes based on the models you have installed from OCR to Image detection to chat.

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.

Recommendation to put an example here for someone to try or reference relevant documentation

## Additional Resources

- [Goose](https://block.github.io/goose/)
- [Goose Quickstart](https://block.github.io/goose/docs/quickstart)
- [Goose Recipes Guide](https://block.github.io/goose/docs/guides/recipes/)
1 change: 1 addition & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -69,6 +69,7 @@ nav:
- AnythingLLM: server/apps/anythingLLM.md
- CodeGPT: server/apps/codeGPT.md
- Continue: server/apps/continue.md
- Goose: server/apps/goose.md
- Mindcraft: server/apps/mindcraft.md
- OpenHands: server/apps/open-hands.md
- Open WebUI: server/apps/open-webui.md
Expand Down
Loading