Existe um detalhe importante antes de começar: o Antigravity Desktop não oferece, na configuração convencional, um campo para apontar diretamente para um servidor LiteLLM local.
É possível utilizar o LiteLLM como gateway centralizado de modelos, mas precisamos distinguir duas situações:
Antigravity Desktop convencional: utiliza a autenticação e os provedores nativos do Google. Não basta configurar
localhost:4000para substituir os modelos.Antigravity com Enterprise Gateway: permite uma integração corporativa por meio de configurações administrativas, sujeita aos requisitos de compatibilidade e infraestrutura.
Minha recomendação é montar o LiteLLM como uma camada independente, pronta para atender o Antigravity quando houver suporte administrativo, além de outros clientes e ferramentas de desenvolvimento.
1. Arquitetura que vamos implementar
Considerando seu Mac e o uso de modelos locais e cloud:
Antigravity IDE
Ambiente de desenvolvimento
LiteLLM Proxy
localhost:4000
API OpenAI-compatible · Roteamento · Virtual Keys
Modelos locais
Ollama
LM Studio
Modelos cloud
OpenAI
Gemini
Anthropic
Outros
PostgreSQL armazena dados de configuração, chaves e informações de operação conforme a configuração do LiteLLM.
O LiteLLM ficará em Docker, enquanto Ollama e LM Studio poderão continuar executando nativamente no macOS. Para acessar os serviços do Mac a partir do container, utilizaremos host.docker.internal.
2. Instalar o LiteLLM no macOS
Abra o Terminal e execute:
mkdir -p ~/Developer/litellm-gateway
cd ~/Developer/litellm-gatewayVamos gerar as chaves de segurança:
cat > .env <<EOF
LITELLM_MASTER_KEY=sk-$(openssl rand -hex 32)
LITELLM_SALT_KEY=sk-$(openssl rand -hex 32)
EOF
chmod 600 .envEssas chaves têm funções diferentes:
LITELLM_MASTER_KEY: administração do gateway.LITELLM_SALT_KEY: criptografia das credenciais dos provedores.
Guarde o SALT_KEY: não o altere depois de cadastrar as credenciais, pois isso pode impedir a descriptografia delas.
3. Criar o Docker Compose
Crie o arquivo:
~/Developer/litellm-gateway/docker-compose.yml
services:
litellm:
image: docker.litellm.ai/berriai/litellm:main-stable
container_name: litellm-proxy
restart: unless-stopped
ports:
- "127.0.0.1:4000:4000"
volumes:
- ./config.yaml:/app/config.yaml:ro
env_file:
- .env
command:
- "--config"
- "/app/config.yaml"
- "--port"
- "4000"
depends_on:
postgres:
condition: service_healthy
postgres:
image: postgres:16
container_name: litellm-postgres
restart: unless-stopped
environment:
POSTGRES_DB: litellm
POSTGRES_USER: litellm
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
volumes:
- postgres_data:/var/lib/postgresql/data
healthcheck:
test: ["CMD-SHELL", "pg_isready -U litellm -d litellm"]
interval: 5s
timeout: 5s
retries: 10
volumes:
postgres_data:
Acrescente ao .env uma senha para o PostgreSQL:
echo "POSTGRES_PASSWORD=$(openssl rand -hex 32)" >> .envA porta do LiteLLM está vinculada ao localhost, evitando exposição direta na rede.
4. Criar a configuração dos modelos
Crie config.yaml:
model_list:
- model_name: local-llama
litellm_params:
model: ollama/llama3.2
api_base: http://host.docker.internal:11434
- model_name: local-gemma
litellm_params:
model: ollama/gemma3
api_base: http://host.docker.internal:11434
- model_name: local-lmstudio
litellm_params:
model: openai/local-model
api_base: http://host.docker.internal:1234/v1
api_key: lm-studio
- model_name: gpt-cloud
litellm_params:
model: openai/gpt-6
api_key: os.environ/OPENAI_API_KEY
- model_name: gemini-cloud
litellm_params:
model: gemini/gemini-2.5-flash
api_key: os.environ/GEMINI_API_KEY
general_settings:
master_key: os.environ/LITELLM_MASTER_KEY
database_url: os.environ/DATABASE_URL
litellm_settings:
drop_params: true
set_verbose: false
Os nomes dos modelos cloud são exemplos: substitua-os pelos IDs efetivamente disponibilizados nas suas contas e provedores.
Acrescente ao .env:
DATABASE_URL=postgresql://litellm:${POSTGRES_PASSWORD}@postgres:5432/litellm
OPENAI_API_KEY=
GEMINI_API_KEY=O LiteLLM suporta diversos provedores, e você poderá acrescentar Anthropic, Azure, Bedrock, OpenRouter e outros conforme suas credenciais.
5. Iniciar os serviços
Execute:
cd ~/Developer/litellm-gateway
docker compose up -dVerifique:
docker compose psConsulte os logs:
docker compose logs -f litellmAcesse a interface administrativa:
Entre com:
Usuário:
adminSenha: valor de
LITELLM_MASTER_KEYno.env.
A interface permite cadastrar provedores, testar modelos, administrar chaves e acompanhar utilização.
6. Preparar o HTTPS para o Antigravity
Aqui está uma particularidade importante: a documentação atual do Google especifica uma URL HTTPS para o Enterprise Gateway.
Como nosso LiteLLM está em localhost:4000, vamos criar um proxy HTTPS local.
Instale Caddy e mkcert:
brew install caddy mkcert
mkcert -installGere o certificado:
cd ~/Developer/litellm-gateway
mkdir -p certs
mkcert \
-cert-file certs/localhost.pem \
-key-file certs/localhost-key.pem \
localhost 127.0.0.1 ::1Crie Caddyfile:
localhost:8443 {
tls certs/localhost.pem certs/localhost-key.pem
reverse_proxy 127.0.0.1:4000
}
Inicie:
caddy run --config CaddyfileAgora teremos:
Serviço | Endereço |
|---|---|
LiteLLM | |
LiteLLM Admin | |
Gateway HTTPS |
O certificado gerado pelo mkcert é confiável localmente após a instalação da CA no macOS.
7. Configurar o Antigravity Desktop
Esta é a etapa principal.
A documentação atual do Google já prevê a configuração de um gateway por meio das variáveis AGY_LLM_GATEWAY_* ou de arquivos administrativos. Também documenta suporte ao protocolo OpenAI Chat Completions, compatível com o endpoint do LiteLLM.
Para o seu Antigravity Desktop no macOS, vamos começar pela configuração do usuário.
Crie o diretório:
mkdir -p ~/.antigravityCrie o arquivo:
~/.antigravity/settings.json
{
"gateway": {
"enabled": true,
"url": "https://localhost:8443",
"apiKey": "SUA_LITELLM_MASTER_KEY",
"wireProtocol": "openai"
},
"models": {
"defaultModelId": "local-llama",
"list": [
{
"modelId": "local-llama"
},
{
"modelId": "local-gemma"
},
{
"modelId": "local-lmstudio"
},
{
"modelId": "gpt-cloud"
},
{
"modelId": "gemini-cloud"
}
]
}
}
Substitua SUA_LITELLM_MASTER_KEY pela chave criada anteriormente.
Importante: essa configuração utiliza o mecanismo documentado de Enterprise Gateway do Antigravity. A disponibilidade efetiva depende da versão e da habilitação desse recurso no ambiente. Para uso corporativo gerenciado, o arquivo administrativo tem precedência e fica em /Library/Application Support/Antigravity/admin_settings.json.
O protocolo openai é o adequado para o LiteLLM, que recebe chamadas em /v1/chat/completions. Não utilize essa configuração openai no servidor ACP do JetBrains ou Zed, que exige genai.
8. Criar uma chave exclusiva para o Antigravity
Não recomendo manter a chave administrativa no IDE permanentemente.
Acesse o LiteLLM Admin:
Entre em Virtual Keys.
Selecione Generate New Key.
Defina o nome
antigravity.Selecione os modelos permitidos.
Gere e copie a chave
sk-....
Substitua a chave administrativa no settings.json pela nova chave.
O LiteLLM permite controlar os modelos autorizados por chave.
9. Testar a comunicação
Antes de abrir o Antigravity, teste o gateway:
curl -k https://localhost:8443/v1/models \
-H "Authorization: Bearer SUA_CHAVE"Depois teste uma inferência:
curl -k https://localhost:8443/v1/chat/completions \
-H "Authorization: Bearer SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"model": "local-llama",
"messages": [
{
"role": "user",
"content": "Explique Clean Architecture em Python."
}
]
}'Se retornar uma resposta JSON com o conteúdo gerado, o LiteLLM está funcionando.
O -k serve somente para esse teste com curl; não desabilite a validação TLS no Antigravity.
10. Reiniciar o Antigravity
Feche completamente o Antigravity.
Confirme que o Docker e o Caddy continuam executando.
Abra novamente o Antigravity.
Verifique o status da conexão com o gateway.
Faça um teste de programação.
Se a integração estiver habilitada, o Antigravity deverá utilizar o gateway em vez da conexão direta com o provedor.
A documentação do Google também prevê o status Connected: Enterprise Gateway.
11. Arquitetura final e possibilidades
Com essa estrutura você terá:
Recurso | Responsabilidade |
|---|---|
Antigravity | Desenvolvimento e agentes |
LiteLLM | Gateway de IA |
PostgreSQL | Persistência e gerenciamento |
Ollama | Inferência local |
LM Studio | Inferência local |
OpenAI | Modelos cloud |
Gemini | Modelos cloud |
Anthropic | Modelos cloud |
Caddy | HTTPS local |
Você também poderá conectar outros clientes compatíveis com OpenAI API ao mesmo gateway, cada um com sua própria chave.
Um ponto que quero validar antes de avançarmos
Existe uma diferença importante entre configurar o LiteLLM e conseguir substituir efetivamente os modelos nativos do Antigravity.
A configuração acima utiliza a interface documentada de gateway do Google, mas não significa que todos os recursos proprietários do Antigravity sejam automaticamente compatíveis com qualquer modelo OpenAI-compatible. É necessário validar streaming, ferramentas, chamadas estruturadas e fluxo dos agentes.
Minha sugestão é começar validando a integração no seu Mac mini M4.
Qual cenário você quer implementar?
Quais provedores deseja habilitar?
Continuar implementaçãoSeja Membro Gratuítamente
Assine a newsletter para receber em seu email as publicações atualizadas neste blog
