Documentation

AI providers

Connect the AI subscription or API key that Astro uses, and share it with your team.

Astro runs on an AI provider that you connect. You can use a subscription you already pay for, or an API key. About 2 minutes.

Settings → AI Provider

Subscription or API key

SubscriptionAPI key
What it isYour Claude, ChatGPT, or Google planA key from the provider's developer console
What you payNothing extra. It uses your plan's allowance.The provider bills you for each use.
Where the work runsOn your machine, through CompanionOn FounderHQ's servers

Most people start with a subscription and Companion. An API key is the simpler choice when you do not want to keep an app running.

Providers you can connect

ProviderKindMakes images
Claude subscription (Pro or Max)SubscriptionNo
ChatGPT subscription (Plus or Pro)SubscriptionYes
Google Antigravity subscription (beta)SubscriptionYes
AnthropicAPI keyNo
OpenAIAPI keyYes
Google Gemini (beta)API keyYes

Image generation in FounderHQ needs one of the providers marked Yes.

Connect a subscription

  1. Open Settings → AI Provider.
  2. Press Connect with Claude, Connect with ChatGPT, or Connect with Google.
  3. Approve the connection in the tab that opens. ChatGPT shows a code for you to enter there.
  4. Come back to FounderHQ.

A subscription also needs a paired Companion to run on.

Connect an API key

  1. Create a key in the provider's developer console. The provider card links to it.
  2. Paste the key into the card and save.

Verify

The provider shows Connected. Press Test to check that it answers. Then ask Astro something in any product.

Manage your providers

ControlWhat it does
Set as defaultAstro uses this provider first.
Active switchPauses a provider without removing it.
TestSends a small request to check the connection.
RemoveDisconnects it.

Reconnect on a provider means its sign-in expired. Connect it again.

Share AI with your team

A provider belongs to the person who connected it. Owners and admins can let the team share, in Settings → Organization, under Organization AI policy:

SwitchWhat it allows
Shared AI credentialsA member with no provider of their own uses one connected by a teammate.
Shared companion devicesA member with no Companion of their own uses one paired by a teammate.

Press Save changes after changing a switch.

AI agent or LLM? Read this page as markdown

On this page