Doku
Dokumentation
Vom Zugang bis SSH, was eine Sitzung garantiert, wie abgerechnet wird, dazu API, CLI und SDKs.
Erste Schritte
- SchnellstartVon der Zugangsanfrage zur Shell auf einer GPU: Konto erstellen, Guthaben aufladen, Maschine im Katalog wählen, starten, per SSH verbinden, stoppen.
- Die passende GPU für Ihr ModellWorkload beschreiben, passende Maschinen erhalten, günstigste zuerst. Wie der GPU-Speicher berechnet wird, was das Ergebnis abdeckt und wo es endet.
- SSH-SchlüsselEinen SSH-Schlüssel unter macOS, Linux oder Windows erzeugen, den öffentlichen Teil in die Konsole kopieren und Berechtigungsfehler beheben.
- Verbindung per SSHSchlüssel erzeugen, IP freigeben, als ubuntu verbinden. JupyterLab über SSH auf Secure, im Browser auf Community. Tunnel und Fehler.
Workloads ausführen
- Sitzungen und LimitsSo läuft eine Sitzung: Budget auf Prepaid-Guthaben, Budget Guard, automatisches Ende, Löschung der Maschine, unterbrechbare Kapazität, Kontolimits.
- GPU-Sitzungen aus einem NotebookStarten Sie eine GPU-Maschine aus Jupyter mit Höchstkosten, erhalten Sie die SSH- und JupyterLab-Links und lassen Sie sie am Ende stoppen.
- Rezept: vLLMEin Open-Weight-LLM mit vLLM auf einer Node-Lodge-Maschine bereitstellen. Installation mit uv, OpenAI-kompatibler Server, Abfrage über einen SSH-Tunnel.
- Rezept: ComfyUIComfyUI auf einer Node-Lodge-GPU betreiben. Installation mit uv, Checkpoint herunterladen, Web-UI über einen SSH-Tunnel auf Ihrem Computer öffnen.
- Rezept: LoRA-Fine-TuningEin Open-Weight-LLM mit LoRA oder QLoRA über die Hugging Face TRL CLI auf einer Node-Lodge-GPU fine-tunen und den Adapter von der Maschine kopieren.
- Rezept: BlenderBlender-Szenen headless auf einer Node-Lodge-GPU rendern. Blender 5.2 installieren, Standbilder oder Animationen mit Cycles und OptiX rendern, Frames laden.
Secure und Community
Abrechnung
Entwickler
- API-SchnellstartAPI-Schlüssel erstellen, per Bearer-Token authentifizieren, mit whoami prüfen, Scopes wählen, alle Endpoints finden und ungenutzte Schlüssel widerrufen.
- API-ReferenzAlle öffentlichen Endpoints der Node Lodge API: Authentifizierung, Parameter, Request-Bodys und jeweils ein curl-Beispiel.
- CLI und SDKMieten Sie GPU-Maschinen im Terminal mit dem Befehl nodelodge oder aus Ihrem eigenen Code mit den SDKs für TypeScript und Python.
- Node Lodge für KI-Agenten (MCP)Claude Code, Claude Desktop oder Ihr eigener Agent findet eine GPU, startet eine Sitzung mit festem Ausgabenlimit, verbindet sich per SSH und stoppt sie.
- GPU-Tools für Agent-FrameworksGPU-Tools mit festen Kostengrenzen für Agenten mit LangChain, LlamaIndex, OpenAI Agents SDK oder Claude Agent SDK, Sitzungen stoppen beim Beenden.
- GPU-Jobs aus GitHub Actions ausführenMit der Action nodelodge/run führen Sie aus einem Workflow einen Befehl auf einer GPU aus, mit fester Kostengrenze, und die Maschine wird immer gestoppt.
- Fehler und Rate LimitsAlle Fehlercodes der Node Lodge API, ihre Bedeutung und was zu tun ist, sowie die Request-Limits pro Minute und pro Stunde.
Anbieter
- Anforderungen für AnbieterWas eine Community-Maschine braucht, wie Sie Firmware (Virtualisierung, IOMMU) und VFIO unter Ubuntu einrichten und mit wenigen Befehlen prüfen.
- Maschine koppelnVerbinden Sie eine Maschine mit dem Node Lodge Agent unter Linux oder Windows mit Ihrem Anbieterkonto: herunterladen, prüfen, koppeln, melden lassen.
- AnbieterIhre NVIDIA-Maschine auf Community anbieten: Anforderungen, Koppeln mit dem Agent, die Prüfung, der Geschwindigkeitstest, Preise und Ihr Anteil von 85 Prozent.
Konto und Sicherheit
Fehlerbehebung
- SSH-Verbindung abgelehntSSH-Verbindung mit Timeout, abgelehnt oder verweigert: die IP-Regel einer Secure-Maschine, der Schlüssel, der Benutzer, ein geänderter Host-Schlüssel.
- Sitzung startet nichtEin abgelehnter Start oder eine Sitzung, die beim Starten hängt oder fehlschlägt: was jede Meldung bedeutet, was berechnet wird und was als Nächstes zu tun ist.
- Budget erreichtWarum eine Sitzung vor ihrem Budget gestoppt hat, was berechnet wurde, wie Sie das Budget einer laufenden Sitzung erhöhen und vor dem Ende gewarnt werden.
- Zahlung abgelehntEin abgelehnter Guthabenkauf, eine abgelehnte automatische Aufladung oder Kartenbelastung: was stoppt, was weiterläuft und wie Sie das Konto wieder öffnen.
- FAQZugang, Abrechnung, Secure und Community, was mit Ihren Daten geschieht, unterbrechbare Maschinen, SSH-Zugang, Anbieter und zulässige Nutzung.