Configurar Odysseus AI com Ollama: conectar modelo local

Escolha o endpoint do Ollama conforme o runtime

O erro mais comum ao configurar Odysseus AI com Ollama é copiar uma URL localhost nativa para dentro de um container Docker. O endpoint deve ser acessível pelo processo do Odysseus, não apenas pelo computador onde o serviço foi instalado.

Use host.docker.internal:11434/v1 quando o Odysseus AI estiver no Docker e o Ollama no host. Use 127.0.0.1:11434/v1 quando os dois serviços forem nativos. Teste o Ollama e confirme um modelo antes de depurar prompts ou agentes.

http://host.docker.internal:11434/v1

Configuração Docker para o Ollama no host

Uma configuração do Odysseus AI com Ollama no Docker atravessa uma fronteira de rede. localhost dentro do container aponta para o próprio container; por isso o endpoint do host deve ser explícito e o Ollama precisa escutar em um endereço alcançável.

Mantenha o primeiro teste local: prove uma rota entre o container e o Ollama antes de publicar portas ou trocar tags de modelos.

1. Inicie o Ollama para escutar além do loopback quando necessário

Se o Docker não alcançar o Ollama, inicie-o com um binding de host explícito. Limite-o ao uso local confiável se não entender a exposição da rede.

OLLAMA_HOST=0.0.0.0:11434 ollama serve

2. Confirme que o Ollama tem pelo menos um modelo

O Odysseus AI pode alcançar o endpoint e ainda não mostrar um modelo útil se o Ollama não tiver baixado nenhum. Baixe primeiro um modelo pequeno para testar a conexão.

ollama list
ollama pull llama3.2:3b

3. Insira o endpoint Docker nas configurações do Odysseus AI

Use a base URL compatível com OpenAI nas configurações do modelo ou serviço. Não use localhost neste caminho Docker-host, a menos que o Docker esteja configurado de outra forma.

http://host.docker.internal:11434/v1

4. Verifique a saúde do contêiner antes de depurar prompts

Se o serviço Odysseus estiver degradado, corrija-o primeiro. Um endpoint de modelo não conserta um início de contêiner quebrado, um arquivo de ambiente ausente ou uma dependência não saudável.

docker compose ps
docker compose logs --tail=120 odysseus

Configuração nativa do Ollama no Windows, Linux e macOS

Quando Odysseus AI e Ollama rodam nativamente na mesma sessão, localhost normalmente aponta para a máquina esperada. A porta da interface pode variar, mas o Ollama costuma usar 11434 quando OLLAMA_HOST não foi alterado.

Para decisões específicas de Mac, siga o guia de macOS; para Windows e hardware, use as páginas existentes de setup e requisitos sem misturar outra intenção nesta página.

Corrigir erros de provider e endpoint entre Odysseus AI e Ollama

Leia os erros por camadas: processo do Ollama, endpoint acessível, modelo listado, configuração do provider e só depois prompts. Assim um problema de rede não parece um problema do modelo.

Checklist final antes de confiar no setup

Uma configuração funcional deve passar por estas verificações na ordem. Pare na primeira falha e corrija essa camada antes de avançar.

1. Ollama responde no host e ollama list mostra um modelo.
2. O serviço Odysseus está saudável no Docker ou nos logs nativos.
3. O endpoint corresponde à estrutura do runtime.
4. Um prompt pequeno funciona antes de agentes maiores ou fluxos de documentos.
5. Qualquer exposição à LAN é autenticada e intencional.

Notas de verificação 2026 para configurar Odysseus AI com Ollama

Antes de mudar o nome do modelo, verifique o limite do runtime e a URL base. O mesmo servidor Ollama pode usar localhost no modo nativo e host.docker.internal no container.

Um exemplo seguro é listar um modelo, testar o endpoint a partir da mesma camada que executa o Odysseus AI e só então salvar a configuração. Se a primeira chamada falhar, mantenha a tag do modelo até provar a conectividade.

1. A nova secao separa Docker, execucao nativa e endpoints Ollama antes de alterar configuracoes.
2. Atualizado com notas 2026 sobre fontes oficiais, execucao local, Ollama e guias relacionados.
3. Mantenha a intenção desta página separada dos guias de configuração relacionados.