# kindgi providers

> Manage model providers

## `kindgi providers`

**Synopsis**

```sh signature
kindgi providers <command>
```

Manage model providers.

**Commands**

| Command                                                                                                                | Description                                                                        |
| ---------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| [`kindgi providers list`](https://docs.kindgi.com/v0.1.9/reference/cli/providers.md#kindgi-providers-list)             | List model providers.                                                              |
| [`kindgi providers get`](https://docs.kindgi.com/v0.1.9/reference/cli/providers.md#kindgi-providers-get)               | Fetch a provider by id.                                                            |
| [`kindgi providers register`](https://docs.kindgi.com/v0.1.9/reference/cli/providers.md#kindgi-providers-register)     | Register a model provider — from a spec, or a preset (`kindgi providers presets`). |
| [`kindgi providers presets`](https://docs.kindgi.com/v0.1.9/reference/cli/providers.md#kindgi-providers-presets)       | List the provider presets `register --preset` takes.                               |
| [`kindgi providers unregister`](https://docs.kindgi.com/v0.1.9/reference/cli/providers.md#kindgi-providers-unregister) | Unregister a model provider.                                                       |

**See also**

- [Deploy on Google Cloud Run](https://docs.kindgi.com/v0.1.9/deploy/self-hosted/cloud-run.md)
- [Self-host Kindgi](https://docs.kindgi.com/v0.1.9/deploy/self-hosted/self-host.md)
- [Connect Anthropic](https://docs.kindgi.com/v0.1.9/guides/models/anthropic.md)
- [Connect OpenAI, Gemini, Groq or OpenRouter](https://docs.kindgi.com/v0.1.9/guides/models/api-key-presets.md)

### `kindgi providers list`

**Synopsis**

```sh signature
kindgi providers list [--feature=<name>] [--limit=<n>] [--cursor=<c>]
```

List model providers.

**Options**

| Option              | Default              | Description                                                              |
| ------------------- | -------------------- | ------------------------------------------------------------------------ |
| `--cursor <value>`  | none                 | Resume after this cursor, from the previous page's `nextCursor`.         |
| `--feature <value>` | none                 | Only the providers with a model that has this feature (e.g. `tool-use`). |
| `--limit <value>`   | `25` (at most `100`) | The most providers to return (default 25, at most 100).                  |

Every command also takes the [global flags](https://docs.kindgi.com/v0.1.9/reference/cli.md#global-flags).

**Examples**

From [Models](https://docs.kindgi.com/v0.1.9/guides/models.md):

```sh
pnpm exec kindgi providers list                          # every provider, with its models
pnpm exec kindgi providers list --feature=structured-output
```

**See also**

- [Models](https://docs.kindgi.com/v0.1.9/guides/models.md)
- [`kindgi providers`](https://docs.kindgi.com/v0.1.9/reference/cli/providers.md#kindgi-providers)

### `kindgi providers get`

**Synopsis**

```sh signature
kindgi providers get <provider-id>
```

Fetch a provider by id.

**Options**

Every command also takes the [global flags](https://docs.kindgi.com/v0.1.9/reference/cli.md#global-flags).

**Examples**

From [Connect Gemini on Vertex AI](https://docs.kindgi.com/v0.1.9/guides/models/gemini-on-vertex-ai.md):

```sh
pnpm exec kindgi providers get gemini
```

From [Models](https://docs.kindgi.com/v0.1.9/guides/models.md):

```sh
pnpm exec kindgi providers get ollama
```

**See also**

- [Connect Gemini on Vertex AI](https://docs.kindgi.com/v0.1.9/guides/models/gemini-on-vertex-ai.md)
- [Models](https://docs.kindgi.com/v0.1.9/guides/models.md)
- [`kindgi providers`](https://docs.kindgi.com/v0.1.9/reference/cli/providers.md#kindgi-providers)

### `kindgi providers register`

**Synopsis**

```sh signature
kindgi providers register (--spec=<json-or-@file> | --preset=<name> [--models=<a,b>] [--project=<…>] [--resource-name=<…>] [--deployments=<…>] [--region=<…>] [--secret=<NAME>] [--env=<name>] [--max-output-tokens=<n>])
```

Register a model provider — from a spec, or a preset (`kindgi providers presets`).

**Options**

| Option                        | Default                               | Description                                                                                                                                                                                 |
| ----------------------------- | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--deployments <value>`       | required with the azure-openai preset | For `azure-openai`: the deployment serving each model, `model=deployment,…` (e.g. `gpt-6.1-sol=gpt-6-1-sol`).                                                                               |
| `--env <value>`               | `local`                               | With `--preset`, the environment of the key's secret: default `local` (in a pack, the key must already be in its env files), or on a runtime that keeps its values under one env, that one. |
| `--max-output-tokens <value>` | the preset's own value for each model | With `--preset`, each model's output cap (thinking included), in place of the preset's: the model's own limit.                                                                              |
| `--models <value>`            | all of the preset's models            | With `--preset`, register only these of its models, comma-separated (default: all).                                                                                                         |
| `--preset <value>`            | none                                  | Register a built-in preset by name; `kindgi providers presets` lists them.                                                                                                                  |
| `--project <value>`           | required with the gemini preset       | For a preset that needs one (`gemini`), the Google Cloud project Vertex AI runs and bills in.                                                                                               |
| `--region <value>`            | required with the bedrock preset      | For `bedrock`: the AWS region Bedrock runs in (e.g. `us-east-2`).                                                                                                                           |
| `--resource-name <value>`     | required with the azure-openai preset | For `azure-openai`: the Azure OpenAI resource, as in `<name>.openai.azure.com`.                                                                                                             |
| `--secret <value>`            | the preset's own secret name          | With `--preset`, the name of the secret holding the API key, in place of the preset's own.                                                                                                  |
| `--spec <value>`              | none                                  | The registration body as JSON, or `@<file>` to read it from a file. Give `--spec` or `--preset`.                                                                                            |

Every command also takes the [global flags](https://docs.kindgi.com/v0.1.9/reference/cli.md#global-flags).

**Examples**

From [Deploy on Google Cloud Run](https://docs.kindgi.com/v0.1.9/deploy/self-hosted/cloud-run.md):

```sh
npx --yes @kindgi/cli@0.1 providers register --preset=gemini --project=<project> --models=gemini-3.8-flash --url "$URL"
```

From [Self-host Kindgi](https://docs.kindgi.com/v0.1.9/deploy/self-hosted/self-host.md):

```sh
npx --yes @kindgi/cli@0.1 providers register --spec=@ollama.json --url http://localhost:4000
```

**See also**

- [Deploy on Google Cloud Run](https://docs.kindgi.com/v0.1.9/deploy/self-hosted/cloud-run.md)
- [Self-host Kindgi](https://docs.kindgi.com/v0.1.9/deploy/self-hosted/self-host.md)
- [Connect Anthropic](https://docs.kindgi.com/v0.1.9/guides/models/anthropic.md)
- [Connect OpenAI, Gemini, Groq or OpenRouter](https://docs.kindgi.com/v0.1.9/guides/models/api-key-presets.md)
- [`kindgi providers`](https://docs.kindgi.com/v0.1.9/reference/cli/providers.md#kindgi-providers)

### `kindgi providers presets`

**Synopsis**

```sh signature
kindgi providers presets
```

List the provider presets `register --preset` takes.

**Options**

Every command also takes the [global flags](https://docs.kindgi.com/v0.1.9/reference/cli.md#global-flags).

**Examples**

From [Models](https://docs.kindgi.com/v0.1.9/guides/models.md):

```sh
pnpm exec kindgi providers presets
```

**See also**

- [Models](https://docs.kindgi.com/v0.1.9/guides/models.md)
- [`kindgi providers`](https://docs.kindgi.com/v0.1.9/reference/cli/providers.md#kindgi-providers)

### `kindgi providers unregister`

**Synopsis**

```sh signature
kindgi providers unregister <provider-id>
```

Unregister a model provider.

**Options**

Every command also takes the [global flags](https://docs.kindgi.com/v0.1.9/reference/cli.md#global-flags).

**Examples**

From [Connect Anthropic](https://docs.kindgi.com/v0.1.9/guides/models/anthropic.md):

```sh
pnpm exec kindgi providers unregister anthropic
```

From [Connect Gemini on Vertex AI](https://docs.kindgi.com/v0.1.9/guides/models/gemini-on-vertex-ai.md):

```sh
pnpm exec kindgi providers unregister gemini
```

**See also**

- [Connect Anthropic](https://docs.kindgi.com/v0.1.9/guides/models/anthropic.md)
- [Connect Gemini on Vertex AI](https://docs.kindgi.com/v0.1.9/guides/models/gemini-on-vertex-ai.md)
- [Models](https://docs.kindgi.com/v0.1.9/guides/models.md)
- [`kindgi providers`](https://docs.kindgi.com/v0.1.9/reference/cli/providers.md#kindgi-providers)
