Skip to main content

🤖 Universal AI Model Updater

Keep your AI provider plugins up-to-date with the latest available models automatically.

Overview​

The Universal AI Model Updater (scripts/update-all-models.sh) is a convenience script that automatically updates your plugin configurations with the latest available models from each AI provider's API.

Key Features:

  • 🔍 Smart Detection - Automatically detects which API keys are configured
  • 🔄 Selective Updates - Only updates providers with valid API keys
  • 🎨 Visual Feedback - Color-coded output with clear status indicators
  • 📊 Summary Report - Shows updated plugin files and their sizes
  • ⚠️ Safe Execution - Skips providers without API keys rather than failing

Quick Start​

# From your Libre WebUI root directory
./scripts/update-all-models.sh

Prerequisites​

Required API Keys​

Set your API keys as environment variables:

export OPENAI_API_KEY="your_openai_key_here"
export ANTHROPIC_API_KEY="your_anthropic_key_here"
export GROQ_API_KEY="your_groq_key_here"
export GEMINI_API_KEY="your_gemini_key_here"
export MISTRAL_API_KEY="your_mistral_key_here"
export GITHUB_API_KEY="your_github_token_here"

💡 Pro Tip: Add these to your shell profile (.bashrc, .zshrc, etc.) to persist them across sessions.

Alternative: .env File​

You can also set these in your backend .env file:

# backend/.env
OPENAI_API_KEY=your_openai_key_here
ANTHROPIC_API_KEY=your_anthropic_key_here
GROQ_API_KEY=your_groq_key_here
GEMINI_API_KEY=your_gemini_key_here
MISTRAL_API_KEY=your_mistral_key_here
GITHUB_API_KEY=your_github_token_here

How It Works​

1. API Key Detection​

The script first checks which API keys are available:

📋 Checking API keys...
✅ OpenAI: API key found
✅ Anthropic: API key found
✅ Groq: API key found
✅ Gemini: API key found
✅ Mistral: API key found
✅ GitHub Models: API key found

2. Provider Updates​

For each provider with a valid API key, the script:

  • Calls the provider's API to get available models
  • Updates the corresponding JSON plugin file
  • Reports success or failure
🔄 Updating OpenAI models...
✅ OpenAI: Successfully updated (67 models)

🔄 Updating Anthropic models...
✅ Anthropic: Successfully updated (13 models)

🔄 Updating Groq models...
✅ Groq: Successfully updated (14 models)

🔄 Updating Gemini models...
✅ Gemini: Successfully updated (45 models)

🔄 Updating Mistral models...
✅ Mistral: Successfully updated (48 models)

🔄 Updating GitHub Models...
✅ GitHub Models: Successfully updated (20 models)

3. Summary Report​

After completion, you'll see:

🎉 Update process completed!

📁 Updated plugin files:
   plugins/openai.json (2.8K bytes, Jul 9 17:30)
   plugins/anthropic.json (2.1K bytes, Jul 9 17:30)
   plugins/groq.json (1.2K bytes, Jul 9 17:30)
   plugins/gemini.json (3.1K bytes, Jul 9 17:30)
   plugins/mistral.json (2.9K bytes, Jul 9 17:30)
   plugins/github.json (1.5K bytes, Jul 9 17:30)

📊 Total models: 207 across 6 providers

Provider-Specific Behavior​

OpenAI​

  • ✅ Auto-updates - Fetches latest models via API
  • 🎯 Comprehensive - Includes all available models including o3, o4 series (67 models)
  • 🔄 Regular Updates - OpenAI frequently adds new models
  • 🚀 Latest Technology - o3, o3-mini, o4, o4-mini with advanced reasoning

Anthropic (Claude)​

  • ✅ Auto-updates - Fetches latest models via API with manual curation
  • 🎯 Focused - Includes production-ready models including Claude 4 series (13 models)
  • 📈 Cutting-edge - Latest Claude 4 Sonnet, Claude 4 Opus, and Claude 3.7 Sonnet

Groq​

  • ✅ Auto-updates - Fetches latest models via API
  • ⚡ High Performance - Optimized for speed (14 models)
  • 🚀 Fast Inference - Excellent for real-time applications

Google Gemini​

  • ✅ Auto-updates - Fetches latest models via API
  • 🧠 Advanced - Multimodal capabilities (45 models)
  • 🔬 Research-focused - Cutting-edge AI technology

Mistral​

  • ✅ Auto-updates - Fetches latest models via API
  • 🇪🇺 European - Privacy-focused European provider (48 models)
  • 🎯 Specialized - Strong in coding and reasoning

GitHub Models​

  • ✅ Auto-updates - Fetches latest models via API
  • 🐙 Developer-friendly - Integrated with GitHub ecosystem (20 models)
  • 🔓 Open Source - Focus on open-source models

Troubleshooting​

Common Issues​

"API key not set" Warning​

⚠️  OpenAI: API key not set (OPENAI_API_KEY)

Solution: Set your environment variable:

export OPENAI_API_KEY="your_key_here"

"Update failed" Error​

❌ OpenAI: Update failed

Possible causes:

  • Invalid API key
  • Network connectivity issues
  • API rate limiting
  • Expired API key

Debug steps:

  1. Verify your API key is correct
  2. Test API access manually: 
    curl -H "Authorization: Bearer $OPENAI_API_KEY" \
         https://api.openai.com/v1/models
  3. Check network connectivity
  4. Verify API key permissions

"Update script not found" Error​

❌ OpenAI: Update script not found (scripts/update-openai-models.sh)

Solution: Currently, individual provider scripts are integrated into the main updater. This error indicates an internal issue - please report it.

Individual Provider Scripts​

You can also update providers individually:

# Update individual providers
./scripts/update-openai-models.sh      # OpenAI GPT models (67 models)
./scripts/update-anthropic-models.sh   # Anthropic Claude models (13 models)
./scripts/update-groq-models.sh        # Groq models (14 models)
./scripts/update-gemini-models.sh      # Google Gemini models (45 models)
./scripts/update-mistral-models.sh     # Mistral models (48 models)
./scripts/update-github-models.sh      # GitHub Models (20 models)

Each script requires its respective API key to be set as an environment variable.

Best Practices​

When to Run​

  • After initial setup - Get the latest models for your configured providers
  • Weekly/Monthly - Stay current with new model releases
  • Before important projects - Ensure access to the latest capabilities
  • After provider announcements - When providers announce new models

Automation​

You can automate updates with cron:

# Update models every Sunday at 2 AM
0 2 * * 0 /path/to/libre-webui/scripts/update-all-models.sh

Version Control​

The script updates plugins/*.json files. Consider:

  • Committing changes - Track model updates in your repository
  • Reviewing updates - Check what models were added/removed
  • Backing up - Keep backups of working configurations

Technical Details​

Plugin File Structure​

Each provider plugin (plugins/[provider].json) contains:

{
  "id": "openai",
  "name": "OpenAI GPT",
  "type": "completion",
  "endpoint": "https://api.openai.com/v1/chat/completions",
  "auth": {
    "header": "Authorization",
    "prefix": "Bearer ",
    "key_env": "OPENAI_API_KEY"
  },
  "model_map": [
    "gpt-4o",
    "gpt-4",
    "gpt-3.5-turbo",
    // ... more models
  ]
}

The updater specifically refreshes the model_map array.

Script Internals​

The updater script:

  1. Uses color-coded output for readability
  2. Checks environment variables for API keys
  3. Calls provider-specific update functions
  4. Provides detailed success/failure reporting
  5. Shows file modification timestamps

Need help? Check our Troubleshooting Guide or open an issue on GitHub.