AI Integrations

Overview

ARI supports multiple AI providers for the built-in AI Assistant and AI-powered module generation. All API keys are stored locally on your server and never shared with ARI or any third party.

Configure your AI providers in Settings > Integrations. API keys you enter through the UI are private to your account — they are not shared with other user accounts on your ARI instance.

When you add API keys in Settings > Integrations, they are stored in your database and encrypted using AES-256-GCM.

Alternatively, you can store your API keys in your .env.local file or your host's environment variables manager. This reduces risk because even if your database is ever accessed or compromised, your API keys are not included. It also limits exposure within your application, since the keys are not retrievable through the app itself.

All environment variables added to .env.local are shared with all user accounts on ARI — every user of your instance uses the same key. Keys entered through Settings > Integrations, by contrast, are private to the account that enters them.

Choose the approach that aligns best with your security preferences and environment setup.

Supported Providers

OpenAI

The default provider for the AI Assistant module and module generation.

1. Create an account at platform.openai.com
2. Navigate to API Keys and generate a new key
3. Add it in Settings > Integrations or set OPENAI_API_KEY in your environment

Anthropic (Claude)

Use Claude models for the AI Assistant.

1. Create an account at console.anthropic.com
2. Generate an API key
3. Add it in Settings > Integrations or set ANTHROPIC_API_KEY in your environment

OpenRouter

Access a wide range of AI models through a single API. OpenRouter provides access to models from multiple providers.

1. Create an account at openrouter.ai
2. Generate an API key
3. Add it in Settings > Integrations or set OPENROUTER_API_KEY in your environment

Google Gemini

Use Google's Gemini models for the AI Assistant.

1. Get an API key from Google AI Studio
2. Add it in Settings > Integrations or set GOOGLE_GEMINI_API_KEY in your environment

Security Best Practices

• Never share your API keys or commit them to version control
• Use different keys for development and production
• Rotate keys periodically
• Set usage limits and billing alerts on each provider's dashboard
• Review API usage in each provider's dashboard regularly