@leadtimelabs/installer

Deine eigene KI-Mitarbeiter-Runtime in unter 15 Minuten — ein NPX-One-Liner.

Quickstart

bunx @leadtimelabs/installer

Oder mit npm:

npx @leadtimelabs/installer

Was passiert dabei?

$ bunx @leadtimelabs/installer

  ╔═════════════════════════════════════╗
  ║   🤖  Agentic Leadtime Installer    ║
  ╚═════════════════════════════════════╝

  Deine eigene KI-Mitarbeiter-Runtime in <15 Min.

? Wie möchtest du installieren?
  ❯ 🌥️  Cloud-VPS bei Hetzner anlegen (empfohlen)
    🖥️  Auf bestehendem Server installieren

? Hetzner-API-Token:
  ****…****

? Server-Typ:
  ❯ cpx21  (3 vCPU, 4 GB RAM, ~5,83 €/Monat)  [empfohlen]

? Domain (z. B. runtime.meineagentur.de):
  runtime.meineagentur.de

? Leadtime Admin-PAT:
  ****…****

? OpenAI-API-Key (sk-…):
  sk-****…****

? Telegram-Bot-Token (von @BotFather):
  123456:****…****

── Zusammenfassung ──

  Server-Typ:    cpx21
  Standort:      nbg1
  Server-Name:   mybot-runtime
  Domain:        runtime.meineagentur.de
  Leadtime-WS:   meineagentur
  OpenAI-Key:    sk-…XXXXXX
  Telegram-Bot:  …XXXXXXXX

? Jetzt installieren? Yes

── Schritt 6: VPS Provisionierung ──

  ✔ SSH-Keypair erstellt ✅
  ✔ SSH-Key hochgeladen ✅
  ✔ VPS bestellt (ID: 12345678) ✅
  ✔ VPS läuft ✅ (IP: 95.217.X.X)

  📌 Server-IP: 95.217.X.X
  Lege jetzt einen DNS-A-Record an:
    runtime.meineagentur.de  →  95.217.X.X

  ✔ SSH verfügbar ✅
  ✔ System-Pakete installieren
  ✔ Repository klonen
  ✔ Agentic Leadtime installieren: Dies dauert ca. 3–5 Minuten…
  ✔ Installation abgeschlossen ✅

  ✅ Deine Runtime ist live!

  URL:  https://runtime.meineagentur.de/setup-bootstrap

Anschliessend öffnet sich automatisch der Bootstrap-Wizard im Browser — dort verknüpfst du deinen Telegram-Bot und legst den ersten KI-Mitarbeiter an.

Voraussetzungen

| Was | Wo besorgen | |---|---| | Hetzner-API-Token | Hetzner Cloud Console → API-Tokens → „Neu erstellen" (Lese+Schreib-Berechtigung) | | Domain | Beliebiger DNS-Anbieter. Du trägst anschliessend einen A-Record ein. | | OpenAI-API-Key | platform.openai.com/api-keys | | Telegram-Bot-Token | Telegram → @BotFather → /newbot | | Leadtime Admin-PAT | Leadtime → Einstellungen → API-Zugänge |

Server-Empfehlung

| Typ | vCPU | RAM | Preis/Monat | Für | |---|---|---|---|---| | cpx11 | 2 | 2 GB | ~3,29 € | Test / Demo | | cpx21 | 3 | 4 GB | ~5,83 € | Empfohlen (Prod) | | cpx31 | 4 | 8 GB | ~10,59 € | Hohe Last | | cpx41 | 8 | 16 GB | ~20,00 € | Enterprise |

Update einer bestehenden Installation

Beim erneuten Ausführen erkennt der Installer eine vorhandene Installation und bietet:

? Was möchtest du tun?
  ❯ Bestehende Runtime aktualisieren
    Neue Runtime installieren
    Abbrechen

Der Update-Pfad zieht den neuesten Code via git pull und startet den Service neu — ohne Datenverlust.

Troubleshooting

SSH-Verbindung schlägt fehl

Verbindung fehlgeschlagen: Command failed (exit 255): ssh …

→ Prüfe, ob der SSH-Key unter ~/.agentic-leadtime/keys/ liegt und Berechtigung 0600 hat.

DNS nicht propagiert

Der Installer wartet auf deine manuelle Bestätigung, bevor er fortfährt. Nutze dig runtime.deinedomain.de um die Propagation zu prüfen.

Health-Check schlägt fehl

Installation-Logs finden sich unter:

~/.agentic-leadtime/install-<server-name>-<timestamp>.log

Hetzner-API-Token ungültig (401)

Token muss Lese- und Schreib-Berechtigung haben, nicht nur „Read only".

Datenschutz & Sicherheit

• Alle Tokens bleiben lokal — sie werden direkt per SSH an die VPS übertragen, nie an einen Cloud-Service oder Drittanbieter gesendet.
• Hetzner-Token wird nicht dauerhaft gespeichert.
• SSH-Keypair liegt in ~/.agentic-leadtime/keys/ mit 0600-Berechtigung.
• Installationsmetadaten (IP, Domain, SSH-Key-Pfad) werden in ~/.agentic-leadtime/installations.json gespeichert.

Manueller Install-Pfad

Wer lieber selbst steuert:

ssh root@<server-ip>
git clone https://github.com/lukas-ebner/agentic-leadtime /opt/agentic-leadtime/src
DOMAIN=runtime.deinedomain.de \
OPENAI_API_KEY=sk-… \
TELEGRAM_BOT_TOKEN=123:… \
AGENTIC_LEADTIME_PAT=… \
bash /opt/agentic-leadtime/src/deploy/install.sh

Provider-Roadmap

| Provider | Status | |---|---| | Hetzner Cloud | ✅ Verfügbar | | IONOS | 🔜 Phase 2 | | Vultr | 🔜 Phase 2 | | Linode | 🔜 Phase 2 | | Lokal / Docker | 🔜 Phase 2 |

Lizenz

MIT — Lukas Ebner / Wachstumscoach GmbH