co-op-translator

Co-op Translator

Automatize facilmente a tradução do seu conteúdo educacional do GitHub para vários idiomas e alcance uma audiência global.

🌐 Suporte a múltiplos idiomas

Suportado pelo Co-op Translator

Visão geral

O Co-op Translator permite que você traduza rapidamente seu conteúdo educacional do GitHub para vários idiomas, alcançando uma audiência global sem esforço. Quando você atualiza seus arquivos Markdown, imagens ou notebooks Jupyter, as traduções são sincronizadas automaticamente para garantir que seu conteúdo educacional no GitHub permaneça atualizado e relevante para usuários internacionais.

Veja como o Co-op Translator organiza o conteúdo educacional traduzido no GitHub:

Exemplo

Início rápido

# Create and activate a virtual environment (recommended)
python -m venv .venv
# Windows
.venv\Scripts\activate
# macOS/Linux
source .venv/bin/activate
# Install the package
pip install co-op-translator
# Translate
translate -l "ko ja fr" -md

Docker:

# Pull the public image from GHCR
docker pull ghcr.io/azure/co-op-translator:latest
# Run with current folder mounted and .env provided (Bash/Zsh)
docker run --rm -it --env-file .env -v "${PWD}:/work" ghcr.io/azure/co-op-translator:latest -l "ko ja fr" -md

Configuração mínima

Crie um arquivo .env usando o template: .env.template
Configure um provedor LLM (Azure OpenAI ou OpenAI)
Para tradução de imagens (-img), também configure o Azure AI Vision
Recomendado: Se você já tem traduções geradas por outras ferramentas, limpe-as antes para evitar conflitos (por exemplo: translations/).
Recomendado: Adicione uma seção de traduções ao seu README usando o template de idiomas do README
Veja: Configurar Azure AI

Uso

Traduzir todos os tipos suportados:

translate -l "ko ja"

Apenas Markdown:

translate -l "de" -md

Markdown + imagens:

translate -l "pt" -md -img

Apenas notebooks:

translate -l "zh" -nb

Mais opções: Referência de comandos

Funcionalidades

Tradução automática para Markdown, notebooks e imagens
Mantém as traduções sincronizadas com alterações na fonte
Funciona localmente (CLI) ou em CI (GitHub Actions)
Usa Azure OpenAI ou OpenAI; opcional Azure AI Vision para imagens
Preserva a formatação e estrutura do Markdown

Documentação

Apoie e incentive o aprendizado global

Junte-se a nós para revolucionar a forma como o conteúdo educacional é compartilhado globalmente! Dê uma ⭐ no Co-op Translator no GitHub e apoie nossa missão de quebrar barreiras linguísticas no aprendizado e na tecnologia. Seu interesse e contribuições fazem toda a diferença! Contribuições de código e sugestões de funcionalidades são sempre bem-vindas.

Explore conteúdo educacional da Microsoft no seu idioma

Apresentações em vídeo

Saiba mais sobre o Co-op Translator através das nossas apresentações (Clique na imagem abaixo para assistir no YouTube.):

Open at Microsoft: Uma breve introdução de 18 minutos e guia rápido de como usar o Co-op Translator.

Contribuindo

Este projeto recebe contribuições e sugestões de braços abertos. Interessado em contribuir com o Azure Co-op Translator? Veja nosso CONTRIBUTING.md para orientações de como você pode ajudar a tornar o Co-op Translator mais acessível.

Contribuidores

Código de Conduta

Este projeto adotou o Código de Conduta de Código Aberto da Microsoft. Para mais informações, veja o FAQ do Código de Conduta ou entre em contato pelo opencode@microsoft.com para dúvidas ou comentários adicionais.

IA Responsável

A Microsoft está comprometida em ajudar nossos clientes a usar nossos produtos de IA de forma responsável, compartilhando nossos aprendizados e construindo parcerias baseadas em confiança por meio de ferramentas como Transparency Notes e Impact Assessments. Muitos desses recursos podem ser encontrados em https://aka.ms/RAI. A abordagem da Microsoft para IA responsável é baseada em nossos princípios de IA: justiça, confiabilidade e segurança, privacidade e proteção, inclusão, transparência e responsabilidade.

Modelos de linguagem, imagem e fala em larga escala – como os usados neste exemplo – podem se comportar de maneiras injustas, não confiáveis ou ofensivas, podendo causar danos. Consulte a nota de transparência do serviço Azure OpenAI para se informar sobre riscos e limitações.

A abordagem recomendada para mitigar esses riscos é incluir um sistema de segurança na sua arquitetura que possa detectar e prevenir comportamentos prejudiciais. O Azure AI Content Safety oferece uma camada independente de proteção, capaz de detectar conteúdo prejudicial gerado por usuários e por IA em aplicativos e serviços. O Azure AI Content Safety inclui APIs de texto e imagem que permitem detectar material nocivo. Também temos o Content Safety Studio interativo, que permite visualizar, explorar e testar exemplos de código para detectar conteúdo prejudicial em diferentes modalidades. A seguinte documentação de início rápido orienta você sobre como fazer requisições ao serviço. Outro aspecto a ser considerado é o desempenho geral do aplicativo. Em aplicações multimodais e com múltiplos modelos, consideramos desempenho como a capacidade do sistema de funcionar conforme você e seus usuários esperam, incluindo não gerar resultados prejudiciais. É importante avaliar o desempenho do seu aplicativo como um todo usando métricas de qualidade de geração, risco e segurança.

Você pode avaliar seu aplicativo de IA no ambiente de desenvolvimento usando o prompt flow SDK. Com um conjunto de dados de teste ou um alvo definido, as gerações do seu aplicativo de IA generativa são medidas quantitativamente com avaliadores integrados ou personalizados, conforme sua escolha. Para começar a usar o prompt flow sdk para avaliar seu sistema, siga o guia de início rápido. Depois de executar uma avaliação, você pode visualizar os resultados no Azure AI Studio.

Marcas Registradas

Este projeto pode conter marcas registradas ou logotipos de projetos, produtos ou serviços. O uso autorizado de marcas registradas ou logotipos da Microsoft está sujeito e deve seguir as Diretrizes de Marca Registrada e Marca da Microsoft. O uso de marcas registradas ou logotipos da Microsoft em versões modificadas deste projeto não deve causar confusão ou sugerir patrocínio da Microsoft. Qualquer uso de marcas registradas ou logotipos de terceiros está sujeito às políticas desses terceiros.

Obtendo Ajuda

Se você tiver dúvidas ou dificuldades ao criar aplicativos de IA, participe:

Se você tiver feedback sobre o produto ou encontrar erros durante o desenvolvimento, acesse:

Aviso Legal: Este documento foi traduzido utilizando o serviço de tradução por IA Co-op Translator. Embora nos esforcemos pela precisão, esteja ciente de que traduções automáticas podem conter erros ou imprecisões. O documento original em seu idioma nativo deve ser considerado a fonte autorizada. Para informações críticas, recomenda-se a tradução profissional humana. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações incorretas decorrentes do uso desta tradução.

This site is open source. Improve this page.