https://github.com/soderlind/ai-router
Route AI requests to different provider configurations based on capability. Configure multiple instances of the same AI provider (e.g., GPT-4o for text, gpt-image-1 for images) and let AI Router automatically select the right one.
https://github.com/soderlind/ai-router
Last synced: about 1 month ago
JSON representation
Route AI requests to different provider configurations based on capability. Configure multiple instances of the same AI provider (e.g., GPT-4o for text, gpt-image-1 for images) and let AI Router automatically select the right one.
- Host: GitHub
- URL: https://github.com/soderlind/ai-router
- Owner: soderlind
- Created: 2026-03-26T19:49:37.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-03-27T01:15:50.000Z (2 months ago)
- Last Synced: 2026-03-27T08:23:24.884Z (2 months ago)
- Language: PHP
- Homepage:
- Size: 2.03 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# AI Router
[](https://wordpress.org/)
[](https://php.net/)
[](https://www.gnu.org/licenses/gpl-2.0.html)
**Capability-based AI provider routing for WordPress 7.0**
> Works with WordPress 7.0-RC2, tested using WordPress [AI](https://wordpress.org/plugins/ai/). Tested text generation and image generation, using two separate [Azure OpenAI](https://github.com/soderlind/ai-provider-for-azure-openai) deployments (gpt-4.1 for text, gpt-image-1 for images).
Route AI requests to different provider configurations based on capability. Configure multiple instances of the same AI provider (e.g., GPT-4o for text, gpt-image-1 for images) and let AI Router automatically select the right one.
## Why AI Router?
WordPress 7.0's AI Client SDK only allows one configuration per provider type. AI Router solves this by enabling:
- **Multiple configurations** of the same provider (e.g., separate Azure OpenAI deployments)
- **Capability-based routing** — text generation to GPT-4, images to DALL-E
- **Default fallback** — set a default for unmatched capabilities
- **Automatic selection** — no code changes needed in plugins using the AI SDK
## Supported Providers
- OpenAI
- Azure OpenAI
- Anthropic
- Ollama
## Supported Capabilities
| Capability | Description |
|------------|-------------|
| `text_generation` | GPT models, Claude, etc. |
| `chat_history` | Conversation context |
| `image_generation` | DALL-E, Stable Diffusion |
| `embedding_generation` | Vector embeddings |
| `text_to_speech` | Audio synthesis |
| `speech_generation` | Voice generation |
| `music_generation` | Music synthesis |
| `video_generation` | Video synthesis |
## Requirements
- WordPress 7.0+
- PHP 8.3+
- Underlying AI provider plugin(s) installed (e.g., `ai-provider-for-openai`)
## Installation
### From GitHub Release
1. Download `ai-router.zip` from [Releases](https://github.com/soderlind/ai-router/releases)
2. Upload via **Plugins → Add New → Upload Plugin**
3. Activate the plugin
### From Source
```bash
cd wp-content/plugins
git clone https://github.com/soderlind/ai-router.git
cd ai-router
composer install --no-dev
npm install && npm run build
```
### Automatic Updates
The plugin includes a GitHub updater — updates are delivered automatically when new releases are published.
## Configuration
1. Go to **Settings → Connectors** in WordPress admin
2. In the AI Router section, click **Add Configuration**
3. Select a provider and configure its settings (API key, model, endpoint)
4. Assign capabilities to the configuration
5. Optionally set one configuration as default
### Capability Mapping
Map specific capabilities to specific configurations:
```
text_generation → GPT-4 Config
image_generation → DALL-E Config
chat_history → GPT-4 Config
```
Unmapped capabilities fall back to the default configuration.
## How It Works
```
Plugin/Theme → AI Request (text_generation)
↓
AI Router
↓
┌─────────────────────┐
│ 1. Explicit mapping │ → Use mapped config
│ 2. Default supports │ → Use default config
│ 3. Any supporting │ → Use first match
│ 4. None found │ → Use WP default
└─────────────────────┘
↓
AI Provider (OpenAI, Azure, etc.)
```
See [docs/architecture.md](docs/architecture.md) for detailed routing logic.
## Development
### Build Assets
```bash
npm install
npm run build # Production build
npm run start # Watch mode
```
### Run Tests
```bash
# PHP tests (PHPUnit + Brain Monkey)
composer install
composer test
# JavaScript tests (Vitest)
npm run test:js
npm run test:js:watch
```
### Project Structure
```
ai-router/
├── src/
│ ├── Admin/ # Connectors page integration
│ ├── DTO/ # Configuration data object
│ ├── Repository/ # Configuration CRUD
│ ├── Rest/ # REST API controller
│ ├── js/ # React admin UI
│ ├── CapabilityMap.php # Capability → Config mapping
│ ├── Router.php # Core routing logic
│ └── ProviderDiscovery.php
├── tests/
│ ├── php/ # PHPUnit tests
│ └── js/ # Vitest tests
└── docs/
└── architecture.md # Architecture documentation
```
## REST API
| Endpoint | Method | Description |
|----------|--------|-------------|
| `/ai-router/v1/configurations` | GET | List all configurations |
| `/ai-router/v1/configurations` | POST | Create configuration |
| `/ai-router/v1/configurations/{id}` | GET | Get single configuration |
| `/ai-router/v1/configurations/{id}` | PUT | Update configuration |
| `/ai-router/v1/configurations/{id}` | DELETE | Delete configuration |
| `/ai-router/v1/capability-map` | GET | Get capability mappings |
| `/ai-router/v1/capability-map` | POST | Update capability mappings |
## Changelog
See [CHANGELOG.md](CHANGELOG.md) for version history.
## License
GPL-2.0-or-later — see [LICENSE](LICENSE) for details.
## Author
[Per Søderlind](https://soderlind.no)