Connect a provider

Woopcode needs an API key before it can do anything.

Get a key#

Create one at Google AI Studio. It is free to generate and takes about a minute.

Give it to Woopcode#

The first launch asks for it:

woopcode — setup

  Welcome to Woopcode!   You can create a free API key at:  https://aistudio.google.com/apikey   Paste your Google Gemini API key:  > ...   ✓ API key verified

The key is checked against the provider before it is saved, so a bad paste fails here rather than halfway through your first turn.

Or do it from your shell, which is the better option when the key is already in an environment variable:

woopcode providers login --provider google --api-key "$GOOGLE_API_KEY"

Confirm it#

woopcode providers list

Inside a session, /status shows the provider, the model, and the approval mode in one line.

Where the key goes#

Into providers.json in your config directory — ~/.config/woopcode/ on macOS and Linux.

When it does not work#

Invalid API key. Please try again. — The key was rejected before being saved. Check for a trailing space or newline in the paste, and confirm it is a Google AI Studio key rather than a Google Cloud one.

The setup flow does not appear — A key is already stored. /login inside a session, or woopcode providers login, replaces it.

Requests fail after working yesterday — The key may have been revoked or hit a quota. Google AI Studio shows both.

Next#

Your first session
Configuring providers — switching models, changing the default

Added in woopcode@0.6.0