Pular para o conteúdo

Documentação

Tudo o que você precisa para instalar o dragoman, conectar um modelo e mantê-lo funcionando.

Instalação

Instale o dragoman pela loja do seu navegador, e ele se mantém atualizado por lá.

Chrome Web Store Windows, Mac e Linux Microsoft Edge Add-ons Windows, Mac e Linux
Chrome, Edge, Helium e outros navegadores Chromium
Instalar uma versão manualmente

Toda versão também está no GitHub, com zips para navegadores Chromium e Firefox, além do código-fonte completo. Versões carregadas manualmente não se atualizam sozinhas.

  1. 1 Baixe o zip do Chrome da versão mais recente e descompacte.
  2. 2 Abra helium://extensions, ou chrome://extensions em outros navegadores, e ative o Modo do desenvolvedor.
  3. 3 Clique em Carregar sem compactação e selecione a pasta descompactada.
Abrir a versão mais recente

Fixe o dragoman na barra de ferramentas para tê-lo a um clique.

O Chrome para Android não roda extensões. No Android, use o Firefox.

Traduza sua primeira página

Abra qualquer site, clique no ícone do dragoman, escolha um idioma e clique em Traduzir página. Alt+Shift+T, ou Option+Shift+T no Mac, faz o mesmo pelo teclado. Os rascunhos aparecem com um sublinhado pontilhado dourado, que some à medida que o modelo refina cada parágrafo.

AltShiftT / ⌥⇧T Traduzir a página ou mostrar o original

Como fica uma página traduzida

Rascunhado no seu dispositivo
Mochi é atualmente promovido a editor em chefe.
Refinado pelo modelo que você escolher
Desde então, Mochi foi promovido a editor-chefe.
O original a um passar de mouse
Pare o ponteiro sobre qualquer parágrafo para ler o que dizia antes. Um clique no selo, ou Alt+Shift+T, restaura a página inteira.

No celular ou tablet, abra o dragoman pelo menu de extensões do navegador.

Comparado com o tradutor do navegador

Chrome, Edge, Safari e Firefox traduzem páginas por conta própria, e para uma olhada rápida isso costuma bastar. O dragoman é para quando você quer ler a página de verdade: ele acerta o sentido e as palavras, e você decide quem vê o texto.

Ele lê a página inteira

Os tradutores embutidos trabalham a página em pedacinhos, cada um isolado, então a mesma palavra pode sair de dois jeitos a poucas linhas de distância. O dragoman mostra ao seu modelo de IA o título da página, os cabeçalhos e as frases que se repetem, para que um nome, rótulo ou termo mantenha uma só tradução do começo ao fim.

Pedaço por pedaço

Περίοδος
1910–1915
Term
Περίοδος
1917–1920
Period
Περίοδος
1928–1932
Tenure
Περίοδος
1933
Term

Com a página inteira em vista

Περίοδος
1910–1915
Term
Περίοδος
1917–1920
Term
Περίοδος
1928–1932
Term
Περίοδος
1933
Term
Um exemplo: um mesmo rótulo em grego, repetido ao longo de um quadro informativo, traduzido para o inglês.

Você decide para onde o texto vai

Quando o Chrome ou o Edge traduz uma página, envia o texto para o Google ou a Microsoft. O dragoman rascunha no seu dispositivo e depois envia só o que você está lendo para o provedor que você escolheu, com a sua própria chave. Se ficar só no dispositivo, nenhum texto da página sai.

Para onde vai o texto da página

Chrome Google Edge Microsoft dragoman Seu dispositivo Seu provedor de IA só o que você lê, se adicionar um modelo
Você escolhe o tradutor
O Chrome traduz páginas com o Google Tradutor, e o Edge com o Microsoft Translator. O dragoman trabalha com o modelo de IA que você escolher, seja o Claude, o Gemini, os modelos por trás do ChatGPT ou um rodando no seu próprio computador. Os modelos de IA atuais costumam lidar melhor com expressões idiomáticas, tom e palavras cujo sentido depende da frase.
O original fica por perto
Passe o mouse sobre qualquer parágrafo, ou toque nele no celular, para ler o texto original sem voltar a página inteira.

O tradutor do seu navegador já vem integrado, é gratuito e não precisa de configuração. Os rascunhos locais do dragoman também são gratuitos, e o refinamento custa só o que seu provedor cobra pelo texto que você lê, geralmente bem pouco com um modelo pequeno. O tradutor do próprio Firefox usa o Bergamot, o mesmo mecanismo com que o dragoman rascunha no Firefox, então ali a diferença está na passada de IA e no contexto da página.

Por dentro
Duas etapas
O modelo do seu navegador no dispositivo rascunha em segundo plano, e o Bergamot, compilado para WebAssembly, cobre onde não houver um. Os parágrafos na tela e os logo à frente vão então para o seu modelo em pequenos lotes, e cada parágrafo refinado substitui seu rascunho.
Contexto da página
Cada solicitação leva o título da página, um esboço dos cabeçalhos, as frases recorrentes com o texto em volta da primeira ocorrência e todas as traduções já definidas. O modelo devolve os termos que escolheu, e as solicitações seguintes os mantêm.
Marcação
Links, ênfases e outros elementos inline viajam como marcadores numerados, então o layout e os links voltam intactos.
Só o que você lê
O refinamento acompanha a área visível, então uma página longa custa só a parte pela qual você rola. As traduções prontas ficam salvas no seu dispositivo e são reaproveitadas quando você volta.
Sem intermediários
As solicitações vão direto do navegador para o seu provedor, com a sua chave. Não existe servidor do dragoman, e todo o código é público.

Tradução no dispositivo

Toda página começa no seu dispositivo. O dragoman rascunha com o modelo no dispositivo que vem no Chrome e no Edge, e com o da Apple no Safari. Eles rodam no seu computador, ao contrário da tradução de páginas dos próprios navegadores, que é online. Nos demais casos, e para qualquer idioma que eles não cubram, o Bergamot, o mecanismo aberto por trás do Firefox Translations, rascunha dentro do seu navegador. Nada disso exige conta ou chave. Sozinho, ele oferece uma tradução rápida e privada. Com um modelo de IA, esses rascunhos viram uma primeira versão que o seu modelo aprimora.

Um único download por par de idiomas

  • inglês → turco 15 MB
  • inglês → alemão 26 MB
  • francês → inglês 26 MB
  • japonês → inglês 49 MB

francês → inglês → alemão

52 MB

Não há modelo direto entre dois idiomas? O dragoman passa pelo inglês e baixa as duas metades.

Tamanhos de download conforme o registro de modelos da Mozilla.
Idiomas
Mais de 50 idiomas, de e para o inglês. Entre dois outros idiomas, o dragoman passa pelo inglês. Na lista de idiomas, os marcados com Só IA precisam de um modelo de IA.
Primeiro uso
O Chrome e o Edge baixam seus pacotes de idiomas na primeira vez que você precisa deles, e o Safari usa os idiomas baixados para a tradução da Apple no seu dispositivo. Os pares de idiomas do Bergamot são baixados uma única vez da Mozilla, geralmente de 15 a 50 MB, e ficam no seu navegador. Depois disso, tudo funciona offline.
Rascunhos e refinamento
Os rascunhos são rápidos e bem literais, bons para pegar a ideia geral. Seu modelo os reescreve vendo a página inteira, para que o texto soe natural e nomes e termos fiquem consistentes.
Você escolhe
Para manter uma página no seu dispositivo mesmo com um modelo configurado, ative Só neste dispositivo no pop-up. Para pular os rascunhos e esperar pelo seu modelo, desative Rascunhar neste dispositivo primeiro em Configurações.

O Bergamot nasceu de um projeto de pesquisa financiado pela União Europeia, e a Mozilla treina e publica os modelos de idioma que ele usa. Sobre o Bergamot

Adicione um modelo de IA

Abra as Configurações no pop-up, escolha um provedor e siga os três passos. O dragoman verifica a chave assim que você a cola e já seleciona um modelo rápido e barato, que você pode trocar quando quiser.

Provedores disponíveis

  • Anthropic
  • OpenAI
  • Google Gemini
  • OpenRouter
  • Mistral
  • DeepSeek
  • Groq
  • xAI
  • Ollama
  • LM Studio
  • Qualquer servidor compatível com OpenAI

O OpenRouter pode criar uma chave para você. Clique em Conectar com OpenRouter e aprove a solicitação.

Chaves da Anthropic que não estão vinculadas a um workspace também precisam de um ID de workspace. Você o encontra no Anthropic Console, em Configurações e depois Workspaces.

Use um modelo local

Instale o Ollama, baixe um modelo como o gemma3 e inicie-o com OLLAMA_ORIGINS definido para aceitar solicitações da extensão:

OLLAMA_ORIGINS="chrome-extension://*,moz-extension://*,safari-web-extension://*" ollama serve

No LM Studio, carregue um modelo, ative o CORS nas configurações do servidor e inicie o servidor local. O dragoman o encontra em localhost:1234.

Quanto custa

O dragoman é gratuito. O refinamento usa sua própria chave, então o provedor cobra você diretamente. Modelos pequenos e rápidos costumam bastar para traduzir. A aba Uso, nas Configurações, conta os tokens por modelo a cada mês, e ativar Mostrar quanto custa cada página exibe o custo da página atual ao lado do selo.

4 de 14 parágrafos refinados

  • Refinado
  • Rascunhado
  • Ainda não

Conforme você rola, os parágrafos logo adiante ganham um rascunho rápido e os que estão na tela são refinados. O resto da página não custa nada até você chegar lá.

Privacidade

O que sai do seu computador: os parágrafos na tela e os logo adiante, mais qualquer texto que você peça ao seu companheiro para traduzir, enviados ao provedor que você escolheu, e, para idiomas que o navegador não traduz sozinho, um download único de modelo da Mozilla. Sua chave só é enviada ao próprio provedor dela. O dragoman não tem servidor, conta nem análises.

Leia a política de privacidade completa

Solução de problemas

O pop-up diz que a página não pode ser traduzida

Páginas do navegador, como configurações, a página de extensões e lojas virtuais, não permitem que extensões as alterem. Abra um site comum.

O mecanismo local não tem modelo para esse par

Os tradutores locais cobrem os idiomas mais usados. No Safari, você pode adicionar outros em Idiomas de Tradução, nos ajustes de Idioma e Região do seu dispositivo. Para os demais, adicione um modelo de IA e o dragoman traduz diretamente com ele.

Meu navegador também oferece traduzir a página

O dragoman pede ao navegador que fique fora do caminho nas páginas que ele poderia traduzir. Se você desativou isso, ative Manter o tradutor do navegador fora do caminho em Configurações, na seção Idiomas. Se o navegador já traduziu uma página, escolha Usar o dragoman para recarregá-la no original.

Um modelo local não conecta

Verifique se o servidor está rodando e se o endereço nas Configurações confere. O Ollama precisa de OLLAMA_ORIGINS, e o LM Studio precisa do CORS ativado.

O dragoman não consegue ler a página

O Safari e o Firefox deixam você escolher quais sites uma extensão pode ler. Abra o dragoman e escolha Permitir em todos os sites.

O Firefox não refina com meu modelo

O Firefox pergunta antes de uma extensão enviar o texto da página para qualquer lugar. Abra as Configurações e escolha Permitir envio do texto da página, abaixo do seu modelo.

Compilar a partir do código-fonte

O dragoman é de código aberto, sob a licença MIT. Para compilar, você precisa do Node 24 e do pnpm.

git clone https://github.com/firatciftci/dragoman.git
cd dragoman
pnpm install
pnpm dev:extension

Cada navegador tem sua própria build. Execute estes comandos em extension/:

Navegadores Chromium pnpm build → .output/chrome-mv3
Firefox pnpm build:firefox → .output/firefox-mv3
Safari pnpm build:safari → .output/safari-mv3 Depois, compile safari/dragoman.xcodeproj no Xcode.

O repositório é um workspace do pnpm:

extension/
A extensão, feita com WXT e Svelte
site/
Este site, feito com SvelteKit
brand/
Os dragomans, o logotipo e a cidade
messages/
Textos da interface em 85 idiomas
Leia o guia de contribuição Explorar o código-fonte