Saltar para o conteúdo

Documentação

Tudo o que precisa para instalar o dragoman, ligar um modelo e mantê-lo a funcionar.

Instalar

Instale o dragoman a partir da loja do seu navegador e ele mantém-se atualizado automaticamente.

Chrome, Edge, Helium e outros navegadores Chromium
Instalar uma versão manualmente

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

  1. 1 Transfira o zip para Chrome da versão mais recente e descompacte-o.
  2. 2 Abra helium://extensions, ou chrome://extensions noutros navegadores, e ative o Modo de programador.
  3. 3 Escolha Carregar expandida e selecione a pasta descompactada.
Abrir a versão mais recente

Afixe o dragoman na barra de ferramentas para o ter à distância de um clique.

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

Traduza a sua primeira página

Abra qualquer site, clique no ícone do dragoman, escolha um idioma e selecione Traduzir página. Alt+Shift+T, ou Option+Shift+T num Mac, faz o mesmo a partir do teclado. As traduções iniciais aparecem com um sublinhado dourado pontilhado, que desaparece à medida que o modelo melhora cada parágrafo.

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

Como se lê uma página traduzida

Traduzido no seu dispositivo
Mochi está atualmente promovido a editor em chefe.
Melhorado pelo modelo que escolher
Entretanto, a Mochi foi promovida a diretora.
O original à distância do cursor
Pouse o cursor sobre qualquer parágrafo para ler o texto original. Um clique no emblema, ou Alt+Shift+T, repõe a página inteira.

Num telemóvel ou tablet, abra o dragoman a partir do menu de extensões do navegador.

Comparado com o tradutor do navegador

O Chrome, o Edge, o Safari e o Firefox conseguem traduzir páginas sozinhos e, para uma vista de olhos, muitas vezes chega. O dragoman é para quando quer mesmo ler uma página: acerta no sentido e nas palavras, e é o utilizador que decide quem vê o texto.

Lê a página inteira

Os tradutores integrados percorrem a página em pequenos pedaços, cada um isolado, por isso a mesma palavra pode sair de duas maneiras com poucas linhas de distância. O dragoman mostra ao seu modelo de IA o título da página, os cabeçalhos e as expressões que se repetem, para que um nome, etiqueta ou termo mantenha a mesma tradução do início ao fim.

Parte a parte

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

Com a página inteira à vista

Περίοδος
1910–1915
Term
Περίοδος
1917–1920
Term
Περίοδος
1928–1932
Term
Περίοδος
1933
Term
Um exemplo: uma etiqueta grega, repetida ao longo de uma caixa de informação, traduzida para inglês.

Decide para onde vai o texto

Quando o Chrome ou o Edge traduzem uma página, enviam o texto para a Google ou para a Microsoft. O dragoman traduz no seu dispositivo e depois envia apenas o que está a ler para o fornecedor que escolheu, com a sua própria chave. Se mantiver tudo no dispositivo, nenhum texto da página sai.

Para onde vai o texto da página

Chrome Google Edge Microsoft dragoman O seu dispositivo O seu fornecedor de IA apenas o que lê, se adicionar um modelo
Escolhe o tradutor
O Chrome traduz páginas com o Google Tradutor e o Edge com o Microsoft Translator. O dragoman funciona com o modelo de IA que escolher, seja o Claude, o Gemini, os modelos do ChatGPT ou um a correr no seu próprio computador. Os modelos de IA atuais lidam geralmente melhor com expressões idiomáticas, tom e palavras cujo sentido depende da frase.
O original fica sempre à mão
Passe o cursor sobre qualquer parágrafo, ou toque nele no telemóvel, para ler o texto original, sem repor a página inteira.

O tradutor do seu navegador é integrado, gratuito e não precisa de configuração. As versões locais do dragoman também são gratuitas, e a melhoria custa apenas o que o seu fornecedor cobra pelo texto que lê, normalmente muito pouco com um modelo pequeno. O tradutor do Firefox usa o Bergamot, o mesmo motor com que o dragoman traduz no Firefox, por isso aí a diferença está na passagem de IA e no contexto da página.

Por dentro
Duas passagens
O modelo no dispositivo do seu navegador faz o rascunho em segundo plano e, onde não existe, entra o Bergamot, compilado para WebAssembly. Os parágrafos no ecrã e os seguintes vão depois para o seu modelo em pequenos lotes, e cada parágrafo melhorado substitui o respetivo rascunho.
Contexto da página
Cada pedido inclui o título da página, um esquema dos cabeçalhos, as expressões que se repetem na página com o texto em redor da primeira ocorrência e todas as traduções já fixadas. O modelo devolve os termos que escolheu e os pedidos seguintes respeitam-nos.
Formatação
Ligações, ênfases e outros elementos em linha viajam como marcadores numerados, para que o esquema e as ligações voltem intactos.
Só o que lê
O refinamento acompanha a área visível, por isso uma página longa custa apenas a parte que percorre. As traduções concluídas ficam guardadas no seu dispositivo e são reutilizadas quando voltar.
Sem intermediários
Os pedidos vão diretamente do seu navegador para o seu fornecedor, com a sua chave. Não há servidor do dragoman e todo o código é público.

Tradução no dispositivo

Todas as páginas começam no seu dispositivo. O dragoman faz o rascunho com o modelo integrado no Chrome e no Edge, e com o da Apple no Safari. Estes funcionam no seu computador, ao contrário da tradução de páginas dos próprios navegadores, que passa pela internet. Em todos os outros casos, e para qualquer idioma que estes não suportem, é o Bergamot, o motor aberto do Firefox Translations, que traduz dentro do navegador. Nada disto exige conta nem chave. Por si só, obtém uma tradução rápida e privada. Com um modelo de IA, esses rascunhos tornam-se uma primeira versão que o seu modelo aperfeiçoa.

Uma única transferência 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 transfere as duas metades.

Tamanhos de transferência indicados no registo de modelos da Mozilla.
Idiomas
Mais de 50 idiomas, de e para 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.
Primeira utilização
O Chrome e o Edge transferem os pacotes de idioma da primeira vez que precisa deles, e o Safari usa os idiomas transferidos para a tradução da Apple no seu dispositivo. Os pares de idiomas do Bergamot são transferidos uma única vez a partir da Mozilla, normalmente entre 15 e 50 MB, e ficam no seu navegador. A partir daí, tudo funciona offline.
Rascunhos e melhoria
Os rascunhos são rápidos e bastante literais, bons para perceber a ideia geral. O seu modelo reescreve-os com a página inteira à vista, para que o texto soe natural e os nomes e termos se mantenham coerentes.
A escolha é sua
Para manter uma página no seu dispositivo mesmo com um modelo configurado, ative Só neste dispositivo na janela pop-up. Para dispensar os rascunhos e esperar pelo seu modelo, desative Traduzir primeiro neste dispositivo nas Definições.

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

Adicionar um modelo de IA

Abra as Definições a partir do popup, escolha um fornecedor e siga os três passos. O dragoman verifica a chave assim que a cola e pré-seleciona um modelo rápido e económico, que pode alterar a qualquer momento.

Fornecedores que pode usar

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

O OpenRouter pode criar uma chave por si. Escolha Ligar com OpenRouter e aprove o pedido.

As chaves da Anthropic que não estão associadas a um espaço de trabalho também precisam de um ID do espaço de trabalho. Encontra-o na Anthropic Console, em Settings e depois Workspaces.

Usar um modelo local

Instale o Ollama, transfira um modelo como o gemma3 e inicie-o com OLLAMA_ORIGINS definido para aceitar pedidos da extensão:

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

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

Quanto custa

O dragoman é gratuito. A melhoria usa a sua própria chave, por isso é o fornecedor que lhe cobra diretamente. Para traduzir, os modelos pequenos e rápidos costumam bastar. O separador Utilização, nas Definições, conta os tokens por modelo em cada mês, e ao ativar Mostrar o custo de cada página verá o custo da página atual junto ao distintivo.

4 de 14 parágrafos melhorados

  • Melhorado
  • Rascunho
  • Ainda não

À medida que percorre a página, os parágrafos logo a seguir recebem um rascunho rápido e os que estão no ecrã são melhorados. O resto da página não custa nada até lá chegar.

Privacidade

O que sai do seu computador: os parágrafos no ecrã e os que vêm logo a seguir, mais qualquer texto que peça ao seu companheiro para traduzir, enviados ao fornecedor que escolheu, e, para idiomas que o navegador não traduz sozinho, uma transferência única de modelo a partir da Mozilla. A sua chave só é enviada ao respetivo fornecedor. O dragoman não tem servidor, conta nem estatísticas.

Ler a política de privacidade completa

Resolução de problemas

O popup diz que a página não pode ser traduzida

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

O motor local não tem modelo para este par

Os tradutores locais abrangem os idiomas mais usados. No Safari, pode adicionar mais em Idiomas de tradução, nas definições de Idioma e região do dispositivo. Para os restantes, adicione um modelo de IA e o dragoman traduz diretamente com ele.

O meu navegador também se oferece para traduzir a página

O dragoman pede ao navegador que não interfira nas páginas que poderia traduzir. Se desativou isso, ative Manter o tradutor do navegador afastado nas Definições, em Idiomas. Se o navegador já traduziu uma página, escolha Usar o dragoman para a recarregar no original.

Um modelo local não liga

Confirme que o servidor está em execução e que o endereço nas Definições corresponde. 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-no escolher que sites uma extensão pode ler. Abra o dragoman e escolha Permitir em todos os sites.

O Firefox não melhora com o meu modelo

O Firefox pergunta antes de uma extensão enviar texto da página para algum lado. Abra as Definições e escolha Permitir envio do texto da página, por baixo do seu modelo.

Compilar a partir do código-fonte

O dragoman é open source sob a licença MIT. Para o compilar, 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 a sua própria compilação. Execute estes comandos a partir de 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 pnpm:

extension/
A extensão, feita com WXT e Svelte
site/
Este site, feito com SvelteKit
brand/
Os dragomans, o logótipo e a cidade
messages/
Texto da interface em 85 idiomas