Use Endeavor with ChatGPT/Codex

Note

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

This guide connects Codex CLI and local Codex tasks in the ChatGPT/Codex desktop app to flwrlabs/endeavor-1.1 at https://api.flower.ai/v1. The commands below use macOS and its default shell, zsh. Before continuing, install your preferred client using the Codex CLI installation guide or the desktop app setup guide.

The example uses Endeavor 1.1. For release status, see Available versions. For model details, see Endeavor. To use OpenCode instead, see Use Endeavor with OpenCode.

1. Save the model catalog

Save the flower-models.json catalog to your Downloads folder, keeping that filename. This catalog makes Endeavor available in the model selector and defines its capabilities.

Note

The supplied catalog configures a 128,000-token context window and a 96,000-token automatic compaction threshold for this client. API request limits depend on the deployment. See Context window and limits for details.

In your terminal, copy the file to the Codex configuration directory:

mkdir -p "$HOME/.codex"
cp "$HOME/Downloads/flower-models.json" "$HOME/.codex/flower-models.json"
printf 'model_catalog_json = "%s/.codex/flower-models.json"\n' "$HOME"

Copy the printed model_catalog_json line for the next step.

2. Configure Codex

The CLI and desktop app share ~/.codex/config.toml. Create the file if needed, back it up, and open it:

touch "$HOME/.codex/config.toml"
cp -p "$HOME/.codex/config.toml" \
  "$HOME/.codex/config.toml.backup.$(date +%Y%m%d-%H%M%S)"
open -a TextEdit "$HOME/.codex/config.toml"

Add or update the following settings, preserving unrelated configuration. Keep the first four settings at the top level, before any [section]. Replace the model_catalog_json line with the one printed in 1. Save the model catalog, then save the file. Update existing keys and sections rather than adding duplicates.

model = "flwrlabs/endeavor-1.1"
model_provider = "flower"
model_reasoning_effort = "low"
model_catalog_json = "/Users/YOUR_USERNAME/.codex/flower-models.json"

[model_providers.flower]
name = "Flower Labs"
base_url = "https://api.flower.ai/v1"
wire_api = "responses"
env_key = "FLOWER_API_KEY"

For more options, see the Codex configuration reference.

3. Set your Flower API key

Follow Set your Flower API key to set FLOWER_API_KEY in your terminal. Keep the terminal open for the next step.

4. Start using Endeavor

Codex CLI

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

codex

Endeavor is selected by default. 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.

ChatGPT/Codex desktop app on macOS

Fully quit the desktop app. In the same terminal where you set FLOWER_API_KEY, launch it with the key:

open -a ChatGPT --env FLOWER_API_KEY="$FLOWER_API_KEY"

Start a new local Codex task and select Endeavor in the model selector. Send a prompt to begin. Repeat this launch command each time you start the desktop app. Opening it from the Dock may not supply the key.

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.