PHPackages underwear/llm-wrapper - 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. underwear/llm-wrapper ActiveLibrary[API Development](/categories/api) underwear/llm-wrapper ===================== A fluent PHP wrapper for LLM APIs with function calling support v2.0(1mo ago)077MITPHPPHP ^8.1 Since Jul 13Pushed 1mo agoCompare [ Source](https://github.com/underwear/llm-wrapper)[ Packagist](https://packagist.org/packages/underwear/llm-wrapper)[ Docs](https://github.com/underwear/llm-wrapper)[ RSS](/packages/underwear-llm-wrapper/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (2)Dependencies (10)Versions (5)Used By (0) LLM Wrapper =========== [](#llm-wrapper) [![PHP Version](https://camo.githubusercontent.com/04744bae0a61d2ffe29c26f07a9612eae20445fc6feaeb77b3af1f0e9be6447c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344382e312d3838393242462e737667)](https://php.net/)[![License](https://camo.githubusercontent.com/8bb50fd2278f18fc326bf71f6e88ca8f884f72f179d3e555e20ed30157190d0d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e2e737667)](LICENSE) Fluent PHP wrapper for LLM APIs. One interface for OpenAI, Anthropic Claude, and Kie.ai — with tool calling, agent loops, and response normalization. ``` $response = LlmClient::openai(['api_key' => 'sk-...']) ->chat() ->system('You are a helpful assistant.') ->user('What is the capital of France?') ->send(); echo $response->text(); // Paris ``` Why? ---- [](#why) - **One API for all providers** — switch between OpenAI, Claude, and Kie.ai by changing one line - **Fluent builder** — readable, chainable, IDE-friendly - **Tool calling** — type-safe parameter definitions with JSON Schema generation - **Agent-ready** — tool call IDs, tool results, and conversation continuations built in - **Normalized responses** — consistent `stopReason`, `usage`, and `toolCalls` across providers Installation ------------ [](#installation) ``` composer require underwear/llm-wrapper ``` Requires PHP 8.1+. Quick Start ----------- [](#quick-start) ``` use Underwear\LlmWrapper\LlmClient; // OpenAI $client = LlmClient::openai(['api_key' => 'sk-...']); // Anthropic Claude $client = LlmClient::claude(['api_key' => 'sk-ant-...']); // Kie.ai $client = LlmClient::kie(['api_key' => '...']); // Or use the generic factory $client = LlmClient::make('openai', ['api_key' => 'sk-...'], model: 'gpt-4.1-mini'); ``` Chat ---- [](#chat) ### Simple Message [](#simple-message) ``` $response = $client->chat() ->user('Who wrote "1984"?') ->send(); echo $response->text(); // George Orwell ``` ### Multi-turn Conversation [](#multi-turn-conversation) ``` $response = $client->chat() ->system('You are a helpful historian.') ->user('Who discovered penicillin?') ->assistant('Alexander Fleming discovered penicillin in 1928.') ->user('Tell me more about his discovery.') ->send(); ``` ### Model, Temperature, Max Tokens [](#model-temperature-max-tokens) ``` $response = $client->chat() ->model('gpt-4.1-mini') ->temperature(0.9) ->maxTokens(1000) ->user('Write a short poem about the sea.') ->send(); ``` Tool Calling ------------ [](#tool-calling) ### Inline Definition [](#inline-definition) ``` use Underwear\LlmWrapper\ChatBuilder\ToolChoice; $response = $client->chat() ->tool('createProfile', function ($t) { $t->stringParam('firstName')->required(); $t->stringParam('lastName')->required(); $t->intParam('age')->min(18)->max(60)->required(); }) ->toolChoice(ToolChoice::specific('createProfile')) ->send(); $profile = $response->tool('createProfile'); echo $profile->get('firstName'); // Emma echo $profile->lastName; // magic property access works too ``` ### Reusable Tools [](#reusable-tools) Define a tool once, use it in multiple chats: ``` use Underwear\LlmWrapper\ChatBuilder\ToolBuilder; $weatherTool = ToolBuilder::create('get_weather') ->description('Get current weather for a city'); $weatherTool->stringParam('city')->required(); $weatherTool->stringParam('units')->enum(['celsius', 'fahrenheit']); $london = $client->chat()->tool($weatherTool)->user('Weather in London?')->send(); $tokyo = $client->chat()->tool($weatherTool)->user('Weather in Tokyo?')->send(); ``` ### Multiple Tools [](#multiple-tools) ``` use Underwear\LlmWrapper\ChatBuilder\ToolBuilder; use Underwear\LlmWrapper\ChatBuilder\ToolChoice; use Underwear\LlmWrapper\ChatBuilder\FunctionParam; $response = $client->chat() ->system('You are an assistant that can create users and send notifications.') ->user('Create a new user John') ->tool('create_user', function (ToolBuilder $t) { $t->description('Creates a new user account'); $t->param(FunctionParam::string('username')->required()); $t->param(FunctionParam::string('email')->required()); $t->param(FunctionParam::int('age')->min(18)); }) ->tool('send_notification', function (ToolBuilder $t) { $t->description('Send a notification'); $t->param(FunctionParam::string('message')->required()); $t->param(FunctionParam::string('priority')->enum(['low', 'medium', 'high'])); }) ->toolChoice(ToolChoice::auto()) ->send(); if ($response->called('create_user')) { $args = $response->tool('create_user')->getArguments(); // ['username' => 'john', 'email' => 'john@...', 'age' => 25] } ``` ### Tool Choice Modes [](#tool-choice-modes) ``` use Underwear\LlmWrapper\ChatBuilder\ToolChoice; ->toolChoice(ToolChoice::auto()) // model decides ->toolChoice(ToolChoice::required()) // must call a tool ->toolChoice(ToolChoice::specific('tool_name')) // must call this specific tool ->toolChoice(ToolChoice::none()) // no tool calls ``` Agent Loop ---------- [](#agent-loop) The library provides primitives for building agents: tool call IDs, tool results, and conversation continuations. Models can call tools, you execute them and send results back, the model continues — until it's done. ``` $chat = $client->chat() ->system('You are a helpful assistant.') ->user('What is the weather in Paris and London?') ->tool('get_weather', function ($t) { $t->description('Get current weather for a city'); $t->stringParam('city')->required(); }) ->toolChoice(ToolChoice::auto()); $response = $chat->send(); while ($response->stopReason() === 'tool_calls') { // Add the assistant's tool-calling response to history $chat->assistantToolCalls($response->tools(), $response->text()); // Execute each tool and send results back foreach ($response->tools() as $call) { $result = executeMyTool($call->getName(), $call->getArguments()); $chat->toolResult($call->getId(), $call->getName(), $result); } // Continue the conversation $response = $chat->send(); } echo $response->text(); // "The weather in Paris is 22°C and sunny, while London is 15°C and rainy." ``` ### How It Works [](#how-it-works) 1. **`$response->tools()`** returns all tool calls with their IDs (supports parallel calls) 2. **`$chat->assistantToolCalls()`** adds the assistant's response back to the conversation 3. **`$chat->toolResult($id, $name, $content)`** sends the tool execution result (string) 4. **`$chat->send()`** continues — the model sees the results and either calls more tools or responds with text ### Filtering Tool Calls [](#filtering-tool-calls) ``` // Get all tool calls $response->tools(); // Filter by tool name (useful when model calls the same tool multiple times) $response->tools('get_weather'); // all get_weather calls // Get first match $response->tool('get_weather'); // first ToolCall or null // Check if called $response->called('get_weather'); // bool ``` Parameter Types --------------- [](#parameter-types) Build complex JSON Schema parameters with a fluent API: ``` use Underwear\LlmWrapper\ChatBuilder\FunctionParam; // Primitives FunctionParam::string('name')->required()->description('User name') FunctionParam::int('age')->min(0)->max(120) FunctionParam::float('score')->min(0.0)->max(10.0) FunctionParam::bool('active') // Enums FunctionParam::string('status')->enum(['active', 'inactive', 'pending']) // Nullable FunctionParam::string('nickname')->nullable() // Arrays FunctionParam::stringArray('tags') // shortcut for array of strings FunctionParam::intArray('scores') // shortcut for array of integers FunctionParam::array('items')->arrayOf( // custom item type FunctionParam::float('price') )->minItems(1)->maxItems(100) // Objects FunctionParam::object('address')->props([ FunctionParam::string('street')->required(), FunctionParam::string('city')->required(), FunctionParam::string('zip'), ]) // Nested structures FunctionParam::objectArray('users', [ // array of objects FunctionParam::string('name')->required(), FunctionParam::int('age'), ]) ``` Response -------- [](#response) ``` $response = $client->chat()->user('Hello')->send(); // Content $response->text(); // "Hello! How can I help you?" $response->hasText(); // true // Tool calls $response->hasToolCalls(); // true/false $response->called('name'); // was this tool called? $response->tool('name'); // first ToolCall or null $response->tools(); // all ToolCall objects $response->tools('name'); // all ToolCall objects with this name // ToolCall $call = $response->tool('get_weather'); $call->getId(); // "call_abc123" $call->getName(); // "get_weather" $call->get('city'); // "Paris" $call->get('units', 'c'); // with default value $call->city; // magic property $call->getArguments(); // ['city' => 'Paris', ...] // Metadata $response->stopReason(); // 'stop' | 'max_tokens' | 'tool_calls' | 'content_filter' $response->model(); // 'gpt-4.1-2025-04-14' $response->raw(); // raw JSON response body // Token usage $response->usage()->promptTokens(); // 14 $response->usage()->completionTokens(); // 28 $response->usage()->totalTokens(); // 42 echo $response->usage(); // "Usage: 42 tokens (prompt: 14, completion: 28)" ``` Hooks ----- [](#hooks) Register after-send callbacks for logging, metrics, or debugging: ``` $client->after(function ($chat, $response, $client) { logger()->info('LLM request', [ 'model' => $response->model(), 'tokens' => $response->usage()->totalTokens(), 'stop_reason' => $response->stopReason(), ]); }); // Register multiple at once $client->afterMany($loggerHook, $metricsHook, $costTrackerHook); ``` Supported Providers ------------------- [](#supported-providers) ProviderFactoryDefault ModelTool CallingAgent LoopOpenAI`LlmClient::openai()``gpt-4.1`parallelyesAnthropic`LlmClient::claude()``claude-sonnet-4-20250514`parallelyesKie.ai`LlmClient::kie()``gpt-5-4`singlenoAll providers use the same fluent API. Tool calls, stop reasons, and usage stats are normalized across providers. Testing ------- [](#testing) ``` composer test ``` License ------- [](#license) MIT ### Health Score 41 — FairBetter than 89% of packages Maintenance90 Actively maintained with recent releases Popularity10 Limited adoption so far Community6 Small or concentrated contributor base Maturity48 Maturing project, gaining track record 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. ### Release Activity Cadence Every ~86 days Total 4 Last Release 51d ago Major Versions v1.2 → v2.02026-03-28 ### Community Maintainers ![](https://www.gravatar.com/avatar/48b5d9ece0bfb01bcfdc274b7fd27cacd3233c9cde71a2ddd4e1d4fcdc024d9a?d=identicon)[underwear](/maintainers/underwear) --- Top Contributors [![underwear](https://avatars.githubusercontent.com/u/4825406?v=4)](https://github.com/underwear "underwear (8 commits)") --- Tags apiaiwrapperopenaiGeminiclaudellmgptChatGptantropic ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StylePHP CS Fixer Type Coverage Yes ### Embed Badge ![Health badge](/badges/underwear-llm-wrapper/health.svg) ``` [![Health](https://phpackages.com/badges/underwear-llm-wrapper/health.svg)](https://phpackages.com/packages/underwear-llm-wrapper) ``` ### Alternatives [claude-php/claude-php-sdk-laravel Laravel integration for the Claude PHP SDK - Anthropic Claude API 5010.8k](/packages/claude-php-claude-php-sdk-laravel)[sbsaga/toon 🧠 TOON for Laravel — a compact, human-readable, and token-efficient data format for AI prompts & LLM contexts. Perfect for ChatGPT, Gemini, Claude, Mistral, and OpenAI integrations (JSON ⇄ TOON). 6115.6k](/packages/sbsaga-toon)[vizra/vizra-adk Vizra Agent Development Kit - A comprehensive Laravel package for building intelligent AI agents. 29026.1k](/packages/vizra-vizra-adk) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)