> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lithosai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Use LithosAI with omp

> Connect omp directly to LithosAI through the OpenAI Chat Completions API.

omp connects directly to LithosAI through its OpenAI Chat Completions transport. You do not
need a local proxy or protocol adapter.

## Before you begin

Install omp, create a key on the [API Keys](https://console.lithosai.cloud/keys) page, and
confirm the model ID and token limits on the
[Models](https://console.lithosai.cloud/models) page.

<Steps>
  <Step title="Export your LithosAI key">
    Export the key in the shell where you start omp.

    ```bash theme={null}
    export LITHOSAI_API_KEY="your-key"
    ```
  </Step>

  <Step title="Add LithosAI as a custom provider">
    Merge the following provider into `~/.omp/agent/models.yml`.

    ```yaml ~/.omp/agent/models.yml theme={null}
    providers:
      lithosai:
        baseUrl: https://api.lithosai.cloud/v1
        api: openai-completions
        apiKey: LITHOSAI_API_KEY
        models:
          - id: moonshotai/Kimi-K3
            name: Kimi K3 on LithosAI
            contextWindow: 262144
            maxTokens: 32768
    ```

    `apiKey` names the environment variable that contains the credential. Replace the model
    ID, context window, and output limit with the values shown in the LithosAI console.
  </Step>

  <Step title="Confirm and select the model">
    Confirm that omp loaded the provider, then start a session and select the model.

    ```bash theme={null}
    omp models find lithosai
    omp
    ```

    Inside the session, open the model picker and choose
    `lithosai/moonshotai/Kimi-K3`.

    <Note>
      omp evolves quickly. If `models.yml` fails validation, compare your installed version
      with the current provider schema.
    </Note>
  </Step>
</Steps>

## Verify the connection

From a project that contains a `README.md`, ask omp:

```text theme={null}
Read README.md and reply with only its first Markdown heading.
```

omp should read the local file and return its heading. This verifies both the model response
and a basic local tool call.

## Troubleshooting

| Symptom                                | Cause                                                                                                                          |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| The LithosAI model is not selectable   | `LITHOSAI_API_KEY` is unset, the provider is disabled, or `models.yml` is invalid.                                             |
| `omp models` skips the custom provider | The provider is missing `baseUrl`, `api`, `apiKey`, or a valid model entry.                                                    |
| Authentication fails                   | `apiKey` must be the environment variable **name** `LITHOSAI_API_KEY`, not the key itself, and that variable must be exported. |

Issues common to every agent are listed under [Common issues](/coding-agents#common-issues).

## Resources

* [omp provider configuration](https://github.com/can1357/oh-my-pi/blob/main/docs/providers.md)
* [omp model configuration](https://github.com/can1357/oh-my-pi/blob/main/docs/models.md)
* [LithosAI models](https://console.lithosai.cloud/models)