Skip to main content
OpenAI API Key Required: Weam AI requires OpenAI API access for core functionality including RAG processing, document analysis, and web scraping. The application will not work properly without an OpenAI API key.

​
Model Providers

Add credentials for the models you want to use. At minimum, configure one provider to enable basic functionality. OpenAI is mandatory for Weam AI to function properly. Add credentials for additional models you want to use.
  • OpenAI (Required)
  • Anthropic (Claude)
  • Google AI (Gemini)
  • Additional Providers
Get Your API Key:
  1. Visit platform.openai.com
  2. Sign up or log in to your account
  3. Navigate to the API Keys section
  4. Create a new secret key
  5. Copy the key (you won’t see it again)
Add to Environment:
Weam AI_OPEN_AI_KEY=sk-your-openai-api-key-here
OPEN_AI_MODAL=gpt-4
OPEN_AI_API_URL=https://api.openai.com

Detailed OpenAI Setup Guide

Step-by-step OpenAI API key generation

​
External Integrations (Optional)

  • Slack
  • GitHub
  • Google Workspace
Setup OAuth Integration:
  1. Visit api.slack.com/apps
  2. Create a new app
  3. Configure OAuth settings
  4. Get Client ID and Secret
SLACK_CLIENT_ID=your-slack-client-id
SLACK_CLIENT_SECRET=your-slack-client-secret
NEXT_PUBLIC_SLACK_CLIENT_ID=your-slack-client-id
NEXT_PUBLIC_SLACK_CLIENT_SECRET=your-slack-client-secret

Detailed Slack Setup

Complete Slack integration guide

​
Service Configuration

​
Email Service (Optional)

For user notifications and account management:
EMAIL_PROVIDER=SMTP
SMTP_SERVER=smtp.gmail.com
SMTP_PORT=587
SMTP_USER=your-email@domain.com
SMTP_PASSWORD=your-app-specific-password
SUPPORT_EMAIL=support@yourdomain.com
Gmail App Password Setup:
  1. Enable 2FA on your Google account
  2. Go to App Passwords
  3. Generate an app password for Weam AI
  4. Use the generated password in SMTP_PASSWORD

​
SEO Tools (Optional)

For SEO agent functionality:
SEO_USER_ID=your-seo-tool-email
SEO_PASSWORD=your-seo-tool-password
Setup:
  1. Visit DataForSEO
  2. Create account
  3. Go to Dashboard → API Credentials
  4. Get your credentials

​
Minimum Configuration

For basic functionality, you only need:
  • One model provider (OpenAI recommended)
  • Database credentials (usually auto-configured)
  • Security keys for JWT tokens (auto-generated)
Additional providers and integrations can be added later without downtime.

​
Generate Security Keys

If you need to generate security keys for JWT and encryption:Using OpenSSL (Recommended):
# Generate all required keys
openssl rand -hex 64  # For JWT_SECRET
openssl rand -hex 64  # For JWT_REFRESH_SECRET
openssl rand -hex 16  # For SECURITY_KEY
openssl rand -hex 32  # For CSRF_TOKEN_SECRET
Using Node.js:
node -e "console.log('JWT_SECRET =', require('crypto').randomBytes(64).toString('hex'))"
node -e "console.log('JWT_REFRESH_SECRET =', require('crypto').randomBytes(64).toString('hex'))"
node -e "console.log('SECURITY_KEY =', require('crypto').randomBytes(16).toString('hex'))"
node -e "console.log('CSRF_TOKEN_SECRET =', require('crypto').randomBytes(32).toString('hex'))"
Online Generators:

​
Next Steps

Launch & Verify

Start services and test your configuration
⌘I