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.

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:

  1. Antigravity Desktop convencional: utiliza a autenticação e os provedores nativos do Google. Não basta configurar localhost:4000 para substituir os modelos.

  2. 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-gateway

Vamos 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 .env

Essas 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.

liteLLM+1

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)" >> .env

A 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.

liteLLM+1

5. Iniciar os serviços

Execute:

cd ~/Developer/litellm-gateway

docker compose up -d

Verifique:

docker compose ps

Consulte os logs:

docker compose logs -f litellm

Acesse a interface administrativa:

Entre com:

  • Usuário: admin

  • Senha: valor de LITELLM_MASTER_KEY no .env.

A interface permite cadastrar provedores, testar modelos, administrar chaves e acompanhar utilização.

liteLLM+1

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 -install

Gere 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 ::1

Crie Caddyfile:


localhost:8443 {
    tls certs/localhost.pem certs/localhost-key.pem
    reverse_proxy 127.0.0.1:4000
}

Inicie:

caddy run --config Caddyfile

Agora teremos:

Serviço

Endereço

LiteLLM

http://localhost:4000

LiteLLM Admin

http://localhost:4000/ui

Gateway HTTPS

https://localhost:8443

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.

Google Cloud Documentation+1

Para o seu Antigravity Desktop no macOS, vamos começar pela configuração do usuário.

Crie o diretório:

mkdir -p ~/.antigravity

Crie 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.

Google Cloud Documentation+1

8. Criar uma chave exclusiva para o Antigravity

Não recomendo manter a chave administrativa no IDE permanentemente.

Acesse o LiteLLM Admin:

http://localhost:4000/ui

  1. Entre em Virtual Keys.

  2. Selecione Generate New Key.

  3. Defina o nome antigravity.

  4. Selecione os modelos permitidos.

  5. 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.

liteLLM+1

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

  1. Feche completamente o Antigravity.

  2. Confirme que o Docker e o Caddy continuam executando.

  3. Abra novamente o Antigravity.

  4. Verifique o status da conexão com o gateway.

  5. 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.

Google Cloud Documentation

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ção
Seja Membro Gratuítamente

Assine a newsletter para receber em seu email as publicações atualizadas neste blog

Top