Release candidate for version 1.0.0

Author: lucianotonet

.env.example

@@ -1,9 +1,35 @@
-# Chave API da Groq (necessária para testes de integração)
-GROQ_API_KEY=
-GROQ_API_BASE=
-
-# Configurações opcionais
-GROQ_MODEL=llama3-8b-8192
+# Groq API Configuration
+GROQ_API_KEY=your-api-key-here
+GROQ_MODEL=llama-3.1-8b-instant
+GROQ_API_BASE=https://api.groq.com/openai/v1
 GROQ_TIMEOUT=30
+
+# Cache Configuration
 GROQ_CACHE_ENABLED=true
-GROQ_CACHE_TTL=3600
+GROQ_CACHE_TTL=3600
+GROQ_CACHE_KEY_PREFIX=groq_
+
+# Model Options
+GROQ_MAX_TOKENS=150
+GROQ_TEMPERATURE=0.7
+GROQ_TOP_P=1.0
+GROQ_FREQUENCY_PENALTY=0
+GROQ_PRESENCE_PENALTY=0
+GROQ_N=1
+
+# Rate Limiting
+GROQ_RATE_LIMIT=60
+
+# Vision Configuration
+GROQ_VISION_MODEL=meta-llama/llama-4-scout-17b-16e-instruct
+GROQ_VISION_MAX_TOKENS=300
+
+# Batch Processing
+GROQ_BATCH_COMPLETION_WINDOW=5m
+GROQ_BATCH_MAX_SIZE=20
+GROQ_BATCH_AUTO_PROCESS=true
+
+# Speech Configuration
+GROQ_SPEECH_MODEL=playai-tts
+GROQ_SPEECH_VOICE=Bryan-PlayAI
+GROQ_SPEECH_FORMAT=wav

CHANGELOG.md

@@ -1,8 +1,36 @@
 # Changelog
 
+All notable changes to this project will be documented in this file.
 
- *🚧 Next Relesase*
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.0] - 2025-04-12
+
+### Added
+- Suporte completo para Text-to-Speech via método `speech()`
+- Suporte aprimorado para processamento em lote via método `batch()`
+- Novas configurações para Speech API e Batch Processing
+- Documentação atualizada com exemplos de uso das novas funcionalidades
+
+### Changed
+- Atualizada dependência do groq-php para ^1.2.0
+- Melhorada a documentação do Facade com PHPDoc atualizado
+- Refatorado GroqClient para melhor gerenciamento de configurações
+
+### Fixed
+- Corrigido o método `batch()` para usar o nome correto do método no cliente groq-php
+
+## [Unreleased]
+
+### Changed
+- Updated vision model to use `meta-llama/llama-4-scout-17b-16e-instruct`, the latest recommended model by Groq
+- Improved file upload test to ensure proper text/plain MIME type recognition
+- Fixed file upload test to use correct purpose 'batch'
+
+### Notes
+- The new vision model `meta-llama/llama-4-scout-17b-16e-instruct` offers improved multimodal performance with support for a 128K token context window and image input up to 5 images
+- Current performance: 607 tokens per second (TPS) as benchmarked by Groq
 
 ## v0.0.10
 * [29/10/2024](https://github.com/lucianotonet/groq-laravel/commits/09f1be747860f9de89d5158d6370352c96b7020a) Update setting options

README.md

@@ -311,6 +311,49 @@ foreach ($result['segments'] as $segment) {
 }
 ```
 
+## Speech API (Text-to-Speech)
+
+The Groq Laravel package also supports Text-to-Speech (TTS) to convert text into spoken audio.
+
+**Basic example of Text-to-Speech:**
+
+```php
+use LucianoTonet\GroqLaravel\Facades\Groq;
+use Illuminate\Support\Facades\Storage;
+
+// Basic Text-to-Speech
+// Model, voice, and response_format will be taken from your config/groq.php by default.
+$speechResponse = Groq::speech()->create([
+    'input' => 'Hello from Groq Laravel! This is a text-to-speech test.',
+]);
+
+// Save the audio file (e.g., to storage/app/speech_output.wav)
+Storage::disk('local')->put('speech_output.wav', $speechResponse->body()); 
+// $speechResponse->body() contains the raw audio bytes.
+// You can also stream the response using $speechResponse->stream() if needed.
+```
+
+**Example with advanced options:**
+
+```php
+use LucianoTonet\GroqLaravel\Facades\Groq;
+use Illuminate\Support\Facades\Storage;
+
+// Text-to-Speech with advanced options
+$speechResponse = Groq::speech()->create([
+    'model' => 'playht/v2/samantha-v2-120ms-lowlatency', // Specify a different model (check Groq documentation for available TTS models)
+    'input' => 'This is a test with a different voice, format, and speed.',
+    'voice' => 'samantha-playht',   // Specify a different voice
+    'response_format' => 'mp3',   // Supported formats: mp3, ogg_vorbis, wav, flac
+    'speed' => 0.9                 // Adjust speed (0.25 to 4.0)
+]);
+
+// Save the audio file (e.g., to storage/app/speech_output_advanced.mp3)
+Storage::disk('local')->put('speech_output_advanced.mp3', $speechResponse->body());
+```
+
+**Note:** Refer to the official Groq API documentation for the latest available TTS models, voices, and supported formats. You can set default values in your `config/groq.php` file.
+
 ## Step-by-Step Reasoning
 
 Groq Laravel offers support for obtaining responses with step-by-step reasoning, useful for detailed explanations, mathematical problems, or any solution that benefits from a transparent process.

composer.json

@@ -2,7 +2,6 @@
     "name": "lucianotonet/groq-laravel",
     "description": "Laravel integration for GroqCloud",
     "type": "library",
-    "version": "1.0.0",
     "license": "MIT",
     "authors": [
         {
@@ -12,9 +11,9 @@
     ],
     "require": {
         "php": "^8.1",
-        "lucianotonet/groq-php": "^1.0.0",
         "illuminate/support": "*",
-        "illuminate/contracts": "*"
+        "illuminate/contracts": "*",
+        "lucianotonet/groq-php": "^1.2"
     },
     "require-dev": {
         "orchestra/testbench": "^6.0|^7.0|^8.0",

config/groq.php

@@ -82,7 +82,35 @@
     'rate_limit' => env('GROQ_RATE_LIMIT', 60),
 
     'vision' => [
-        'model' => env('GROQ_VISION_MODEL', 'llava-v1.5-7b-4096-preview'),
+        'model' => env('GROQ_VISION_MODEL', 'meta-llama/llama-4-scout-17b-16e-instruct'),
         'max_tokens' => env('GROQ_VISION_MAX_TOKENS', 300),
     ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Batch Processing
+    |--------------------------------------------------------------------------
+    |
+    | Configurações para processamento em lote.
+    |
+    */
+    'batch' => [
+        'completion_window' => env('GROQ_BATCH_COMPLETION_WINDOW', '5m'),
+        'max_batch_size' => env('GROQ_BATCH_MAX_SIZE', 20),
+        'auto_process' => env('GROQ_BATCH_AUTO_PROCESS', true),
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Speech (Text-to-Speech)
+    |--------------------------------------------------------------------------
+    |
+    | Configurações para o serviço de Text-to-Speech.
+    |
+    */
+    'speech' => [
+        'model' => env('GROQ_SPEECH_MODEL', 'playai-tts'),
+        'voice' => env('GROQ_SPEECH_VOICE', 'Bryan-PlayAI'),
+        'response_format' => env('GROQ_SPEECH_FORMAT', 'wav'),
+    ],
 ];

phpunit.xml

@@ -16,5 +16,6 @@
     </coverage>
     <php>
         <env name="APP_ENV" value="testing"/>
+        <env name="GROQ_API_KEY_TEST" value="gsk_test_key"/>
     </php>
 </phpunit>

src/Facades/Groq.php

@@ -10,11 +10,13 @@
  * @method static \LucianoTonet\GroqPHP\Models models()
  * @method static \LucianoTonet\GroqPHP\Vision vision()
  * @method static \LucianoTonet\GroqPHP\Audio audio()
- * @method static \LucianoTonet\GroqPHP\Files files()
- * @method static \LucianoTonet\GroqPHP\Batches batches()
+ * @method static \LucianoTonet\GroqPHP\FileManager files()
+ * @method static \LucianoTonet\GroqPHP\BatchManager batches()
  * @method static void setConfig(array $options)
  * @method static void setOptions(array $options)
  * @method static \LucianoTonet\GroqPHP\Groq getClient()
+ * @method static string apiKey()
+ * @method static string baseUrl()
  *
  * @see \LucianoTonet\GroqLaravel\GroqClient
  */
@@ -84,4 +86,15 @@ public static function files(): \LucianoTonet\GroqPHP\FileManager
     {
         return app(GroqPHP::class)->files();
     }
+
+    /**
+     * Get batch instance for processing multiple requests.
+     *
+     * @return \LucianoTonet\GroqPHP\BatchManager An instance of the BatchManager class.
+     * @throws GroqException
+     */
+    public static function batch(): \LucianoTonet\GroqPHP\BatchManager
+    {
+        return app(GroqPHP::class)->batches();
+    }
 }

src/GroqClient.php

@@ -127,6 +127,26 @@ public function batches()
         return $this->client->batches();
     }
 
+    /**
+     * Get speech instance
+     * 
+     * @return \LucianoTonet\GroqPHP\Speech
+     */
+    public function speech()
+    {
+        return $this->client->speech();
+    }
+
+    /**
+     * Get batch instance
+     * 
+     * @return \LucianoTonet\GroqPHP\BatchManager
+     */
+    public function batch()
+    {
+        return $this->client->batches();
+    }
+
     /**
      * Set configuration options
      * 

tests/Feature/BatchTest.php

@@ -0,0 +1,94 @@
+<?php
+
+namespace LucianoTonet\GroqLaravel\Tests\Feature;
+
+use LucianoTonet\GroqLaravel\Facades\Groq;
+use LucianoTonet\GroqLaravel\Tests\TestCase;
+
+class BatchTest extends TestCase
+{
+    protected $tempFile;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+        
+        // Create temporary batch file with .jsonl extension
+        $tempDir = sys_get_temp_dir();
+        $this->tempFile = $tempDir . '/groq_batch_' . uniqid() . '.jsonl';
+        
+        // Create valid JSONL content with required fields
+        $content = [
+            [
+                'model' => 'llama-3.1-8b-instant',
+                'messages' => [
+                    ['role' => 'user', 'content' => 'Hello!']
+                ]
+            ],
+            [
+                'model' => 'llama-3.1-8b-instant',
+                'messages' => [
+                    ['role' => 'user', 'content' => 'How are you?']
+                ]
+            ]
+        ];
+
+        // Write each line as JSON
+        $jsonlContent = '';
+        foreach ($content as $item) {
+            $jsonlContent .= json_encode($item) . "\n";
+        }
+        
+        file_put_contents($this->tempFile, $jsonlContent);
+    }
+
+    protected function tearDown(): void
+    {
+        if (file_exists($this->tempFile)) {
+            unlink($this->tempFile);
+        }
+        parent::tearDown();
+    }
+
+    /** @test */
+    public function it_can_create_batch_instance()
+    {
+        $batch = Groq::batch();
+        $this->assertInstanceOf(\LucianoTonet\GroqPHP\BatchManager::class, $batch);
+    }
+
+    /** @test */
+    public function it_can_create_batch_with_config()
+    {
+        config([
+            'groq.batch.completion_window' => '5m',
+            'groq.batch.max_batch_size' => 20,
+            'groq.batch.auto_process' => true,
+        ]);
+
+        $batch = Groq::batch();
+        $this->assertInstanceOf(\LucianoTonet\GroqPHP\BatchManager::class, $batch);
+    }
+
+    /** @test */
+    public function it_can_create_batch_with_file()
+    {
+        // Upload the file first
+        $file = Groq::files()->upload($this->tempFile, 'batch');
+        $this->assertNotEmpty($file->id);
+
+        try {
+            // Create batch with file
+            $batch = Groq::batch()->create([
+                'input_file_id' => $file->id,
+                'endpoint' => '/v1/chat/completions',
+                'completion_window' => '24h'
+            ]);
+
+            $this->assertInstanceOf(\LucianoTonet\GroqPHP\BatchManager::class, $batch);
+        } finally {
+            // Cleanup
+            Groq::files()->delete($file->id);
+        }
+    }
+}