OpenHands
Was dieser Artikel behandelt
- Was OpenHands ist und wofür es gedacht ist.
- Wie Du OpenHands mit Docker startest.
- Wie Du ein GitHub-Repository einbindest.
- Was ein Arbeitsschritt mit OpenHands aussieht.
- Wann OpenHands sinnvoll ist und wo es an Grenzen stößt.
Einleitung
OpenHands ist ein Open-Source-Projekt für KI-gestützte Softwareentwicklung. Ein Agent kann Code verstehen, bearbeiten, Commits vorschlagen und Pull-Requests erzeugen. Das Besondere: OpenHands arbeitet in einem echten Repository und kann Dateien lesen, Tests ausführen und Code-Feedback verarbeiten.
OpenHands kurz erklärt
OpenHands besteht aus einem Container, der den Agenten ausführt, und einer Weboberfläche. Du verbindest ein GitHub-Repo oder einen lokalen Ordner. Dann gibst Du Aufgaben in natürlicher Sprache ein. Der Agent plant, welche Dateien er öffnet, was er ändert und wie er es testet.
Installation
Der schnellste Weg ist Docker:
docker run -it --rm \
-p 3000:3000 \
-v /var/run/docker.sock:/var/run/docker.sock \
-e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:0.18-nikolaik \
--name openhands-app \
docker.all-hands.dev/all-hands-ai/openhands:0.18Nach dem Start öffnest Du http://localhost:3000. Für ältere Images oder andere Versionen solltest Du die aktuelle Dokumentation prüfen.
GitHub-Token einrichten
Für Repositories brauchst Du ein GitHub-Token:
export GITHUB_TOKEN="dein-token"OpenHands kann damit Commits, Branches und Pull-Requests erstellen. Ohne Token arbeitet es nur lokal.
Erste Schritte: Eine Aufgabe geben
- Öffne
http://localhost:3000. - Verbinde Dein Repository oder wähle einen lokalen Ordner.
- Gib eine Aufgabe ein, etwa: “Füge eine Funktion hinzu, die E-Mail-Adressen validiert.”
- Warte, während der Agent den Plan erstellt und ausführt.
- Prüfe die vorgeschlagenen Änderungen.
Wofür ist OpenHands geeignet?
| Einsatzgebiet | Nutzen |
|---|---|
| Refactoring | Code bereinigen und verbessern |
| Feature-Hinweise | Kleine Funktionen aus der Beschreibung implementieren |
| Dokumentation | Code-Kommentare und README ergänzen |
| Lernen | Schritt für Schritt nachvollziehen, wie ein Agent an Code herangeht |
Typische Stolpersteine
- Sicherheit - OpenHands kann Code ausführen. Lass es nur in isolierten Repositories oder Docker laufen.
- Token-Rechte - Das GitHub-Token braucht entsprechende Berechtigungen für Commits und Pull-Requests.
- Kosten und Zeit - Große Aufgaben brauchen viele Modellaufrufe und laufen lange.
Weiterführende Links
FAQ - Typische Fragen
Ist OpenHands kostenlos?
Ja, das Open-Source-Projekt ist kostenlos. Kosten entstehen nur für Modell-APIs oder Cloud-Hosting.
Kann ich OpenHands lokal betreiben?
Ja, mit Docker. Das ist die empfohlene Art, um es auszuprobieren.
Brauche ich GitHub?
Nein, auch lokale Ordner funktionieren. Für echte Projektarbeit ist ein GitHub-Repository praktisch.