Skip to content

Python + Claude (chatbot simples)

O menor chatbot útil possível: um servidor FastAPI que repassa a conversa para o Claude e devolve a resposta. Sem framework de agente, sem ferramentas, sem banco — uma chamada à API de Mensagens da Anthropic por turno.

O servidor é stateless: o navegador guarda a conversa e manda o histórico inteiro a cada requisição. É o ponto de partida mais limpo para copiar.

Deploy

# 1. Criar a app
tsuru app create chatbot python

# 2. Chave da Anthropic
tsuru env-set -a chatbot ANTHROPIC_API_KEY=SUA_CHAVE --private

# 3. Deploy
cd simple-chatbot
tsuru app deploy -a chatbot .

Abra https://chatbot.coffeece.com e comece a conversar.

API

RotaO que faz
GET /UI de chat no navegador.
POST /chatRecebe {"messages": [...]} e devolve {"reply": "..."}. Mande o histórico inteiro a cada turno.
GET /healthzVerificação de saúde; informa o modelo ativo.

Variáveis

VariávelPadrãoDescrição
ANTHROPIC_API_KEYObrigatória. Chave da API da Anthropic.
ANTHROPIC_MODELclaude-opus-4-7Modelo usado. Use claude-haiku-4-5 para um bot mais barato e rápido.
SYSTEM_PROMPT(assistente genérico)Define a persona e o comportamento do bot.
MAX_TOKENS1024Limite de tamanho da resposta.

Onde está o código

coffeece/examples/simple-chatbot no GitHub.