PHPackages hardiksolanki/openai-laravel - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. hardiksolanki/openai-laravel ActiveLibrary[API Development](/categories/api) hardiksolanki/openai-laravel ============================ Production-ready Laravel package for OpenAI API integration with database persistence, multi-tenancy, and team management. 00PHP Since Jul 10Pushed 1mo agoCompare [ Source](https://github.com/hardiksolanki90/openai-laravel)[ Packagist](https://packagist.org/packages/hardiksolanki/openai-laravel)[ RSS](/packages/hardiksolanki-openai-laravel/feed)WikiDiscussions main Synced 1w ago READMEChangelog (1)DependenciesVersions (1)Used By (0) OpenAI Laravel ============== [](#openai-laravel) Production-ready Laravel package for OpenAI API integration with database persistence, multi-tenancy, and team management. `hardiksolanki/openai-laravel` wraps OpenAI's Chat Completions and Image Generation APIs behind a fluent builder/facade, backed by Eloquent models for conversations, teams, usage logs, budgets, prompt templates, and API keys. It adds the concerns a real SaaS product needs on top of a bare API client: multi-tenancy, RBAC, rate limiting, cost tracking with budget enforcement, prompt caching, context window optimization, and streaming. Features -------- [](#features) - **Fluent builder API** — `OpenAI::text()->prompt(...)->team($id)->generate()` - **Database-backed conversations** with full message history, per-team isolation - **Multi-tenancy & RBAC** — admin / member / viewer roles via `spatie/laravel-permission` (team-scoped) - **Usage tracking & cost calculation** — per-request token/cost logging, team and per-user breakdowns - **Budget limits** — monthly caps with warning thresholds and optional hard blocking - **Rate limiting** — in-memory token bucket, persisted for restart recovery - **Prompt templates** — reusable prompts with `{{ variable }}` interpolation - **Context window optimization** — automatic truncation of oldest messages to fit the model's context window - **Prompt caching** — SHA-256 query hashing with TTL, avoids duplicate API calls - **Streaming** — SSE-style streamed responses with post-completion usage logging - **REST API** — full set of endpoints for conversations, templates, usage, API keys, budgets, and teams - **Artisan commands** — key management, usage reports, budget checks, cache/context/rate-limit maintenance - **Encrypted API keys** — multiple OpenAI keys per team, encrypted with Laravel's `Crypt` facade Requirements ------------ [](#requirements) - PHP 8.1+ - Laravel 10.0+ or 11.0+ - MySQL or PostgreSQL Installation ------------ [](#installation) This package is not yet published on Packagist. Install it via a local path repository: ``` { "repositories": [ { "type": "path", "url": "../laravel-openAI" } ] } ``` ``` composer require hardiksolanki/openai-laravel:@dev ``` Laravel's package auto-discovery picks up the service provider and `OpenAI` facade automatically from `composer.json`'s `extra.laravel` block — no manual registration needed. Publish the config and migrations: ``` php artisan vendor:publish --tag=openai-config php artisan vendor:publish --tag=openai-migrations php artisan migrate ``` Add your OpenAI key and tune defaults in `.env`: ``` OPENAI_API_KEY=sk-... OPENAI_DEFAULT_MODEL=gpt-4 OPENAI_RATE_LIMITING_ENABLED=true OPENAI_MAX_REQUESTS_PER_HOUR=100 OPENAI_CACHE_ENABLED=true OPENAI_CACHE_TTL=3600 OPENAI_LOG_REQUESTS=false ``` RBAC is enforced through `spatie/laravel-permission` in **team-scoped mode**. Your application's `User` model must use the `Spatie\Permission\Traits\HasRoles` trait: ``` use Spatie\Permission\Traits\HasRoles; class User extends Authenticatable { use HasRoles; } ``` Quick start ----------- [](#quick-start) ``` use HardikSolanki\OpenAILaravel\Facades\OpenAI; $response = OpenAI::text() ->prompt('Write a blog post about Laravel') ->model('gpt-4') ->temperature(0.7) ->tokens(2000) ->team($teamId) ->user($userId) ->generate(); echo $response->content(); echo $response->tokensUsed(); echo $response->costIncurred(); ``` ### Chat with history [](#chat-with-history) ``` $response = OpenAI::text() ->systemPrompt('You are a helpful coding assistant.') ->history([ ['role' => 'user', 'content' => 'What is Laravel?'], ['role' => 'assistant', 'content' => 'Laravel is a PHP framework...'], ]) ->prompt('Tell me about Eloquent.') ->team($teamId) ->user($userId) ->generate(); ``` ### Save to a conversation [](#save-to-a-conversation) ``` use HardikSolanki\OpenAILaravel\Services\ConversationService; $conversation = app(ConversationService::class)->create($teamId, $userId, 'Coding Help'); OpenAI::text() ->prompt('How do I use migrations?') ->saveToConversation($conversation->id) ->team($teamId) ->user($userId) ->generate(); ``` ### Prompt templates [](#prompt-templates) ``` use HardikSolanki\OpenAILaravel\Models\PromptTemplate; use HardikSolanki\OpenAILaravel\Services\PromptTemplateService; $template = PromptTemplate::findBySlug('product-review', $teamId); $service = app(PromptTemplateService::class); $content = $service->interpolate($template, ['product_name' => 'MacBook Pro']); OpenAI::text()->prompt($content)->team($teamId)->user($userId)->generate(); ``` ### Streaming [](#streaming) ``` foreach (OpenAI::text()->prompt('Write a story...')->team($teamId)->user($userId)->streamGenerate() as $chunk) { echo $chunk->content(); } ``` ### Image generation [](#image-generation) ``` $images = OpenAI::image() ->prompt('A serene landscape at sunset') ->size('1024x1024') ->quality('hd') ->count(2) ->team($teamId) ->generate(); foreach ($images as $image) { echo $image->url; } ``` ### Handling limits [](#handling-limits) ``` use HardikSolanki\OpenAILaravel\Exceptions\BudgetExceededException; use HardikSolanki\OpenAILaravel\Exceptions\RateLimitExceededException; try { $response = OpenAI::text()->prompt('...')->team($teamId)->user($userId)->generate(); } catch (BudgetExceededException $e) { // $e->remainingBudget() } catch (RateLimitExceededException $e) { // $e->resetInSeconds() } ``` REST API -------- [](#rest-api) The package registers routes under `/api/openai/*`, guarded by authentication, team access, rate limit, and budget middleware: MethodEndpointDescriptionGET/POST`/api/openai/conversations`List / create conversationsGET/PUT/DELETE`/api/openai/conversations/{id}`Show / update / archivePOST`/api/openai/conversations/{id}/messages`Send a message, get a responsePOST`/api/openai/conversations/{id}/stream`Streamed response (SSE)GET/POST`/api/openai/templates`List / create prompt templatesPOST`/api/openai/templates/{id}/use`Interpolate and run a templateGET`/api/openai/usage/summary`Team usage summaryGET`/api/openai/usage/daily`Daily usage breakdownGET`/api/openai/usage/user/{userId}`Per-user usageGET/POST/DELETE`/api/openai/api-keys`Manage team API keysGET/PUT`/api/openai/budget`View / update budget limitsGET/POST/PUT/DELETE`/api/openai/teams/{id}/members`Team member managementArtisan commands ---------------- [](#artisan-commands) ``` php artisan openai:keys:create php artisan openai:keys:list php artisan openai:keys:revoke {keyId} php artisan openai:keys:test {keyId} php artisan openai:usage:report --team={teamId} --month=07 --format=json php artisan openai:usage:by-model --team={teamId} php artisan openai:usage:by-user --team={teamId} php artisan openai:budget:check php artisan openai:budget:reset --team={teamId} php artisan openai:budget:notify php artisan openai:cache:cleanup php artisan openai:context:optimize --team={teamId} php artisan openai:rate-limit:reset ``` Configuration ------------- [](#configuration) See [`config/openai.php`](config/openai.php) for the full set of options: default model, per-model pricing/context windows, rate limiting, caching, context optimization, logging, and RBAC role/permission mappings. Testing ------- [](#testing) ``` composer install vendor/bin/phpunit ``` Tests run against an in-memory SQLite database via Orchestra Testbench. Demo app -------- [](#demo-app) A Blade-based multi-tenant SaaS demo (dashboard, conversations, templates, settings, usage reports) is provided as an overlay in [`demo-app/`](demo-app/README.md), meant to be applied on top of a fresh Laravel + Breeze install. See its README for setup. License ------- [](#license) MIT ### Health Score 19 — LowBetter than 9% of packages Maintenance60 Regular maintenance activity Popularity0 Limited adoption so far Community6 Small or concentrated contributor base Maturity11 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://www.gravatar.com/avatar/588c3bbe58e0da7d7c1ff7b464061cece1631ce4278d09e2bc4658cb4b82d2b6?d=identicon)[hardiksolanki](/maintainers/hardiksolanki) --- Top Contributors [![hardiksolanki90](https://avatars.githubusercontent.com/u/30067260?v=4)](https://github.com/hardiksolanki90 "hardiksolanki90 (3 commits)") ### Embed Badge ![Health badge](/badges/hardiksolanki-openai-laravel/health.svg) ``` [![Health](https://phpackages.com/badges/hardiksolanki-openai-laravel/health.svg)](https://phpackages.com/packages/hardiksolanki-openai-laravel) ``` ### Alternatives [exsyst/swagger A php library to manipulate Swagger specifications 35816.5M7](/packages/exsyst-swagger)[lucasdotvin/laravel-soulbscription A straightforward interface to handle subscriptions and features consumption. 709209.3k](/packages/lucasdotvin-laravel-soulbscription)[pimax/fb-messenger-php Facebook Messenger Bot PHP API 313188.5k2](/packages/pimax-fb-messenger-php)[commercetools/commercetools-api-reference 6520.5k3](/packages/commercetools-commercetools-api-reference) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)