EQVPS

Wie man einen KI-Agenten auf einem VPS betreibt (Python, venv, systemd)

Eine Copy-paste-Anleitung, um einen KI-Agenten auf einem VPS zu betreiben: Python und ein Virtualenv einrichten, API-Schlüssel in einer env-Datei halten und den Agenten in einen systemd-Dienst packen, damit er nach einem Absturz neu startet und Neustarts übersteht.

Ein KI-Agent, der nur läuft, solange dein Laptop offen ist, ist ein Skript. Damit er sich selbst betreibt — neu verbindet, wiederholt, Neustarts übersteht — pack ihn auf einen VPS unter systemd. Das ist die minimale Copy-paste-Anleitung. Für das Warum und die längere Form (Uptime, Dimensionierung, der MCP-Aspekt) siehe einen KI-Agenten 24/7 betreiben und die Übersicht VPS für KI-Agenten.

1. Python und ein 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. Halte den API-Schlüssel in einer env-Datei

Schlüssel niemals fest im Code verdrahten. Lege sie in eine Datei, die nur root lesen kann:

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

3. Pack ihn in einen systemd-Dienst

# /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 ist der ganze Sinn: Ein Absturz um 3 Uhr morgens führt zum Neustart, statt den Agenten bis zum Morgen tot liegen zu lassen. (Mehr zum Muster in einen systemd-Dienst erstellen.)

4. Achte auf Crash-Loops

Wenn der Agent beim Start sofort fehlschlägt, versucht Restart=always es ewig weiter. RestartSec=5 streckt die Versuche; lies journalctl -u agent, um den zugrunde liegenden Fehler zu beheben (meist eine fehlende env-Variable oder Abhängigkeit).

Dimensionierung und die ehrlichen Punkte

EQVPS stellt außerdem einen MCP-Server bereit, sodass ein Agent sich sogar selbst eine Maschine bereitstellen kann. Root in etwa einer Minute, kein KYC, Zahlung in Krypto.

FAQ

Was brauche ich, um einen KI-Agenten auf einem VPS zu betreiben?

Python mit einem Virtualenv für die Abhängigkeiten des Agenten, deinen Modell-API-Schlüssel in einer Umgebungsdatei und einen systemd-Dienst, damit er nach einem Absturz neu startet und beim Boot startet. Wenn der Agent ein gehostetes Modell aufruft (der übliche Fall), ist das alles — keine GPU. Die Schritte stehen unten; Root bekommst du in etwa einer Minute.

Wohin kommt der API-Schlüssel?

In eine EnvironmentFile (chmod 600), niemals in die Unit-Datei oder ins Git committet. systemd lädt sie beim Start in die Prozessumgebung. So gibt eine geleakte Unit oder ein geleaktes Repo deinen Schlüssel nicht preis.

Wie halte ich den Agenten nach dem Trennen am Laufen?

Packe ihn in einen systemd-Dienst mit Restart=always. Anders als beim Ausführen im Terminal oder mit nohup startet systemd ihn nach einem Absturz neu, startet ihn beim Boot und erfasst Logs in journalctl. Das ist der Unterschied zwischen einem Skript und einem Agenten, der sich selbst betreibt.

Brauche ich eine GPU?

Nicht, wenn der Agent ein gehostetes Modell über eine API aufruft — das ist reine CPU-Orchestrierung, bequem auf einer kleinen Maschine. Eine GPU brauchst du nur, um ein Modell lokal zu betreiben, was wir nicht anbieten; für kleine lokale Modelle auf CPU siehe die Ollama-Anleitung.

Verlangt ihr Ausweis oder Karte?

Nein. E-Mail zum Registrieren, Zahlung in USDC oder USDT — keine Dokumente, keine Karte. Root in etwa einer Minute.

Kommentare

Noch keine Kommentare. Sei der Erste.

Kommentar hinterlassen

Kommentare werden vor der Anzeige moderiert.