Cómo ejecutar un agente de IA en un VPS (Python, venv, systemd)

Un agente de IA que solo corre mientras tu portátil está abierto es un script. Para que se ejecute solo — reconectando, reintentando, sobreviviendo a reinicios — ponlo en un VPS bajo systemd. Esta es la guía copia-pega mínima. Para el porqué y la forma larga (uptime, dimensionamiento, el ángulo MCP), consulta ejecutar un agente de IA 24/7 y la visión general de VPS para agentes de IA.

1. Python y un 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. Guarda la clave API en un archivo env

Nunca escribas las claves en el código. Ponlas en un archivo que solo root pueda leer:

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

3. Envuélvelo en un servicio 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 es todo el sentido: un fallo a las 3 de la mañana reinicia en lugar de dejar el agente muerto hasta la mañana. (Más sobre el patrón en crear un servicio systemd.)

4. Vigila los bucles de fallo

Si el agente falla al instante al arrancar, Restart=always reintenta para siempre. RestartSec=5 espacia los intentos; lee journalctl -u agent para arreglar el error subyacente (normalmente una variable env o dependencia que falta).

Dimensionamiento y lo honesto

• Agente respaldado por API (el modelo corre en tu proveedor): ligero — un Small ($8) o el plan AI-Agent ($10, 4 GB) sobra. Sin GPU.
• Modelo local: configuración distinta y más pesada — modelos cuantizados pequeños en CPU vía Ollama; los grandes necesitan una GPU que no ofrecemos.
• ¿Contenedorizado en su lugar? El --restart unless-stopped de Docker juega el mismo papel — consulta docker-compose para agentes de IA.

EQVPS también expone un servidor MCP, así que un agente puede incluso aprovisionar su propia máquina. Root en un minuto aproximadamente, sin KYC, pago en cripto.