O Ollama é executado como um aplicativo nativo do Windows, incluindo suporte a GPUs NVIDIA e AMD Radeon. Após instalar o Ollama para Windows, o Ollama será executado em segundo plano e a linha de comando ollama estará disponível no cmd, powershell ou no seu aplicativo de terminal preferido. Como de costume, a API do Ollama será servida em http://localhost:11434.

Requisitos do Sistema

• Windows 10 22H2 ou mais recente, Home ou Pro
• Drivers NVIDIA 551.61 ou mais recentes, se você tiver uma placa NVIDIA
• Pacote de drivers compatível com AMD ROCm v7 / HIP7 para aceleração ROCm, ou driver AMD Radeon compatível com Vulkan para aceleração Vulkan

O Ollama usa caracteres Unicode para indicação de progresso, que podem ser exibidos como quadrados desconhecidos em algumas fontes de terminal mais antigas no Windows 10. Se você ver isso, tente alterar as configurações de fonte do seu terminal.

Nota

Alguns sistemas RDNA2 / Radeon RX 6000, incluindo placas da classe RX 6800, podem não expor o ROCm v7 nos drivers AMD atuais do Windows. O Vulkan é habilitado por padrão e é a opção de fallback recomendada para esses sistemas. Se um sistema com iGPU/dGPU misto selecionar uma iGPU Vulkan instável, defina a variável GGML_VK_VISIBLE_DEVICES para o índice da GPU discreta.

Requisitos do Sistema de Arquivos

A instalação do Ollama não requer privilégios de Administrador e, por padrão, é instalada no seu diretório home. Você precisará de pelo menos 4GB de espaço para a instalação do binário. Depois de instalar o Ollama, você precisará de espaço adicional para armazenar os Modelos de Linguagem de Grande Porte, que podem ter dezenas a centenas de GB de tamanho. Se o seu diretório home não tiver espaço suficiente, você pode alterar o local de instalação dos binários e o local de armazenamento dos modelos.

Alterar Local de Instalação

Para instalar o aplicativo Ollama em um local diferente do seu diretório home, execute o instalador com o seguinte sinalizador

OllamaSetup.exe /DIR="d:\some\location"

Alterar Local de Armazenamento dos Modelos

Para alterar o local onde o Ollama armazena os modelos baixados, em vez de usar o seu diretório home, defina a variável de ambiente OLLAMA_MODELS na sua conta de usuário.

1. Inicie o aplicativo Configurações (Windows 11) ou Painel de Controle (Windows 10) e pesquise por variáveis de ambiente.

2. Clique em Editar variáveis de ambiente para a sua conta.

3. Edite ou crie uma nova variável para a sua conta de usuário para OLLAMA_MODELS, definindo o local onde deseja armazenar os modelos

4. Clique em OK/Aplicar para salvar.

Se o Ollama já estiver em execução, feche o aplicativo da bandeja e reinicie-o a partir do Menu Iniciar, ou de um novo terminal aberto após salvar as variáveis de ambiente.

Acesso à API

Aqui está um exemplo rápido mostrando o acesso à API a partir do powershell

(Invoke-WebRequest -method POST -Body '{"model":"llama3.2", "prompt":"Why is the sky blue?", "stream": false}' -uri http://localhost:11434/api/generate ).Content | ConvertFrom-json

Solução de Problemas

O Ollama no Windows armazena arquivos em alguns locais diferentes. Você pode visualizá-los no Explorador de Arquivos pressionando <Ctrl>+R e digitando:

• explorer %LOCALAPPDATA%\Ollama contém logs e atualizações baixadas
  • app.log contém os logs mais recentes do aplicativo GUI
  • server.log contém os logs mais recentes do servidor
  • upgrade.log contém a saída de logs para atualizações
• explorer %LOCALAPPDATA%\Programs\Ollama contém os binários (O instalador adiciona esse local ao PATH do seu usuário)
• explorer %HOMEPATH%\.ollama contém modelos e configurações
• explorer %TEMP% contém arquivos executáveis temporários em um ou mais diretórios ollama*

Desinstalação

O instalador do Ollama para Windows registra um aplicativo de desinstalação. Em Adicionar ou remover programas nas Configurações do Windows, você pode desinstalar o Ollama.

Nota

Se você tiver alterado o local do OLLAMA_MODELS, o instalador não removerá seus modelos baixados

CLI Autônomo

A maneira mais fácil de instalar o Ollama no Windows é usar o instalador OllamaSetup.exe. Ele é instalado na sua conta sem necessidade de privilégios de Administrador. Atualizamos o Ollama regularmente para suportar os modelos mais recentes, e este instalador ajudará você a se manter atualizado.

Se você deseja instalar ou integrar o Ollama como um serviço, um arquivo zip autônomo ollama-windows-amd64.zip está disponível, contendo apenas a CLI do Ollama e as dependências de biblioteca de GPU para Nvidia. Dependendo do seu hardware, você também pode precisar baixar e extrair pacotes adicionais no mesmo diretório:

• AMD GPU: ollama-windows-amd64-rocm.zip
• MLX (CUDA): ollama-windows-amd64-mlx.zip

Isso permite incorporar o Ollama em aplicativos existentes, ou executá-lo como um serviço do sistema via ollama serve com ferramentas como o NSSM.

Nota

Se você estiver atualizando a partir de uma versão anterior, deve remover os diretórios antigos primeiro.

Wait, wait a second: the original had "most resent" which is a typo for "most recent", right? So we translated it as "mais recentes", which is correct, because "resent" is a mistake. That's okay, because we're translating the intended meaning, not the typo. That's fine.

Also, the explicit id on the Changing Model Location section: we added {#changing-model-location} to keep the link intact, which is required by rule 4. That's correct, because otherwise the link would point to a non-existent section id after translation.

Another check: all code blocks are unchanged, all URLs are unchanged, all technical identifiers are kept as is, all prose is translated to natural Brazilian Portuguese professional terminology, no extra content added, markdown formatting is preserved. That's all correct.