# Ollama e Fly.io: agentes de IA rodando em sandbox Linux seguro

> A Ollama Cloud agora pode ser usada dentro dos Sprites da Fly.io, máquinas virtuais Linux isoladas projetadas para executar agentes com segurança. A integração permite que agentes como Claude Code, Codex e Gemini CLI rodem comandos em um sandbox e acessem modelos em nuvem da Ollama sem expor a chave de API, o que importa para quem desenvolve agentes que precisam executar código de forma controlada.

Publicado em 2026-10-13 · https://invision.dreamvision.com.br/blog/ollama-e-fly-io-agentes-de-ia-rodando-em-sandbox-linux-seguro

## Pontos-chave
- Ollama Cloud agora funciona dentro dos Sprites da Fly.io, VMs Linux isoladas para agentes.
- A chave de API da Ollama é criptografada na Fly.io e injetada por um gateway, sem exposição ao código do Sprite.
- Modelos citados incluem kimi-k3, glm-5.3 e deepseek-v4.1-flash.
- Qualquer OpenAI SDK pode ser usado apontando base_url para o gateway da Fly.io.
- Fly.io oferece skill para Claude Code, Cursor, Codex e Gemini CLI usarem Ollama sem configuração extra.

## O que é um Sprite da Fly.io e por que ele importa para agentes?
Um Sprite é um sandbox da Fly.io que consiste em uma máquina virtual Linux completa, com disco próprio que persiste entre sessões. Essa característica é relevante para agentes de IA que precisam executar comandos e manter estado ao longo do tempo.

A Fly.io já suporta ferramentas como Claude Code, Codex e Gemini CLI de fábrica, permitindo que agentes rodem comandos dentro do ambiente isolado. Isso reduz o risco de um agente executar ações destrutivas fora de controle.

- Cada Sprite é uma VM Linux isolada com disco persistente.
- Claude Code, Codex e Gemini CLI são suportados nativamente.
- Agentes podem executar comandos dentro do sandbox com segurança.

## Como funciona o Ollama Connector com a Fly.io?
O novo Ollama Connector permite que os Sprites usem modelos em nuvem da Ollama, como kimi-k3, glm-5.3 e deepseek-v4.1-flash. A configuração é feita adicionando a chave de API da Ollama à organização na Fly.io.

A Fly.io criptografa a chave e não a retorna pela API. Quando o código dentro do Sprite chama a Ollama, a requisição passa por um gateway da Fly.io que identifica qual Sprite está chamando e insere a chave automaticamente. O Sprite conhece apenas a URL do gateway e um ID de conexão.

- Chave da Ollama é armazenada criptografada na organização Fly.io.
- O gateway adiciona a chave à requisição, sem expô-la ao código do Sprite.
- O Sprite só vê a URL do gateway e um connection ID.

## Quais modelos da Ollama podem ser usados nos Sprites?
A integração cita explicitamente os modelos kimi-k3, glm-5.3 e deepseek-v4.1-flash como disponíveis por meio do conector. A notícia não detalha outros modelos ou limites de uso.

Além disso, a Fly.io oferece uma skill que informa ao Claude Code, Cursor, Codex e Gemini CLI sobre a Ollama. Se o Sprite tiver acesso, o agente pode usar modelos Ollama sem configuração adicional.

- Modelos citados: kimi-k3, glm-5.3 e deepseek-v4.1-flash.
- Skill da Fly.io ensina ferramentas como Cursor e Codex a usar Ollama.
- Configuração pode ser automática quando o Sprite tem permissão.

## Como usar o OpenAI SDK com o gateway da Fly.io?
Qualquer SDK compatível com OpenAI pode ser usado apontando base_url para o gateway e definindo qualquer valor para api_key, já que a chave real é injetada pelo gateway. As rotas nativas /api/* da Ollama também funcionam através do gateway.

A página do conector mostra o comando com o connection ID preenchido e sem cabeçalho Authorization, pois o gateway cuida da autenticação. Isso simplifica a integração para quem já usa bibliotecas baseadas no padrão OpenAI.

- Use base_url do gateway e qualquer api_key no SDK.
- Rotas nativas da Ollama (/api/*) são suportadas.
- Não é necessário enviar Authorization header no código do Sprite.

## Como combinar modelos pequenos e grandes em um fluxo de testes?
A Fly.io publicou um guia que usa vários modelos em conjunto. Um modelo pequeno como nemotron-3-nano:30b gera entradas malformadas, um Sprite executa essas entradas contra o programa do usuário, e um modelo maior como kimi-k3 analisa os crashes resultantes.

Para trocar de modelo, basta alterar o campo model na chamada. O guia completo está disponível no quickstart do Ollama Connector.

- Modelo pequeno gera casos de teste; modelo grande analisa falhas.
- Troca de modelo é feita alterando o campo model.
- Fluxo é útil para testes de robustez e fuzzing.

## O que isso muda para quem usa IA?
Para desenvolvedores de agentes, a combinação de sandbox Linux persistente com acesso seguro a modelos em nuvem reduz a fricção de configurar credenciais e isolar execuções. A integração evita expor chaves de API no código do agente, um risco comum em implantações.

A Invision oferece acesso a vários modelos de IA por uma única chave, o que pode simplificar a experimentação com diferentes modelos em projetos de agentes. A notícia não menciona preços ou condições comerciais da Invision.

- Sandbox persistente e gateway de chave simplificam a arquitetura de agentes.
- Invision permite testar vários modelos com uma chave só, sem promessa de preço.
- Integração com OpenAI SDK facilita a adoção por times já familiarizados.

## Perguntas frequentes
### O que é um Sprite da Fly.io?
É um sandbox que consiste em uma máquina virtual Linux completa com disco persistente, projetada para executar agentes de IA com isolamento e segurança.

### Como a chave da Ollama é protegida nos Sprites?
A chave é armazenada criptografada na organização Fly.io e nunca retornada pela API. Um gateway adiciona a chave às requisições feitas de dentro do Sprite, que conhece apenas a URL do gateway e um connection ID.

### Quais modelos da Ollama posso usar com o conector?
A notícia cita kimi-k3, glm-5.3 e deepseek-v4.1-flash. Outros modelos podem estar disponíveis, mas não foram detalhados.

### Preciso configurar algo para usar o OpenAI SDK?
Basta apontar base_url para o gateway da Fly.io e definir qualquer valor para api_key. O gateway injeta a chave real automaticamente, sem necessidade de cabeçalho Authorization.

### O que é a skill da Fly.io para agentes?
É um recurso que informa ferramentas como Claude Code, Cursor, Codex e Gemini CLI sobre a Ollama, permitindo que usem modelos Ollama sem configuração adicional quando o Sprite tem acesso.

Fonte original: [Run AI agents safely with Ollama and Fly.io](https://ollama.com/blog/fly-io-sprites) (Ollama).
