Skip to main content

Before you begin

Install Pi CLI, create a key on the API Keys page, and choose a model on the Models page.
1

Set your API key

Export your key:
2

Configure LithosAI

The configuration uses deepseek-ai/DeepSeek-V4.1-Flash as an example.Add to ~/.pi/agent/models.json. Keep existing providers and set the token limits to match your model.
~/.pi/agent/models.json
"thinkingFormat": "deepseek" makes --thinking off send thinking: {"type": "disabled"}. Without it, Pi sends no thinking field when thinking is off, and the model thinks at its default effort high.To add another model or tier, copy the entry in providers.lithosai.models. Set id and name to the ID from the model catalog, and adjust contextWindow and maxTokens to match the model. Reopen Pi to load the changes.
3

Start a conversation

Run the following command:

Model and reasoning effort

  • Model and tier: Use /model to switch in the current conversation.
  • Reasoning effort: Open /settings and select low, high, or max.
Issues common to every agent are listed under Common issues.

Resources