Add Vision API functionality

- Added 'vision' configuration for Vision API model and max tokens in the `config/groq.php` file.
- Included examples of analyzing images with the Groq Vision API using URLs and local image files.
- Provided information on configuring the default model for Vision in the `config/groq.php` file.
- Mentioned that the Vision API is experimental and may not have long-term support.

Author: lucianotonet

.gitignore

@@ -18,4 +18,5 @@ yarn-error.log
 /.idea
 /.vscode
 composer.lock
-proj2md.py
+proj2md.py
+CHANGELOG_GEN.sh

CHANGELOG.md

@@ -1,40 +1,29 @@
 # Changelog
 
-Todas as mudanças notáveis neste projeto serão documentadas neste arquivo.
 
-O formato é baseado em [Keep a Changelog](https://keepachangelog.com/pt-BR/1.0.0/),
-e este projeto adere ao [Versionamento Semântico](https://semver.org/lang/pt-BR/).
-
-## [0.0.8] - 2024-03-XX
-
-### Adicionado
-- Novo arquivo `.env.example` com exemplos de configuração da API Groq.
-- Suporte para configuração de múltiplas instâncias da API Groq.
-- Novos métodos de validação em requisições para facilitar a integração da API.
-- Implementação de controle de taxa para evitar abusos da API.
-- Adição de testes abrangentes, incluindo testes de integração, unitários e de configuração.
-- Novo middleware `GroqRateLimiter` para limitar requisições à API.
-- Arquivos de linguagem para suporte a internacionalização de mensagens de erro.
-
-### Alterado
-- Atualização do README.md com documentação simplificada e exemplos práticos de uso.
-- Refatoração do código para melhorar a legibilidade e manutenibilidade.
-- Expansão da configuração com variáveis para ajuste de modelo e limites de taxa.
-- Atualização da fachada Groq para acesso simplificado aos métodos da biblioteca GroqPHP.
-- Melhoria na flexibilidade de configuração da integração com a API Groq.
-
-### Corrigido
-- Correção de problemas de compatibilidade com diferentes versões do Laravel.
-
-### Segurança
-- Implementação de melhores práticas de segurança na manipulação de chaves de API.
-
-## [0.0.7] - 2024-XX-XX
-
-### Adicionado
-- Versão inicial do pacote Groq Laravel.
-- Integração básica com a API Groq.
-- Configuração inicial do pacote.
-
-[0.0.8]: https://github.com/lucianotonet/groq-laravel/compare/v0.0.7...v0.0.8
-[0.0.7]: https://github.com/lucianotonet/groq-laravel/releases/tag/v0.0.7
+ *🚧 Next Relesase*
+* [03/09/2024](https://github.com/lucianotonet/groq-laravel/commits/9868df67da994a011c573f4cd037d8a2eafb52cd) Atualiza links de badge para HTTPS no README
+* [03/09/2024](https://github.com/lucianotonet/groq-laravel/commits/6515f555cd92cd79d2c0bdfe8c002f6b4859d933) Atualiza badges no README para incluir versões instáveis
+
+## v0.0.8
+* [03/09/2024](https://github.com/lucianotonet/groq-laravel/commits/3505dc510883ed34fae610524292cbb014750aa8) Update README.md
+* [03/09/2024](https://github.com/lucianotonet/groq-laravel/commits/6c36e8ff9f953ce3eead317b1b40865c065be012) Adiciona documentação e melhora a configuração do Groq Laravel
+* [02/09/2024](https://github.com/lucianotonet/groq-laravel/commits/62af4e4ba5674ffb13cc5ae48cfab0c1aad8fedc) Atualiza integração do Groq com novas funcionalidades
+* [29/07/2024](https://github.com/lucianotonet/groq-laravel/commits/c078490e3b5c20c815097c8d247b9541b8d25426) docs: Update README to reflect changes
+* [29/07/2024](https://github.com/lucianotonet/groq-laravel/commits/959a5cf1d8c393b95b300c47384a58a5c4e284e5) feat: Integrate GROQ API with configuration flexibility
+* [29/07/2024](https://github.com/lucianotonet/groq-laravel/commits/b2500a8e4af9505222db7b4be54e63de81e57011) chore: Update Groq facade for simplified access to GroqPHP library methods
+* [29/07/2024](https://github.com/lucianotonet/groq-laravel/commits/aee513a150845068e062b5e7bf707bee6bddf08b) chore: Update composer.json description and version
+* [20/04/2024](https://github.com/lucianotonet/groq-laravel/commits/049dac61eff527a6dc16c303e513720475732fb8) Refactored code to improve readability and maintainability.
+
+## v0.0.4
+* [20/04/2024](https://github.com/lucianotonet/groq-laravel/commits/cf503b1326cd7126eda08acda4323e7b2bbb994e) Refactored code to improve readability and maintainability.
+
+## v0.0.3
+* [30/03/2024](https://github.com/lucianotonet/groq-laravel/commits/5caedeae2e250fb2287e9aa47ac4c1ad1b673d37) Udpate version dependency
+* [28/03/2024](https://github.com/lucianotonet/groq-laravel/commits/4b7e53f25e9918c512d0b6cdeec833bb3d880d65) Udpate readme
+
+## v0.0.2
+* [28/03/2024](https://github.com/lucianotonet/groq-laravel/commits/9c67dbf59149b8de7bee19be83aebe7fabd9617c) Udpate readme
+* [28/03/2024](https://github.com/lucianotonet/groq-laravel/commits/59993d56c3ee35f97ec644b165ae2c0c502f26ba) Add basic stuff
+* [27/03/2024](https://github.com/lucianotonet/groq-laravel/commits/9bdbe7592acaa19b960ffc359fe2ee8c52b7143f) WIP
+* [22/03/2024](https://github.com/lucianotonet/groq-laravel/commits/0b5eb656b3930880654e0562f56859554b5cf15e) First commit. Add base skeleton.

README.md

@@ -1,5 +1,7 @@
 # Groq Laravel
 
+![Groq Laravel](./docs/art.png)
+
 [![Latest Stable Version](https://poser.pugx.org/lucianotonet/groq-laravel/v)](https://packagist.org/packages/lucianotonet/groq-laravel) [![Total Downloads](https://poser.pugx.org/lucianotonet/groq-laravel/downloads)](https://packagist.org/packages/lucianotonet/groq-laravel) [![Latest Unstable Version](https://poser.pugx.org/lucianotonet/groq-laravel/v/unstable)](https://packagist.org/packages/lucianotonet/groq-laravel) [![License](https://poser.pugx.org/lucianotonet/groq-laravel/license)](https://packagist.org/packages/lucianotonet/groq-laravel) [![PHP Version Require](https://poser.pugx.org/lucianotonet/groq-laravel/require/php)](https://packagist.org/packages/lucianotonet/groq-laravel)
 
 Groq Laravel é um pacote poderoso para integração entre suas aplicações Laravel a API da [Groq](https://groq.com/), permitindo que você aproveite velocidades ultra-rápidas de inferência de IA com alguns dos LLMs mais populares, como o Llama3.1 ou Mixtral.

composer.json

@@ -2,7 +2,7 @@
     "name": "lucianotonet/groq-laravel",
     "description": "Laravel package to access Groq REST API",
     "type": "library",
-    "version": "0.0.8",
+    "version": "0.0.9",
     "license": "MIT",
     "authors": [
         {
@@ -12,7 +12,7 @@
     ],
     "require": {
         "php": "^8.1",
-        "lucianotonet/groq-php": "^0.0.8",
+        "lucianotonet/groq-php": "^0.0.9",
         "illuminate/support": "*",
         "illuminate/contracts": "*"
     },

config/groq.php

@@ -25,4 +25,9 @@
     ],
 
     'rate_limit' => env('GROQ_RATE_LIMIT', 60),
+
+    'vision' => [
+        'model' => env('GROQ_VISION_MODEL', 'llava-v1.5-7b-4096-preview'),
+        'max_tokens' => env('GROQ_VISION_MAX_TOKENS', 300),
+    ],
 ];

docs/art.png

@@ -116,4 +116,51 @@ try {
 }
 ```
 
+## 6. Analyzing an Image with Vision
+
+To analyze an image with the Groq Vision API, you can use the `vision()` method of the `Groq` facade. This method requires two parameters:
+
+- `$imagePathOrUrl`: The path to the local image file or the URL of the image.
+- `$prompt`: The question or context for the image analysis.
+
+**Example of use with image URL:**
+
+```php
+use LucianoTonet\GroqLaravel\Facades\Groq;
+
+// ...
+
+$imageUrl = 'https://example.com/image.jpg'; // Replace with your image URL
+$prompt = 'Describe the image';
+
+$response = Groq::vision()->analyze($imageUrl, $prompt);
+
+$imageDescription = $response['choices'][0]['message']['content'];
+
+// ... do something with the image description
+```
+
+**Example of use with local image file:**
+
+```php
+use LucianoTonet\GroqLaravel\Facades\Groq;
+
+// ...
+
+$imagePath = '/path/to/your/image.jpg'; // Replace with the actual path
+$prompt = 'What do you see in this image?';
+
+$response = Groq::vision()->analyze($imagePath, $prompt);
+
+$imageAnalysis = $response['choices'][0]['message']['content'];
+
+// ... do something with the image analysis
+```
+
+**Remember:**
+- The Vision API requires a model compatible with image analysis, such as `llava-v1.5-7b-4096-preview`. You can configure the default model for Vision in the `config/groq.php` configuration file.
+- The Vision API is an experimental feature and may not meet expectations, as well as not having long-term support.
+
+## 7. More examples
+
 These are just a few examples of how to use the Groq Laravel package. Explore the documentation and experiment with different approaches to integrate the Groq API into your projects.

docs/practical-examples.md

@@ -89,4 +89,15 @@ public static function apiKey(): string
     {
         return app(GroqPHP::class)->apiKey();
     }
+
+    /**
+     * Iniciar uma sessão de visão com a API Groq.
+     *
+     * @return \LucianoTonet\GroqPHP\Vision Uma instância da classe Vision para gerenciar sessões de visão.
+     * @throws GroqException
+     */
+    public static function vision(): \LucianoTonet\GroqPHP\Vision
+    {
+        return app(GroqPHP::class)->vision();
+    }
 }