Model Independence > Custom Models (BYOK)

Custom Models (BYOK)

Point Droid at your own endpoint, pick the models you want, and copy a settings.json into ~/.factory.

Connect

Base URL and key are enough. Fetch reads /models when the endpoint exposes it.

Base URL

Local hosts like localhost:11434 get /v1 appended if it's missing.

API key

Display prefix

Shown as “Prefix / model-id”.

Provider

generic-chat-completion-apiOpenRouter, Ollama, vLLM, LM Studio, most proxies openaiOfficial OpenAI Responses API anthropicOfficial Anthropic Messages API

API key in the file

Store the key as-is Store ${ENV_VAR} instead

NOTE Keys stay in this tab. They are not sent anywhere except the base URL you type, via the local /models proxy.

No /models, CORS block, or I already have the JSON

Paste an OpenAI-style model list, or add ids below.

Models

Select the ones to write. Set tokens, vision, and enableThinking per model. Thinking-on is what makes Droid stream reasoning_content during the turn instead of dumping it after.

Fetch first. The list shows up here.

Add a model id manually

Extra settings

Theme, session defaults, favorites, mission models. Plugins and trusted folders stay out of this form.

Droid prefs

cloudSessionSync includeCoAuthoredByDroid showThinkingInMainView showTokenUsageIndicator nerdFont

logoAnimation

Session interaction

Session autonomy

Session autonomyMode

Legacy key Droid still reads. Defaults to auto-high.

Theme

Any id from Droid’s /themes command.

Default model

Default reasoning

Extra favorite ids

Factory-managed ids, comma separated.

Favorite selected custom models

Mission orchestrator

Orchestrator reasoning

Mission worker

Worker reasoning

Validation worker

Validation reasoning

Mission skips

skipScrutiny skipUserTesting

Merge into an existing settings.json

Paste your current file so these keys land on top and plugins / trusted folders stay put.

Replace matching customModels entries

settings.json

Submit builds the file. Copy it into ~/.factory/settings.json.