Skip to main content
Droid is Factory’s coding agent for the terminal and IDEs. It supports bring-your-own-key custom models, so any OpenAI-compatible endpoint can serve it — including Opper.

Setup

Add a customModels entry to ~/.factory/settings.json:
Add one entry per model you want in the picker. provider must be generic-chat-completion-api for an OpenAI-compatible endpoint.
Factory also reads a legacy snake_case format (custom_models, base_url) from ~/.factory/config.json. Where both exist, settings.json wins — use it for new setups.

Choosing a model

Droid lists whatever you put in customModels; there is no catalog fetch. Pull the IDs you want from the model catalog and add an entry each.

Troubleshooting

Check you edited ~/.factory/settings.json and not the legacy config.json, and that customModels is camelCase.
${OPPER_API_KEY} is expanded from the environment, so the variable has to be exported in the shell that starts Droid. Opper keys start with op-.
Raise maxOutputTokens for that entry. The value above is a conservative default, not the model’s limit.

Model catalog

Browse the catalog for model IDs and capabilities.

All integrations

Every app that runs on Opper.