AMD Local AI Use: imagens, voz e transcrição no próprio computador

ANÁLISE EDITORIAL

Gerar uma imagem, transcrever uma reunião e sintetizar voz são tarefas que normalmente escapam para APIs externas. A AMD Local AI Use muda esse caminho: ela ensina o agente a manter o raciocínio de texto no provedor já configurado, mas encaminhar imagem, fala e transcrição para um Lemonade Server no próprio computador.

A versão auditada vem do repositório oficial amd/skills, mantido pela AMD. O projeto tinha 282 estrelas na consulta de 27 de agosto de 2026, estava ativo e foi fixado no commit 9353c26ad05c516f41dc0f60dab5922d32199b41, sob licença MIT. A adoção fica abaixo da regra geral de mil estrelas, mas a exceção é objetiva: o mantenedor é o fornecedor oficial, há documentação, evolução recente e licença explícita. O pacote local do Bastidores é documental e não contém o instalador Python.

O que esta Skill faz de verdade

Esta é uma meta-Skill. Em vez de resolver apenas um pedido, ela grava uma regra persistente no AGENTS.md do projeto. A regra orienta clientes compatíveis a chamar a API local do Lemonade para três modalidades: geração e edição de imagem, síntese de voz e transcrição de áudio. O endpoint padrão é http://localhost:13305/api/v1. A conversa de texto não é redirecionada automaticamente.

O fluxo oficial verifica se a CLI moderna do Lemonade está disponível, tenta instalar a versão atual quando ela falta, espera o serviço lemond responder e insere um bloco marcado no arquivo de instruções. O SKILL.md fixado no commit exige Lemonade 10.1.0 ou mais recente e deixa claro que o comando antigo lemonade serve não pertence ao fluxo moderno.

A promessa central é de roteamento, não de qualidade garantida, privacidade absoluta ou gratuidade total. Modelos ocupam disco, a primeira carga precisa de rede, a máquina consome energia e cada modalidade usa um backend diferente. A Skill também não serve para embutir Lemonade dentro de um aplicativo distribuído a clientes.

Para quem serve

Serve a criadores, equipes de produto e desenvolvedores que repetem tarefas multimodais e querem tornar explícito quando um arquivo permanece no dispositivo. É especialmente útil em laboratórios com áudio interno, protótipos de voz, lotes de imagens e testes nos quais o custo por chamada de API incomoda mais que a latência local.

Ela também atende quem usa Codex, Claude Code, Cursor, Gemini CLI ou outro cliente capaz de carregar Agent Skills e respeitar instruções do projeto. O README oficial fixado lista os clientes e documenta a instalação pelo Skills CLI.

Esta página não duplica a Skill Microsoft Local AI Agents já presente no catálogo. A opção da Microsoft monta um agente local com Foundry Local, modelo de linguagem e ferramentas delimitadas. A AMD Local AI Use preserva o LLM de texto existente e troca apenas as rotas multimodais por endpoints do Lemonade.

Compatibilidade e pré-requisitos

O documento auditado declara Windows 11 x64, Ubuntu ou Debian x64 e macOS em beta. A instalação usa winget no Windows, PPA ou Snap no Linux e Homebrew no macOS. Em Linux, a instalação de sistema pode exigir sudo. Em máquinas gerenciadas, use a opção --no-install e peça que a equipe responsável instale e inicie o serviço.

• Python disponível para executar o instalador oficial da Skill.
• Lemonade 10.1.0 ou superior, com a CLI lemonade e o serviço lemond.
• Aproximadamente 8 GB livres para o trio padrão e cerca de 5 GB na primeira carga do modelo de imagem, segundo a versão auditada.
• Rede para instalar o runtime e baixar cada modelo na primeira utilização.
• Permissão consciente para alterar AGENTS.md e, se necessário, instalar software e iniciar serviço local.

Os tamanhos e identificadores de modelo podem mudar. A própria referência manda confirmar o catálogo no endpoint GET /api/v1/models?show_all=true. Consulte também a lista atual de modelos do Lemonade antes de reservar espaço ou prometer compatibilidade de hardware.

Instalação recomendada

Comece pelo ZIP do Bastidores para revisar proveniência, instruções, referência e regra persistente. Ele contém seis arquivos textuais, incluindo a licença MIT, e exclui o instalador setup_local_ai.py, avaliações, modelos, binários, dependências, chaves e credenciais. Portanto, ele não é um instalador executável nem um espelho funcional completo.

Para instalar a Skill funcional, confira o diretório oficial fixado e compare com a versão atual do repositório. O comando publicado pela AMD é npx skills add amd/skills --skill local-ai-use --agent codex para Codex. Troque o agente somente depois de confirmar o nome aceito pelo Skills CLI.

O comando usa rede e instala arquivos no destino escolhido. Revise o diff antes de continuar. Depois leia o instalador oficial fixado, sem executá-lo por impulso. Ele pode chamar gerenciadores de pacote, baixar instaladores e gravar o bloco de roteamento. Em ambiente corporativo, prefira a instalação aprovada do Lemonade e execute o script com --no-install.

Configuração antes do primeiro uso

Defina por escrito quais modalidades serão locais, o diretório do projeto, a política de fallback e o responsável pelo serviço. O padrão usa SD-Turbo para imagem, kokoro-v1 para voz e Whisper-Tiny para transcrição. A referência oficial fixada informa que Whisper-Tiny é o caminho rápido em inglês. Para áudio em PT-BR, confirme um modelo multilíngue disponível, como a classe Small ou superior, antes de gravar a regra.

Rode primeiro lemonade status --json e depois lemonade backends --all. Um chat funcionando não prova que imagem, TTS e STT estão prontos. Cada modalidade escolhe um backend e pode cair para CPU ou falhar separadamente. Fixe o endpoint em loopback enquanto não houver uma necessidade formal de acesso remoto.

Se LEMONADE_API_KEY estiver configurada, a regra precisa incluir o cabeçalho de autorização em todas as chamadas. Não coloque a chave no AGENTS.md. Guarde apenas a instrução de usar a variável de ambiente. O template oficial auditado mostra os endpoints e a política de fallback.

Primeiro uso seguro

Faça um teste por modalidade, com dados descartáveis. Para imagem, gere uma figura simples sem dados pessoais. Para voz, sintetize uma frase curta. Para transcrição, use um WAV mono de 16 kHz sem informação confidencial. Confirme no log e no tráfego local que a chamada foi para localhost:13305, que o modelo correto foi carregado e que nenhum fallback em nuvem ocorreu silenciosamente.

1. Verifique saúde, versão, espaço livre e backends antes de baixar modelos.
2. Abra o diff de AGENTS.md e confirme os marcadores BEGIN e END da AMD.
3. Teste imagem, voz e transcrição separadamente.
4. Interrompa se a Skill tentar alterar arquivo fora do projeto escolhido.
5. Registre tempo, qualidade observada, uso real de CPU ou GPU e falhas, sem transformar um teste em benchmark universal.

A primeira solicitação pode baixar gigabytes. Em rede medida, faça o pull em janela autorizada. A documentação oficial de instalação do Lemonade deve prevalecer se o gerenciador, o nome do pacote ou o serviço mudar.

Resultado esperado

Ao final, o serviço local responde no endpoint configurado, o projeto contém um único bloco de roteamento e cada modalidade usada possui backend instalado. Um pedido posterior de imagem deve chamar /api/v1/images/generations; voz, /api/v1/audio/speech; transcrição, /api/v1/audio/transcriptions.

O resultado não é “toda IA ficou local”. O agente que interpreta o pedido e escreve a resposta pode continuar em nuvem. Também não há garantia de que todo cliente obedecerá ao AGENTS.md da mesma forma. A verificação real é observar a chamada de rede e o arquivo produzido em uma nova sessão.

Permissões e riscos

O risco mais imediato é de instalação: o script pode acionar winget, apt, Snap, Homebrew ou instaladores baixados. Isso altera o sistema, usa rede, pode exigir elevação e instala um serviço persistente. O segundo risco é de configuração: a Skill grava AGENTS.md, arquivo que influencia o comportamento futuro do agente no projeto.

Há ainda consumo relevante de disco, memória, CPU ou GPU. Um backend marcado como instalado não prova aceleração real. A versão auditada recomenda observar utilização da GPU durante a tarefa para detectar fallback silencioso para CPU. Em notebook, isso também afeta bateria e temperatura.

Não exponha a porta 13305 para a rede por conveniência. A referência alerta que usar 0.0.0.0 abre o servidor para a LAN e exige autenticação e regra de firewall deliberada. Loopback sem chave pode ser aceitável no padrão local, mas não deve ser tratado como seguro depois de publicar a porta.

Privacidade local também tem limites: prompts, imagens e áudios podem permanecer em arquivos temporários, logs e caches. Defina retenção, permissões de pasta e exclusão antes de processar conteúdo sensível. Nunca anuncie que algo ficou privado sem confirmar a rota e o armazenamento.

Erros comuns

Usar uma CLI antiga: se lemonade status responder com erro de comando, pode haver uma versão anterior a 10.1.0 no PATH. Não remova automaticamente. Identifique o binário e siga o procedimento oficial.

Pular o instalador porque o servidor já responde: isso deixa o AGENTS.md sem a regra persistente. Execute o fluxo oficial em modo compatível com a política do ambiente e revise o diff.

Tratar um backend como prova dos demais: imagem, voz e transcrição têm receitas diferentes. Valide cada uma com entrada sintética.

Transcrever PT-BR com o padrão em inglês: selecione um modelo multilíngue confirmado no catálogo atual. Não invente precisão nem compare transcrições de motores diferentes como se fossem equivalentes.

Expor o serviço na LAN sem proteção: mantenha loopback. Se houver requisito remoto, use chave, firewall restrito e revisão da arquitetura.

Confundir o ZIP local com o pacote executável: o download do Bastidores é documental. O instalador Python foi excluído de propósito e só deve ser obtido da fonte oficial após revisão.

Versão auditada e download local

A curadoria fixou amd/skills no commit 9353c26ad05c516f41dc0f60dab5922d32199b41, consultado em 27/08/2026 com 282 estrelas e licença MIT. A exceção ao piso de mil estrelas foi aceita porque o repositório é mantido oficialmente pela AMD, está ativo e oferece documentação e licença verificáveis.

O pacote tem 15.567 bytes e SHA-256 a644c7f83c3a174e2aecdefee08628d8ce3ef9d2d8f0d3f5ab9396562bb321c2. Baixar o pacote documental auditado. Ele contém SKILL.md, reference.md, skill-card.md, o template textual, LICENSE e ORIGEM.md. O botão do repositório oficial fica separado no card.

A licença MIT oficial fixada permite redistribuição com preservação do aviso. O pacote preserva a licença e a proveniência, mas não hospeda o script executável nem componentes do Lemonade.

Ilustração editorial exclusiva do Bastidores da IA. Não é captura de tela, interface real, logotipo oficial, modelo executado, áudio processado nem prova de privacidade ou desempenho.

Resultado esperado e limite final

O uso bem-sucedido termina com um projeto capaz de pedir tarefas multimodais ao servidor local e revelar qualquer fallback antes de usar nuvem. Isso oferece controle de rota e previsibilidade operacional, não qualidade superior automática.

A aceitação mínima deve reunir quatro evidências: saúde do serviço, bloco correto no AGENTS.md, teste local separado por modalidade e ausência de chamada externa não autorizada. Se uma delas faltar, o roteamento ainda não foi provado. Se a política da empresa proíbe instalação pelo agente ou modificação persistente das instruções, use esta página apenas como referência e não execute a Skill.

Fontes primárias

• Repositório oficial AMD Skills
• Commit auditado
• Diretório oficial da Skill no commit
• SKILL.md oficial fixado
• Referência técnica da Skill
• Regra persistente auditada
• Instalador oficial, não incluído no ZIP
• Licença MIT oficial
• Instalação oficial do Lemonade Server
• Catálogo atual de modelos do Lemonade