Use Endeavor with OpenCode¶

Note

You need a Flower API key with Endeavor access. Request access by filling out the Endeavor 1.0 access form.

This guide connects OpenCode CLI and OpenCode Desktop to flwrlabs/endeavor-1.0 at https://api.flower.ai/v1. The commands below use macOS and its default shell, zsh. Install your preferred client using the OpenCode setup guide before continuing.

For model details, see Endeavor 1.0. To use ChatGPT/Codex instead, see Use Endeavor with ChatGPT/Codex.

1. Configure OpenCode¶

The CLI and desktop app share the global OpenCode configuration. Create its directory if needed:

mkdir -p "$HOME/.config/opencode"

Save the following as ~/.config/opencode/opencode.json in a text editor. If you already have an opencode.json or opencode.jsonc file in that directory, back it up and edit that file instead. Merge the top-level model and provider.flower-labs settings, preserving unrelated configuration.

{
  "$schema": "https://opencode.ai/config.json",
  "model": "flower-labs/flwrlabs/endeavor-1.0",
  "provider": {
    "flower-labs": {
      "npm": "@ai-sdk/openai",
      "name": "Flower Labs",
      "options": {
        "baseURL": "https://api.flower.ai/v1",
        "apiKey": "{env:FLOWER_API_KEY}"
      },
      "models": {
        "flwrlabs/endeavor-1.0": {
          "name": "Endeavor"
        }
      }
    }
  }
}

Keep @ai-sdk/openai as shown: it uses the Responses API required by this setup. See the OpenCode provider documentation for details.

For context window and API limit details, see Context window and limits.

2. Set your Flower API key¶

Follow Set your Flower API key to set FLOWER_API_KEY in your terminal. For desktop use, also complete that guide’s desktop setup before reopening OpenCode. Keep the terminal open for the next step.

3. Start using Endeavor¶

OpenCode CLI¶

In the same terminal, change to your project directory and start OpenCode:

opencode --model flower-labs/flwrlabs/endeavor-1.0

Send a prompt such as Explain the structure of this project. Repeat the instructions in Set your Flower API key when starting from a new terminal session.

OpenCode Desktop on macOS¶

After completing the desktop key setup in Set your Flower API key, reopen OpenCode, open a local project, start a new session, and select Endeavor from Flower Labs in the model selector. Send a prompt to begin.

Get help¶

If you encounter any issues, feel free to post on Flower Discuss or Flower Slack. The Flower team will get back to you soon.