# Instalação

::: info Notícias
🍎 **A extensão nativa do Safari já está disponível!** É totalmente gratuita e suporta a instalação com um clique.
:::

Escolha o seu caminho.

> ⚠️ Nota: O Gestor de Prompts é a única funcionalidade que suporta Gemini™ para Enterprise.

## 1. Lojas de Extensões (Recomendado)

A forma mais simples de começar. As atualizações são automáticas.

**Chrome / Brave / Opera / Vivaldi:**

[<img src="https://img.shields.io/badge/Chrome_Web_Store-Download-4285F4?style=for-the-badge&logo=google-chrome&logoColor=white" alt="Instalar da Chrome Web Store" height="40"/>](https://chromewebstore.google.com/detail/iifacdnjakkhjjiengaffnegbndgingi?utm_source=github&utm_medium=docs&utm_campaign=organic_growth&utm_content=pt)

**Microsoft Edge:**

[<img src="https://img.shields.io/badge/Microsoft_Edge-Download-0078D7?style=for-the-badge&logo=microsoft-edge&logoColor=white" alt="Instalar do Microsoft Edge Add-ons" height="40"/>](https://microsoftedge.microsoft.com/addons/detail/gemini-voyager/gibmkggjijalcjinbdhcpklodjkhhlne)

> ⚠️ A versão do Edge Add-ons será descontinuada: fica congelada na versão atual e não receberá mais atualizações. Usuários do Edge devem instalar pela Chrome Web Store acima; esse link também funciona no Edge.

**Firefox:**

[<img src="https://img.shields.io/badge/Firefox_Add--ons-Download-FF7139?style=for-the-badge&logo=firefox&logoColor=white" alt="Instalar do Firefox Add-ons" height="40"/>](https://addons.mozilla.org/firefox/addon/gemini-voyager/)

## 2. A Via Manual (Funcionalidades Mais Recentes)

O processo de revisão da Web Store pode ser lento. Se quiser a versão de ponta imediatamente, instale manualmente.

**Para Chrome / Edge / Brave / Opera:**

1. Descarregue o último `gemini-voyager-chrome-vX.Y.Z.zip` das [Releases do GitHub](https://github.com/Nagi-ovo/gemini-voyager/releases).
2. Descompacte o ficheiro.
3. Abra a página de Extensões do seu navegador (`chrome://extensions`).
4. Ative o **Modo de programador** (canto superior direito).
5. Clique em **Carregar expandida** e selecione a pasta que acabou de descompactar.

**Para Firefox:**

1. Descarregue o último `gemini-voyager-firefox-vX.Y.Z.xpi` das [Releases](https://github.com/Nagi-ovo/gemini-voyager/releases).
2. Abra o Gestor de Add-ons (`about:addons`).
3. Arraste e largue o ficheiro `.xpi` para instalar (ou clique no ícone de engrenagem ⚙️ -> **Instalar Add-on de Ficheiro**).

> 💡 O ficheiro XPI é oficialmente assinado pela Mozilla e pode ser instalado permanentemente em todas as versões do Firefox.

## 3. Safari (macOS)

O Safari agora suporta distribuição direta! Descarregue a aplicação pré-assinada:

1. Descarregue a <SafariDownloadLink>última versão do Safari (.dmg)</SafariDownloadLink>.
2. Abra o ficheiro e siga as instruções para instalar.
3. Clique duas vezes para iniciar a aplicação.
4. Ative a extensão nas **Definições do Safari > Extensões**.

> 💡 A versão do Safari está agora diretamente assinada para distribuição — não é necessária conversão com Xcode!
>
> ⚠️ **Limitações**: Devido à natureza do Safari, (a) a remoção de marca d'água (b) a exportação de imagens (PDF recomendado) não são suportadas.

---

_Configuração de desenvolvimento? Se é um programador à procura de contribuir, consulte o nosso [Guia de Contribuição](https://github.com/Nagi-ovo/gemini-voyager/blob/main/.github/CONTRIBUTING.md)._