AI Provider Setup Reference

Open Notomo → Settings → AI → Providers to manage providers. Notomo stores account credentials and API keys in the macOS Keychain. Only connected and enabled providers appear in model selectors.

Account providers

ChatGPT Account

1. Click Sign in with ChatGPT in the Account section.
2. Complete authorization in the sign-in window.
3. Keep the ChatGPT toggle enabled after signing in.

Signing out removes ChatGPT models from model selectors. The connection does not depend on a local CLI.

xAI Account

1. Click Sign in with xAI in the Account section.
2. Follow the sign-in prompts and authorize with a SuperGrok or X Premium account.
3. Keep the xAI toggle enabled after signing in.

The connection does not depend on a local CLI. If the session expires, return to this page and sign in again.

API providers

Click Add API Provider, choose a service, and complete the required fields:

Provider	Required settings	Other settings
OpenAI API	API Key	—
Google Gemini API	API Key	—
OpenRouter API	API Key	Fetch or manually add models
DeepSeek API	API Key	—
GLM Coding Plan	API Key	Region: Global or China
Cloudflare Workers AI	Account ID, API Token	Fetch or manually add models
OpenAI-compatible API	Provider Name, API Base URL	API Key optional; fetch or manually add models

After completing the fields:

1. Click Verify to test the credentials and service address.
2. For services with dynamic model lists, click Fetch Models and select the models to use.
3. If a model is not listed, click Custom and enter its model ID.
4. Save the configuration and confirm that the provider is enabled.

Changing the GLM Coding Plan Region only switches the API endpoint. It does not change the API Key or verification status.

OpenAI-compatible API notes

• Provider Name must be unique so the service can be distinguished in settings and model selectors.
• Prefer a Base URL that uses https://.
• Notomo allows http:// URLs for local services.
• With other plain HTTP addresses, request content and API keys are not encrypted.
• Some local services do not require an API Key; leave it blank in that case.

Model ID

When adding a model manually, enter the model ID accepted by the service API, not just its display name. An incorrect model ID is usually rejected only when you send the first request.

Antigravity

Antigravity runs Google’s official Antigravity agent locally over the Agent Client Protocol (ACP). You do not need Terminal or the agy CLI.

1. Open Providers → Local Agents and click Install. Notomo downloads the agent from Google and verifies Google’s code signature.
2. Click Sign in with Google and finish signing in in your browser.
3. Turn on the Antigravity toggle. Its Gemini models appear in model selectors once the agent is installed, signed in, and enabled.

Use Check for Updates in the Antigravity row to install a newer agent when one is available.

When web search is set to Auto or On, Notomo allows Antigravity’s native search_web tool. It declines all other agent tool requests, so Antigravity cannot edit files on your Mac.

Edit or disable a provider

• Turning off a provider hides its models without immediately deleting credentials.
• Click a configured API provider to verify it again, adjust models, or update credentials.
• Use Sign Out to disconnect an Account provider.
• Before deleting an API configuration, make sure you no longer need its custom models.

If a model does not appear, confirm in order that the provider is connected, its toggle is enabled, the model has been added, and the Account login or CLI session remains valid. See Common issues for more troubleshooting steps.