Guia de configuração do Ollama

Passo 1. Instalar o Ollama

O Ollama é o app gratuito que roda modelos de IA no seu próprio computador. Baixe no site oficial o instalador do seu sistema.

• macOS: abra o arquivo baixado, arraste o Ollama para Aplicativos e abra-o. Enquanto roda, um ícone de lhama aparece na barra de menus.
• Windows: execute o OllamaSetup.exe e siga as instruções. O Ollama inicia em segundo plano e mostra um ícone na bandeja.
• Linux: execute o script de uma linha abaixo, que também configura o serviço em segundo plano.

curl -fsSL https://ollama.com/install.sh | sh

Para conferir se funciona, abra http://localhost:11434 no navegador. Você deve ver “Ollama is running”.

Passo 2. Permitir a conexão do mysnipbox (OLLAMA_ORIGINS)

macOS

1. 1Feche o Ollama pelo ícone na barra de menus.
2. 2Abra o Terminal e execute o comando abaixo. Ele define a variável para os apps que você abrir a partir de agora.
3. 3Abra o Ollama de novo.

launchctl setenv OLLAMA_ORIGINS "*"

Prefere o terminal? Feche o app do Ollama e inicie o servidor você mesmo com o comando abaixo, mantendo essa janela aberta:

OLLAMA_ORIGINS="*" ollama serve

O launchctl setenv só vale até você reiniciar o Mac, então execute-o de novo depois de reiniciar (ou coloque-o em um script de login).

Windows

1. 1Feche o Ollama pela bandeja do sistema (clique com o botão direito no ícone → Quit).
2. 2Abra o menu Iniciar, procure por Editar as variáveis de ambiente da sua conta e abra.
3. 3Em Variáveis de usuário, clique em Novo…, digite OLLAMA_ORIGINS como nome da variável e * como valor, e clique em OK.
4. 4Inicie o Ollama de novo pelo menu Iniciar.

Linux (systemd)

Execute sudo systemctl edit ollama.service, adicione as duas linhas abaixo, salve e execute sudo systemctl daemon-reload && sudo systemctl restart ollama.

[Service]
Environment="OLLAMA_ORIGINS=*"

Passo 3. Baixar os modelos recomendados

O mysnipbox usa dois tipos de modelo. Você pode baixá-los pelo próprio app com um clique ou pelo terminal. O ollama run baixa o modelo na primeira vez e depois abre um chat (digite /bye para sair). Para só baixar, use ollama pull <modelo>.

Extração de tags (visão)

• Llama 3.2 Vision (11B): análise profunda e de alta qualidade. É um download grande (cerca de 8 GB) e exige bastante memória.
• Qwen2.5-VL 7B: um modelo equilibrado e menor (cerca de 6 GB).

ollama run llama3.2-vision
ollama run qwen2.5vl:7b

Tradução de tags (texto)

• Qwen2.5 (3B): leve e rápido, preserva bem o vocabulário coreano, chinês e japonês.

ollama run qwen2.5:3b

Passo 4. Conferir no mysnipbox

1. 1Abra o mysnipbox e vá em Settings.
2. 2Na seção do provedor de visão, escolha Ollama. O status deve aparecer como Running.
3. 3Seus modelos locais baixados aparecem na lista de modelos. Escolha um para extrair tags (visão) e outro para traduzi-las (texto).
4. 4Analise uma imagem de teste. A primeira requisição demora mais enquanto o modelo é carregado na memória.

Ainda não foi detectado?

• Confirme que o Ollama está rodando: http://localhost:11434 no navegador deve mostrar “Ollama is running”.
• Refaça o passo 2 e depois feche o Ollama por completo e abra de novo. A variável só é lida quando o Ollama inicia.
• Modelo não listado: baixe-o primeiro e confira se o nome é exatamente igual. O ollama list mostra o que está instalado.
• Mais sobre hardware, servidores remotos e solução de problemas: Modelos locais (Ollama).