PHPackages lingoda/ai-bundle - 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. [Framework](/categories/framework) 4. / 5. lingoda/ai-bundle ActiveSymfony-bundle[Framework](/categories/framework) lingoda/ai-bundle ================= Symfony Bundle for Lingoda AI PHP SDK with full framework integration 1.3.0(1mo ago)112.7k↓30.7%1MITPHPPHP ^8.3CI passing Since Aug 27Pushed 1mo agoCompare [ Source](https://github.com/lingoda/ai-bundle)[ Packagist](https://packagist.org/packages/lingoda/ai-bundle)[ RSS](/packages/lingoda-ai-bundle/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (5)Dependencies (36)Versions (7)Used By (1) Lingoda AI Bundle ================= [](#lingoda-ai-bundle) Symfony bundle for the [Lingoda AI SDK](https://github.com/lingoda/ai-sdk), providing seamless integration with Symfony's dependency injection container and configuration system. Features -------- [](#features) - **🎯 Dual Platform Architecture**: Multi-provider Platform for flexibility + Single-provider platforms for simplicity - **🔌 Smart Autowiring**: Named parameter injection (`Platform $openaiPlatform`) - **⚡ Simple ask() Method**: `$platform->ask('question')` for minimal code - **🛡️ Data Sanitization**: Built-in protection for sensitive information (inherited from AI SDK) - **🚦 Enhanced Rate Limiting**: Built-in Symfony-managed rate limiting (enabled by default) - **🎭 Full AI SDK Power**: Complete access to all AI SDK capabilities and models - **📦 Simple Setup**: Straightforward configuration with environment variables - **🔧 Full Symfony Integration**: DI container, configuration, logging, console commands Installation ------------ [](#installation) ``` composer require lingoda/ai-bundle ``` Quick Start ----------- [](#quick-start) ### 1. Installation [](#1-installation) ``` composer require lingoda/ai-bundle ``` ### 2. Configuration [](#2-configuration) Create `config/packages/lingoda_ai.yaml` and add your API keys to `.env`: **Step 1: Add API keys to `.env`** ``` OPENAI_API_KEY=sk-your-openai-key ANTHROPIC_API_KEY=sk-ant-your-anthropic-key GEMINI_API_KEY=your-gemini-key ``` **Step 2: Create configuration file** Create `config/packages/lingoda_ai.yaml`: ``` lingoda_ai: default_provider: openai # Used when ask() called without model parameter providers: openai: api_key: '%env(OPENAI_API_KEY)%' default_model: 'gpt-4o-2024-11-20' # Override default model # Optional: Custom HTTP client with retry logic, timeouts, etc. # http_client: 'openai.http_client' # timeout: 30 # Request timeout (only used if no custom http_client) anthropic: api_key: '%env(ANTHROPIC_API_KEY)%' default_model: 'claude-3-5-sonnet-20241022' # Optional: Custom HTTP client for Anthropic requests # http_client: 'anthropic.http_client' # timeout: 30 gemini: api_key: '%env(GEMINI_API_KEY)%' default_model: 'gemini-2.0-pro' # Optional: Custom HTTP client for Gemini requests # http_client: 'gemini.http_client' # timeout: 30 sanitization: enabled: true # Auto-sanitize sensitive data patterns: [] # Custom sanitization patterns logging: enabled: true service: 'monolog.logger' # Logger service ID ``` ### 3. Usage [](#3-usage) The bundle provides two usage patterns: Usage Patterns -------------- [](#usage-patterns) ### Pattern 1: Multi-Provider Platform (Flexible) [](#pattern-1-multi-provider-platform-flexible) Use when you need access to multiple AI providers in the same service: ``` use Lingoda\AiSdk\Platform; use Lingoda\AiSdk\PlatformInterface; class MyService { public function __construct( private Platform $platform, // AI SDK Platform with ALL configured providers // OR use the interface: // private PlatformInterface $platform ) {} public function compareModels(string $prompt): array { return [ 'openai' => $this->platform->ask($prompt, 'gpt-4o-mini')->getContent(), 'anthropic' => $this->platform->ask($prompt, 'claude-3-5-haiku-20241022')->getContent(), 'gemini' => $this->platform->ask($prompt, 'gemini-2.5-flash-002')->getContent(), ]; } public function useDefaultProvider(string $prompt): string { // Uses your configured default_provider return $this->platform->ask($prompt)->getContent(); } } ``` ### Pattern 2: Single-Provider Platforms (Simple) [](#pattern-2-single-provider-platforms-simple) Use when you want dedicated platforms for specific providers: ``` use Lingoda\AiBundle\Platform\ProviderPlatform; use Lingoda\AiSdk\PlatformInterface; class MyService { public function __construct( // Named parameter autowiring - the bundle automatically wires the right provider: private ProviderPlatform $openaiPlatform, // Only OpenAI models private ProviderPlatform $anthropicPlatform, // Only Anthropic models private PlatformInterface $geminiPlatform, // Interface alias also works ) {} public function generateWithOpenAI(string $prompt): string { // Only has access to OpenAI models return $this->openaiPlatform->ask($prompt)->getContent(); } public function generateWithAnthropic(string $prompt): string { // Only has access to Anthropic models return $this->anthropicPlatform->ask($prompt)->getContent(); } public function generateWithGemini(string $prompt): string { // Only has access to Gemini models return $this->geminiPlatform->ask($prompt)->getContent(); } } ``` ### Advanced AI SDK Features [](#advanced-ai-sdk-features) All [AI SDK features](https://github.com/lingoda/ai-sdk#-usage-patterns) work seamlessly: ``` use Lingoda\AiSdk\Prompt\UserPrompt; use Lingoda\AiSdk\Prompt\Conversation; use Lingoda\AiSdk\Prompt\SystemPrompt; class AdvancedService { public function __construct( private Platform $platform ) {} public function parameterizedPrompts(): string { $template = UserPrompt::create('Hello {{name}}, explain {{topic}} in simple terms'); $prompt = $template->withParameters([ 'name' => 'Alice', 'topic' => 'machine learning' ]); return $this->platform->ask($prompt)->getContent(); } public function conversations(): string { $conversation = Conversation::withSystem( SystemPrompt::create('You are a helpful coding assistant'), UserPrompt::create('How do I implement dependency injection?') ); return $this->platform->ask($conversation)->getContent(); } public function audioFeatures(): void { // Text-to-Speech (requires OpenAI) $audioResult = $this->platform->textToSpeech('Hello world'); file_put_contents('speech.mp3', $audioResult->getContent()); // Speech-to-Text (requires OpenAI) $transcription = $this->platform->transcribeAudio('audio.mp3'); echo $transcription->getContent(); } } ``` Rate Limiting ------------- [](#rate-limiting) The bundle provides enhanced rate limiting that integrates with Symfony's rate limiter component (enabled by default): ### Enhanced Rate Limiting (Enabled by Default) [](#enhanced-rate-limiting-enabled-by-default) The Bundle enables enhanced rate limiting by default with sensible provider defaults: ``` lingoda_ai: providers: openai: api_key: '%env(OPENAI_API_KEY)%' # Enhanced rate limiting is enabled by default rate_limiting: enabled: true # Default - can be disabled if needed ``` ### Custom Rate Limits (Optional) [](#custom-rate-limits-optional) Configure custom limits per provider when needed: ``` framework: cache: pools: rate_limiter_pool: adapter: cache.adapter.redis lingoda_ai: providers: openai: api_key: '%env(OPENAI_API_KEY)%' rate_limiting: enabled: true # Enable enhanced rate limiting storage: 'rate_limiter_pool' # Use Redis for e.g. for shared state providers: openai: requests: limit: 180 # Requests per minute rate: interval: '1 minute' amount: 180 tokens: limit: 450000 # Tokens per minute rate: interval: '1 minute' amount: 450000 ``` **Benefits of Enhanced Rate Limiting (Default):** - **Shared State**: Multiple app instances share rate limits via Redis - **Provider Defaults**: Sensible rate limits for each provider out of the box - **Environment-Specific**: Different limits for dev/staging/prod - **Monitoring**: Integration with Symfony profiler for debugging - **Custom Limits**: Override with provider-specific limits based on your API quotas **When to Keep Enabled (Default):** - ✅ Most production applications (recommended default) - ✅ Multi-instance deployments (load balanced apps) - ✅ Applications needing predictable rate limiting behavior **When to Disable:** - ❌ Local development with unlimited API quotas - ❌ Testing environments where you want to bypass limits See [Rate Limiting Documentation](docs/rate-limiting.md) for complete configuration options. Advanced Configuration ---------------------- [](#advanced-configuration) ### Custom HTTP Clients [](#custom-http-clients) You can configure custom HTTP clients per provider for advanced retry logic, timeouts, and request customization: ``` # config/packages/framework.yaml framework: http_client: scoped_clients: openai.http_client: base_uri: 'https://api.openai.com' timeout: 60 retry_failed: max_retries: 3 delay: 1000 multiplier: 2 http_codes: 0: ['GET', 'POST'] # Network errors 429: true # Rate limits 500: ['GET', 'POST'] # Server errors headers: 'User-Agent': 'MyApp/1.0' anthropic.http_client: base_uri: 'https://api.anthropic.com' timeout: 45 retry_failed: max_retries: 2 delay: 500 ``` ``` # config/packages/lingoda_ai.yaml lingoda_ai: providers: openai: api_key: '%env(OPENAI_API_KEY)%' http_client: 'openai.http_client' # Use custom client anthropic: api_key: '%env(ANTHROPIC_API_KEY)%' http_client: 'anthropic.http_client' # Use custom client ``` This gives you full control over: - **Retry strategies** for handling rate limits and network errors - **Custom timeouts** per provider based on your needs - **Request/response headers** for debugging and user-agent identification - **Base URIs** if using proxy servers or custom endpoints Console Commands ---------------- [](#console-commands) The bundle provides helpful console commands: ``` # List all configured AI providers and their status php bin/console ai:list:providers # List available models for each provider php bin/console ai:list:models # List models for a specific provider php bin/console ai:list:models --provider=openai # Detailed model information with availability status php bin/console ai:list:models --detailed # Test connections to all configured providers php bin/console ai:test:connection # Test rate limiting configuration (verify limits are enforced) php bin/console ai:test:rate-limiting # Test rate limiting with custom request count php bin/console ai:test:rate-limiting --requests=10 ``` Development ----------- [](#development) ### Code Quality [](#code-quality) ``` # Install dependencies composer install # Run code style check vendor/bin/ecs check # Fix code style vendor/bin/ecs check --fix # Run static analysis vendor/bin/phpstan analyse # Run tests vendor/bin/phpunit ``` ### Requirements [](#requirements) - PHP ^8.3 - Symfony ^6.4|^7.0 - lingoda/ai-sdk Available Services ------------------ [](#available-services) The bundle automatically registers these services based on your configured API keys: ### Multi-Provider Services [](#multi-provider-services) - `lingoda_ai.platform` - Main Platform service with all configured providers - `Lingoda\AiSdk\Platform` - Alias to the main Platform service - `Lingoda\AiSdk\PlatformInterface` - Interface alias to the main Platform service ### Single-Provider Services [](#single-provider-services) - `openaiPlatform` - OpenAI-only platform (if `OPENAI_API_KEY` configured) - `anthropicPlatform` - Anthropic-only platform (if `ANTHROPIC_API_KEY` configured) - `geminiPlatform` - Gemini-only platform (if `GEMINI_API_KEY` configured) ### Autowiring Support [](#autowiring-support) ``` // These all work automatically: private Platform $platform; // Multi-provider private PlatformInterface $platform; // Multi-provider (interface) private ProviderPlatform $openaiPlatform; // OpenAI only private PlatformInterface $anthropicPlatform; // Anthropic only (interface) private ProviderPlatform $geminiPlatform; // Gemini only ``` Architecture Benefits --------------------- [](#architecture-benefits) - **🎯 Dual Architecture**: Choose multi-provider flexibility OR single-provider simplicity - **📦 Simple Setup**: Straightforward configuration with environment variables - **🔌 Smart Autowiring**: Named parameter injection automatically wires correct providers - **⚡ Full AI SDK Power**: Complete access to all AI SDK features and capabilities - **🛡️ Built-in Security**: Automatic data sanitization inherited from AI SDK - **🎭 Provider Flexibility**: Register only the providers you need Supported Models & Features ------------------------------- [](#supported-models--features) The bundle supports all models and features from the [Lingoda AI SDK](https://github.com/lingoda/ai-sdk#-supported-models): **OpenAI Models**: GPT-5, GPT-4.1, GPT-4o series, Audio models (Whisper, TTS) **Anthropic Models**: Claude 4.1, Claude 4.0, Claude 3.7, Claude 3.5 series **Google Models**: Gemini 2.5 Pro and Flash with 1M context **AI Capabilities**: Text generation, conversations, audio synthesis/transcription, parameterized prompts, streaming, vision, tools, reasoning, and more. See the [AI SDK documentation](https://github.com/lingoda/ai-sdk/tree/main/docs) for complete feature documentation. Getting Help ------------ [](#getting-help) - 📖 **AI SDK Docs**: [Complete documentation](https://github.com/lingoda/ai-bundle/tree/main/docs) - 🐛 **Issues**: [Report bugs or request features](https://github.com/lingoda/ai-bundle/issues) - 💬 **Discussions**: [Community discussions](https://github.com/lingoda/ai-bundle/discussions) License ------- [](#license) MIT License. See [LICENSE](LICENSE) for details. ### Health Score 48 — FairBetter than 95% of packages Maintenance89 Actively maintained with recent releases Popularity28 Limited adoption so far Community8 Small or concentrated contributor base Maturity55 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 ~52 days Total 5 Last Release 55d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/30c0431d32647bf0f71a0dbb9d2c6b9e71f18ae88124366d07a3305dc2505114?d=identicon)[balazscsaba2006](/maintainers/balazscsaba2006) --- Top Contributors [![balazscsaba2006](https://avatars.githubusercontent.com/u/1202594?v=4)](https://github.com/balazscsaba2006 "balazscsaba2006 (12 commits)") --- Tags symfonybundleaiopenaiGeminianthropic ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StyleECS Type Coverage Yes ### Embed Badge ![Health badge](/badges/lingoda-ai-bundle/health.svg) ``` [![Health](https://phpackages.com/badges/lingoda-ai-bundle/health.svg)](https://phpackages.com/packages/lingoda-ai-bundle) ``` ### Alternatives [shopware/platform The Shopware e-commerce core 3.3k1.5M3](/packages/shopware-platform)[sulu/sulu Core framework that implements the functionality of the Sulu content management system 1.3k1.3M152](/packages/sulu-sulu)[prestashop/prestashop PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers. 9.0k15.4k](/packages/prestashop-prestashop)[shopware/core Shopware platform is the core for all Shopware ecommerce products. 595.2M386](/packages/shopware-core)[sylius/sylius E-Commerce platform for PHP, based on Symfony framework. 8.4k5.6M651](/packages/sylius-sylius)[ec-cube/ec-cube EC-CUBE EC open platform. 78527.0k1](/packages/ec-cube-ec-cube) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)