Models Settings
The Models section is the organization management area for AI. From here you control which models are available, enable or disable providers (Google, OpenAI, etc.), configure processing mode, and set up API keys. All settings sync to team members' Pieces Desktop and PiecesOS.
Models page showing provider sections (Google, OpenAI) with model lists and toggles
All model settings configured here automatically sync to team members' Pieces Desktop and PiecesOS installations.
How to Get to the Models Page
Go to [portal.pieces.app](https://portal.pieces.app) and sign in. Or from Pieces Desktop, click your `User Profile` → `Settings` → `Account` to reach your workspace.
In the *sidebar*, click the *organization dropdown* at the top and select your organization.
Click `Models` in the *sidebar* navigation. The Models page opens with the *Models* tab selected. Use the `API Keys` tab to add provider credentials.
Enabling the Customized Model Allow-List
By default, all models from enabled providers are available. To control which providers and models members can use, you must first enable the customized model allow-list. The provider toggles (Google, OpenAI, etc.) are only active when the allow-list is enabled.
On the Models page, find the *Customized Model Allow-List* toggle and turn it **on**.
A save reminder appears at the bottom of the page. Click `Save` to apply. The provider sections below become active so you can enable or disable providers and select specific models.
Enabling or Disabling a Provider (Google, OpenAI, etc.)
The customized model allow-list must be enabled for provider toggles to be active. See the section above.
Each provider (Google, OpenAI, Anthropic, etc.) has a toggle at the top of its section. Turn it on to make that provider's models available; turn it off to disable them.
Provider sections with on/off toggles for Google, OpenAI, and other providers
Ensure the *Customized Model Allow-List* toggle is **on** near the top of the Models page. Provider toggles are inactive until the allow-list is enabled.
On the Models page, scroll to the provider you want to change (e.g., *Google*, *OpenAI*).
Use the toggle switch at the top right of the provider section. Turn it **on** to enable that provider's models for your organization, or **off** to disable them.
A save reminder appears at the bottom of the page. Click `Save` to apply. Changes sync to all team members.
Selecting Allowed Models
With the allow-list and provider toggles configured, choose which specific models members can use.
On the Models page, scroll to each enabled provider (e.g., *Google*, *OpenAI*).
Use the checkboxes or controls next to each model to include or exclude it. Only models you explicitly allow will be available to members.
A save reminder appears at the bottom of the page. Click `Save` to apply.
Setting Organization-Wide Processing Mode
Control whether your organization uses local, cloud, or blended processing for AI features.
On the Models page, find the *Organization Managed Processing Mode* toggle and turn it **on**.
Use the *Organization-Wide Processing Mode* dropdown to select:
* **BLENDED** — Mix of local and cloud (recommended)
* **Local** — Process locally only (limits features)
A save reminder appears at the bottom of the page. Click `Save` to apply. The chosen mode applies to all organization members.
Blended mode is recommended. Local-only mode severely limits AI features.
Adding API Keys for Providers
To use models from OpenAI, Anthropic, or GCP, you need to add API keys. Switch to the API Keys tab within Models.
On the Models page, click the `API Keys` tab at the top.
Find the provider section (OpenAI, Anthropic, GCP) and click `+ Add API Key`. Enter your credentials and click `Save`.
Switch back to the *Models* tab to enable that provider and choose which models to use.
For full API key instructions, see API Keys Settings.
Next Steps
Add credentials in API Keys, or configure Long Term Memory for context capture and default models.
