Como rodar um agente de IA num VPS (Python, venv, systemd)

Um agente de IA que só roda enquanto seu notebook está aberto é um script. Para que ele rode a si mesmo — reconectando, repetindo, sobrevivendo a reinícios — coloque-o num VPS sob o systemd. Este é o guia copiar-colar mínimo. Para o porquê e a forma mais longa (uptime, dimensionamento, o ângulo do MCP), veja rodar um agente de IA 24/7 e a visão geral de VPS para agentes de IA.

1. Python e um virtualenv

apt update && apt install -y python3-venv python3-pip git
git clone https://github.com/you/your-agent.git /opt/agent
cd /opt/agent
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt

2. Guarde a chave de API num arquivo env

Nunca deixe chaves fixas no código. Coloque-as num arquivo que só o root pode ler:

cat >/opt/agent/.env <<'EOF'
ANTHROPIC_API_KEY=sk-ant-...
EOF
chmod 600 /opt/agent/.env

3. Embrulhe-o num serviço systemd

# /etc/systemd/system/agent.service
[Unit]
Description=AI Agent
After=network.target

[Service]
WorkingDirectory=/opt/agent
ExecStart=/opt/agent/.venv/bin/python main.py
EnvironmentFile=/opt/agent/.env
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now agent
journalctl -u agent -f      # watch it run

Restart=always é todo o propósito: uma queda às 3 da manhã reinicia em vez de deixar o agente morto até de manhã. (Mais sobre o padrão em criar um serviço systemd.)

4. Fique de olho nos loops de queda

Se o agente falha instantaneamente ao iniciar, Restart=always tenta para sempre. RestartSec=5 espaça as tentativas; leia journalctl -u agent para corrigir o erro de base (geralmente uma variável env ou dependência ausente).

Dimensionamento e as partes honestas

• Agente apoiado em API (o modelo roda no seu provedor): leve — um Small ($8) ou o plano AI-Agent ($10, 4 GB) sobra. Sem GPU.
• Modelo local: configuração diferente e mais pesada — modelos quantizados pequenos em CPU via Ollama; os grandes exigem uma GPU que não oferecemos.
• Em contêiner, em vez disso? O --restart unless-stopped do Docker faz o mesmo papel — veja docker-compose para agentes de IA.

O EQVPS também expõe um servidor MCP, então um agente pode até provisionar sua própria máquina. Root em cerca de um minuto, sem KYC, pagamento em cripto.