Rawi (راوي) Documentation | Configure

Configuring settings for the Rawi CLI

The Rawi Command Line Interface (Rawi CLI) uses configuration settings to determine how it interacts with AI providers and manages your sessions. These settings include:

• Credentials: Identify who is calling the API. API keys or tokens are used to authenticate your requests and determine your access permissions.
• Provider and Model: Specify which AI provider and model to use for your requests.
• Other options: Such as default profile, output format, and custom endpoints.

Note

Ensure your system’s date and time are set correctly. Some providers require signed requests with accurate timestamps.

Configuration and credentials precedence

Rawi CLI reads configuration and credentials from several locations, in the following order of precedence:

1. Command line options – Overrides all other settings. Example: --provider, --model, --api-key, --profile.
2. Environment variables – Set variables like OPENAI_API_KEY or RAWI_PROFILE in your shell.
3. Profile configuration files – Stored in ~/.rawi/credentials and ~/.rawi/config.
4. Default profile – Used if no profile is specified.

Configuration Examples

Interactive

1. Set up your credentials and default provider:

   rawi configure
   # Example prompts:
   # Provider [openai]: openai
   # Model [gpt-4o]: gpt-4o
   # API Key [None]: sk-...

2. Configure a named profile:

   rawi configure --profile work
   # Provider [openai]: openai
   # Model [gpt-4o]: gpt-4o
   # API Key [None]: sk-...

Manual (CLI)

1. Configure a profile non-interactively:

   rawi configure --provider openai --model gpt-4o --api-key sk-your-key

Environment Variables

1. Set your API key in your shell:

   export OPENAI_API_KEY=sk-your-key
   rawi ask "Hello, world!"

Switching Profiles

1. List, show, or switch between profiles:

   rawi configure --list
   rawi configure --show --profile work
   rawi configure --profile work --provider anthropic --model claude-3-sonnet-20240229

Configuration file locations

• Linux/macOS: ~/.rawi/credentials
• Windows: %USERPROFILE%\.rawi\credentials

---

For more details, see the Troubleshooting Guide or run rawi configure --help.