Download the PHP package heybardi/routersoup without Composer
On this page you can find all versions of the php package heybardi/routersoup. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download heybardi/routersoup
More information about heybardi/routersoup
Files in heybardi/routersoup
Package routersoup
Short Description Openrouter free self-hosted alternative for Laravel
License MIT
Homepage https://github.com/heybardi/routersoup
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package routersoup
RouterSoup for Laravel
Your self-hosted, free alternative to OpenRouter. Store multiple API keys per provider, rotate between them automatically, and monitor everything from a built-in dashboard.
Requires PHP 8.3+, Laravel 11+, and Laravel AI
Table of Contents
- Installation
- Usage
- Rotation Strategies
- Dashboard
- Authorization
- Pruning Old Events
- Configuration
- Development
Installation
⚡️ Get started by requiring the package using Composer:
Then run the install command — it publishes the config, migrations, and a service provider stub:
Usage
Open your AppServiceProvider and call RouterSoup::enable():
That's it. RouterSoup now intercepts all Laravel AI calls and rotates your provider keys automatically.
Head to /routersoup in your browser, add a few API keys, and you're good to go.
Rotation Strategies
RouterSoup supports two strategies for picking which API key to use:
| Strategy | Enum | What it does |
|---|---|---|
| Random | RouterSoupRotation::Random |
Picks a random active key. Simple, stateless. |
| Least Used | RouterSoupRotation::LeastUsed |
Picks the key that hasn't been used the longest. Spreads load evenly. |
Set it in config/routersoup.php:
Dashboard
Visit /routersoup (or whatever you set path to) to access the admin panel:
- Dashboard — Provider usage analytics over the last 30 days.
- Providers — Add, edit, enable/disable, and delete API keys.
- Monitoring — Browse every Laravel AI event with full payloads.
- Exceptions — Failed provider calls with error details and traces.
No frontend build step needed — it's all Livewire.
Authorization
In local environments, the dashboard is open to everyone. In production, access is controlled by a viewRouterSoup gate.
The install command publishes a RouterSoupServiceProvider where you define who gets in:
Pruning Old Events
Events pile up. Schedule the prune command to keep things clean:
By default it keeps the last 24 hours. Need more? Pass --hours:
Configuration
After installing, you'll find config/routersoup.php in your app:
Development
🧹 Keep a modern codebase with Pint:
✅ Run refactors using Rector:
⚗️ Run static analysis using PHPStan:
✅ Run unit tests using Pest:
🚀 Run the entire test suite:
License
RouterSoup was created by Bardi under the MIT license.
All versions of routersoup with dependencies
laravel/framework Version ^11.0|^12.0
laravel/ai Version *
livewire/livewire Version ^3.0|^4.0|^5.0