Models
Factory uses language models to investigate issues, plan changes, write code, and review pull requests. Connect a provider, then choose a model your account can use. Model access depends on your provider account.
Connect a provider
Before saving provider credentials, configure stored credential encryption on the server.
In onboarding, select a supported provider sign-in flow or supply an API key. For later changes, open Settings → Models and use the provider access controls. Complete sign-in in the provider's browser flow and return to Factory.
Choose the credential scope and model
| Scope | Who can use it |
|---|---|
| Personal | The user who saved or connected the credential. Teammates need their own access unless an organization credential covers them. |
| Organization | Users covered by the organization's configured provider access. Only authorized administrators can manage organization credentials. |
Choose the default model for tasks on your Factory's boards. When checking a run, confirm that its session uses the expected model and that the provider is connected.
To use a custom endpoint, add its URL and credentials in the custom provider settings. Store credentials in Factory's credential settings or on the server. Don't include them in issues or repository instruction files.
Choose models for each kind of work
Factory agents work in three modes, and each benefits from a different model. A model pack groups three model choices:
| Mode | Used for |
|---|---|
| Build | Implementation with full tool access. |
| Plan | Read-only analysis and planning. |
| Fast | Quick answers and small edits. |
Factory ships built-in packs, and you can save custom packs. Which built-in packs you see depends on the providers you have connected, so connect a provider first. Custom packs are shared across your organization, and you can select one as your default.
Where models are chosen
Model selection depends on where a session starts:
- Factory runs started by Factory, such as triage and board work items, use the Factory's default model in Settings → Models → Factory defaults rather than your personal packs.
- Interactive sessions you start in the web UI or Slack begin on your active model pack. If you have no active pack, they use the Factory default.
In a session's status line, open the model picker to switch packs or override the model for the current mode. Reset to default pack restores your default pack. Manage model packs in that menu opens Settings → Models → Your defaults, where you create custom packs and choose your default. Changing a model in the picker affects the current session.