PHPackages bugadoz/woolball-library - 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. bugadoz/woolball-library ActiveLibrary bugadoz/woolball-library ======================== Uma biblioteca poderosa para integração de AI, incluindo funções de texto, imagem e áudio. v3.2.5(1y ago)9151[1 issues](https://github.com/bugadoz/WoolballLibrary/issues)MITPHPPHP >=8.1 Since Dec 18Pushed 1y ago2 watchersCompare [ Source](https://github.com/bugadoz/WoolballLibrary)[ Packagist](https://packagist.org/packages/bugadoz/woolball-library)[ RSS](/packages/bugadoz-woolball-library/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (8)Dependencies (2)Versions (10)Used By (0) WoolballAPI Library =================== [](#woolballapi-library) A biblioteca `WoolballAPI` permite a integração com a API Woolball para realizar diversas tarefas, como conversão de texto em fala, transcrição de áudio, classificação de texto, tradução, detecção de emoções em imagens, análise de visão computacional, e muito mais. Este README explica como instalar, configurar e usar cada método disponível na biblioteca. --- Instalação ---------- [](#instalação) ### Via Composer [](#via-composer) Execute o seguinte comando no terminal para instalar a biblioteca usando o Composer: ``` composer require bugadoz/woolball-library ``` Depois de instalar, inclua o autoloader no seu projeto: ``` require_once 'vendor/autoload.php'; ``` ### Manualmente [](#manualmente) 1. Baixe o arquivo PHP contendo a classe `WoolballAPI`. 2. Inclua a classe no seu projeto: ``` require_once 'WoolballAPI.php'; ``` --- Configuração ------------ [](#configuração) Antes de usar a biblioteca, você precisa configurar a chave de API: ``` $apiKey = 'SUA_API_KEY'; $woolball = new WoolballLibrary\WoolballAPI($apiKey); ``` --- Funções Disponíveis ------------------- [](#funções-disponíveis) A biblioteca fornece as seguintes funções: ### 1. Conversão de Texto para Fala [](#1-conversão-de-texto-para-fala) Converte um texto em áudio no idioma desejado. ``` $audioData = $woolball->textToSpeech('Olá mundo', 'pt'); file_put_contents('output.mp3', $audioData); ``` #### Parâmetros: [](#parâmetros) - `text` (string): O texto que deseja converter. - `language` (string): O código do idioma (ex: `en`, `pt`, `es`). #### Retorno: [](#retorno) - String em formato de dados de áudio (MP3). --- ### 2. Transcrição de Áudio [](#2-transcrição-de-áudio) Transcreve o conteúdo de um arquivo de áudio para texto. ``` $transcription = $woolball->speechToText('audio.wav'); echo $transcription; ``` #### Parâmetros: [](#parâmetros-1) - `filePath` (string): Caminho para o arquivo de áudio. #### Retorno: [](#retorno-1) - Texto transcrito. --- ### 3. Geração de Texto [](#3-geração-de-texto) Gera um texto baseado em um prompt fornecido. ``` $generatedText = $woolball->generateText('Qual é a capital da França?','HuggingFaceTB/SmolLM2-360M-Instruct'); echo $generatedText; ``` #### Parâmetros: [](#parâmetros-2) - `prompt` (string): Texto ou pergunta base para a geração. - Aceita o parametro model na requisição. Confira os Models disponíveis #### Retorno: [](#retorno-2) - Texto gerado. --- ### 4. Tradução de Texto [](#4-tradução-de-texto) Traduz um texto entre dois idiomas especificados. Idiomas: [languages-in-flores-200](https://github.com/facebookresearch/flores/blob/main/flores200/README.md#languages-in-flores-200) ``` $translatedText = $woolball->translateText('Olá, mundo!', 'por_Latn', 'eng_Latn'); echo $translatedText; ``` #### Parâmetros: [](#parâmetros-3) - `text` (string): Texto a ser traduzido. - `sourceLanguage` (string): Idioma de origem. - `targetLanguage` (string): Idioma de destino. #### Retorno: [](#retorno-3) - Texto traduzido. --- ### 5. Classificação de Texto [](#5-classificação-de-texto) Realiza classificação de texto baseada em rótulos fornecidos. ``` $classification = $woolball->classifyText('Qual cidade não está na América do Sul?', ['geografia', 'viagem', 'história']); echo $classification; ``` #### Parâmetros: [](#parâmetros-4) - `text` (string): Texto para classificar. - `labels` (array): Lista de rótulos candidatos. #### Retorno: [](#retorno-4) - Melhor rótulo identificado. --- ### 6. Detecção de Emoções em Imagens [](#6-detecção-de-emoções-em-imagens) Detecta emoções em imagens de rostos humanos. ``` $emotions = $woolball->detectFacialEmotions('img.png'); echo $emotions; ``` #### Parâmetros: [](#parâmetros-5) - `filePath` (string): Caminho para a imagem. #### Retorno: [](#retorno-5) - Emoções detectadas. --- ### 7. Visão Computacional [](#7-visão-computacional) Analisa o conteúdo de uma imagem e fornece descrições. ``` $description = $woolball->analyzeImage('img.png', 'Descreva o conteúdo da imagem'); echo $description; ``` #### Parâmetros: [](#parâmetros-6) - `filePath` (string): Caminho para a imagem. - `prompt` (string): Instrução de descrição. #### Retorno: [](#retorno-6) - Descrição da imagem. --- ### 8. Classificação de Imagens [](#8-classificação-de-imagens) Classifica imagens com base em rótulos fornecidos. ``` $labels = $woolball->classifyImages(['img1.png', 'img2.png']); print_r($labels); ``` #### Parâmetros: [](#parâmetros-7) - `filePaths` (array): Lista de caminhos para imagens. #### Retorno: [](#retorno-7) - Rótulos e pontuações para cada imagem. --- ### 9. Resumo de Texto [](#9-resumo-de-texto) Fornece um resumo para um texto longo. ``` $summary = $woolball->summarizeText('Texto longo aqui...'); echo $summary; ``` #### Parâmetros: [](#parâmetros-8) - `text` (string): Texto a ser resumido. #### Retorno: [](#retorno-8) - Resumo do texto. --- ### 10. Criação de Imagens a Partir de Caracteres [](#10-criação-de-imagens-a-partir-de-caracteres) Gera uma representação visual de um caractere fornecido. ``` $imageBase64 = $woolball->charToImage('A'); file_put_contents('character.png', base64_decode($imageBase64)); ``` #### Parâmetros: [](#parâmetros-9) - `character` (string): Caractere a ser representado. #### Retorno: [](#retorno-9) - String Base64 da imagem. --- ### 11. Avaliação de Sentimento [](#11-avaliação-de-sentimento) Analisa o sentimento de um texto (positivo, negativo ou neutro). ``` $sentiment = $woolball->analyzeSentiment('Estou muito feliz hoje!'); echo $sentiment; ``` #### Parâmetros: [](#parâmetros-10) - `text` (string): Texto a ser analisado. #### Retorno: [](#retorno-10) - Sentimento identificado (positivo, negativo ou neutro). --- Erros e Depuração ----------------- [](#erros-e-depuração) Caso ocorram erros, a biblioteca lançará exceções. Certifique-se de usar blocos `try-catch` para capturá-los: ``` try { $result = $woolball->textToSpeech('Olá mundo', 'pt'); } catch (Exception $e) { echo 'Erro: ' . $e->getMessage(); } ``` --- Contribuição ------------ [](#contribuição) Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou enviar pull requests. --- Licença ------- [](#licença) Esta biblioteca é fornecida sob a licença MIT. Consulte o arquivo `LICENSE` para mais detalhes. --- Créditos -------- [](#créditos) Desenvolvido com ❤️ por [Bugadoz.dev](https://bugadoz.dev). ### Health Score 31 — LowBetter than 68% of packages Maintenance39 Infrequent updates — may be unmaintained Popularity13 Limited adoption so far Community12 Small or concentrated contributor base Maturity53 Maturing project, gaining track record Bus Factor1 Top contributor holds 94.6% 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 ~4 days Total 9 Last Release 482d ago Major Versions v1.0.0 → v3.0.02024-12-18 ### Community Maintainers ![](https://www.gravatar.com/avatar/254af38b722137168e3ced31aadd00ebfb2c9f7278981ee2675e1cbff762f39f?d=identicon)[bugadoz](/maintainers/bugadoz) --- Top Contributors [![bigfatherdev](https://avatars.githubusercontent.com/u/115670953?v=4)](https://github.com/bigfatherdev "bigfatherdev (35 commits)")[![eduardoworrel](https://avatars.githubusercontent.com/u/17443979?v=4)](https://github.com/eduardoworrel "eduardoworrel (1 commits)")[![Joao-Bittencourt](https://avatars.githubusercontent.com/u/24395717?v=4)](https://github.com/Joao-Bittencourt "Joao-Bittencourt (1 commits)") ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/bugadoz-woolball-library/health.svg) ``` [![Health](https://phpackages.com/badges/bugadoz-woolball-library/health.svg)](https://phpackages.com/packages/bugadoz-woolball-library) ``` ### Alternatives [neuron-core/neuron-ai The PHP Agentic Framework. 1.8k245.3k21](/packages/neuron-core-neuron-ai)[tencentcloud/tencentcloud-sdk-php TencentCloudApi php sdk 3731.2M42](/packages/tencentcloud-tencentcloud-sdk-php)[aedart/athenaeum Athenaeum is a mono repository; a collection of various PHP packages 245.2k](/packages/aedart-athenaeum) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)