AI OpenHands gebruiken: Een praktische handleiding voor installatie, prompts en real-world workflows
Als je ooit had gewenst dat een bekwame ontwikkelaar 24/7 met je kon pair-programma's, dan komt AI OpenHands daar opvallend dichtbij. Het is een open-source "AI engineer" die je repo kan lezen, code kan schrijven, terminals kan uitvoeren, documenten kan doorbladeren en kan itereren—net als een junior ontwikkelaar die snel leert en onvermoeibaar werkt. Maar die kracht komt pas echt tot zijn recht als je het correct instelt en leert hoe je het moet aansturen.
Deze handleiding leidt je stap voor stap door het gebruik van AI OpenHands—van installatie tot geavanceerde workflows—zodat je met vertrouwen sneller kunt opleveren.
- Wat we zullen behandelen:
- Installatieopties en snelle start
- OpenHands lokaal of met cloudmodellen uitvoeren
- Best practices voor prompts, repo's en taken
- Bewezen workflows voor feature werk, debugging, tests en documentatie
- Guardrails, privacy en samenwerking
Belangrijk om te weten: OpenHands wordt actief ontwikkeld door het All Hands-team en de community. De officiële documentatie is je leidraad voor actuele instructies en tips. Je kunt ook praktische installatiehandleidingen volgen van practitioners die lokale en VM-installaties hebben gedocumenteerd. Voor het uitvoeren met lokale modellen bevat de documentatie ook specifieke richtlijnen.
Wat is AI OpenHands—en waarom zou je het gebruiken?
Beschouw AI OpenHands als een AI-teamgenoot met een toetsenbord. Anders dan chat-only assistenten, kan OpenHands:
- Projectbestanden openen en lezen
- Een terminal gebruiken om commando's, tests en linters uit te voeren
- Code bewerken in bestanden en directories
- Op het web browsen (afhankelijk van de configuratie)
- Stapsgewijze plannen voorstellen en toepassen
Dit maakt het ideaal voor taken zoals het implementeren van features, het oplossen van bugs, het schrijven van tests, het maken van documentatie, refactoring en het moderniseren van codebases. In plaats van te jongleren met prompts en kopiëren/plakken, geef je OpenHands een doel en laat je het itereren, terwijl jij toezicht houdt op de acties.
Snelle start: De snelste manier om OpenHands te gebruiken
Er zijn verschillende manieren om aan de slag te gaan. Je keuze hangt af van of je een cloud LLM wilt gebruiken of alles lokaal wilt uitvoeren.
Optie A: Gebruik een Cloud LLM (makkelijkst)
- Volg de officiële "Start Building" en "Getting Started" documentatie om de app te installeren en uit te voeren. Je zult doorgaans:
- Vereisten installeren (Docker, Node, Python, Git afhankelijk van het pad)
- Een API-sleutel verstrekken voor een ondersteund cloudmodel (bijv. OpenAI, Anthropic of andere die het project op dat moment ondersteunt)
- De OpenHands-interface starten en je repository verbinden
Met deze aanpak ben je snel productief met minimale compute overhead.
Optie B: OpenHands uitvoeren met een Lokale LLM
- Als je liever code en prompts niet in de cloud bewaart of API-kosten wilt vermijden, gebruik dan de Local LLMs-handleiding in de officiële documentatie.
- Een compatibel lokaal model instellen (via Ollama of andere backends die op dat moment worden ondersteund)
- Modeleindpunten en contextlimieten configureren
- Ervoor zorgen dat je machine voldoende VRAM/CPU en schijfruimte heeft
Optie C: Deployen naar een VM
- Als je een dedicated omgeving nodig hebt, hebben practitioners gedocumenteerd hoe je OpenHands in enkele minuten op een VM kunt opzetten en een app kunt bouwen. Dit is handig voor teams die een stabiele, gedeelde AI engineer instantie willen.
Eerste run: Project Setup en Taakframing
OpenHands blinkt uit wanneer het je code kan zien. Begin met:
- Het openen van de repository waaraan je wilt dat het werkt.
- Het uitvoeren of indexeren van het project, zodat OpenHands de structuur in kaart kan brengen.
- Het geven van een duidelijk doel met beperkingen.
Goed voorbeeld van taakframing:
- "Voeg wachtwoord reset voor gebruikers toe aan de
auth service met behulp van token-gebaseerde e-mail links. Gebruik de bestaande mailer module. Voeg unit tests toe voor token generatie en vervaldatum. Verander het gebruikersdata schema niet."
Waarom dit werkt:
- Het benoemt de component, scope, dependencies en boundaries. Hoe duidelijker je bent, hoe beter OpenHands plant en uitvoert.
Hoe je effectieve prompts schrijft voor OpenHands
Beschouw prompts als beknopte tickets. De beste:
- Definiëren de uitkomst: "Implementeer X met Y beperkingen"
- Refereren naar bestanden, modules of tests: "Zie
auth/routes.py en tests/test_auth.py"
- Stellen beperkingen: "Geen DB schema wijzigingen; behoud bestaande interfaces"
- Bevatten acceptatiecriteria: "Tests moeten slagen:
pytest -k password_reset"
Template die je kunt hergebruiken:
Doel: <Wat je gebouwd of opgelost wilt hebben>
Context: <Relevante bestanden, bekende beperkingen, externe services>
Acceptatie: <Hoe succes eruitziet: tests, endpoints, metrics>
Boundaries: <Wat niet te veranderen of benaderingen om te vermijden>
Tools: <Commando's die het kan uitvoeren, scripts of databronnen>
Core Workflow: Plan → Uitvoeren → Verifiëren → Verfijnen
OpenHands stelt meestal een meerstappenplan voor. Hier is hoe je het kunt begeleiden:
- Keur het plan vroegtijdig goed of pas het aan. Laat het eerst tests uitvoeren om de basislijn voor fouten vast te stellen.
- Vraag het om een test te maken of bij te werken om succes te definiëren en implementeer vervolgens de code.
- Laat het regelmatig de test suite en linters uitvoeren.
- Als het vastloopt, voeg dan meer context toe: bestandsnamen, stack traces of logs.
Pro tip: Moedig kleine PR-sized veranderingen aan in plaats van monolithische bewerkingen. Dit helpt met reviewbaarheid en rollback.
Voorbeeldworkflows die je kunt kopiëren
1) Feature Implementatie
- Prompt: "Voeg CSV export toe aan de
orders pagina. Gebruik server-side paginering, stream resultaten via text/csv. Voeg Export knop toe in OrdersTable.jsx en endpoint in routes/orders.ts. Inclusief tests voor paginering en headers."
- Scant repo; ontwerpt plan
- Voegt endpoint en client button toe
- Schrijft tests en voert ze uit
- Jij houdt toezicht, keurt wijzigingen goed en mergt zodra het groen is.
2) Debuggen van een mislukte build
- Prompt: "CI faalt op Node 20. Fix ESM/CJS import errors in
build.mjs. Behoud bestaande rollup plugins; update config en code om CI te laten slagen."
- Geef logs of link naar CI artifacts.
- Vraag OpenHands om lokaal te repliceren (
npm run build) en minimale diffs voor te stellen.
3) Test Coverage en Hardening
- Prompt: "Verhoog de coverage voor
payments/service.py van 62% naar 85%+. Voeg unit tests toe voor retry_charge, refund, webhook_signature. Wijzig de business logic niet tenzij de test een bug blootlegt."
- Laat OpenHands tests genereren, uitvoeren en verfijnen.
4) Documentatie en Developer Experience
- Prompt: "Maak een
CONTRIBUTING.md en DEVELOPMENT.md voor deze repo. Inclusief environment setup, scripts, test commando's en PR guidelines."
- Laat het commando's verifiëren door ze daadwerkelijk uit te voeren.
Guardrails: Houd OpenHands behulpzaam en veilig
- Directory scope: Richt het op een specifieke repo of directory om onbedoelde bewerkingen elders te voorkomen.
- Bestandsbescherming: Markeer configuratiebestanden of kritieke infrastructuur waar mogelijk als alleen-lezen.
- Commando auditing: Vereis goedkeuring voor destructieve commando's (bijv.
rm -rf, database resets).
- Secrets hygiene: Plak nooit API-sleutels in prompts. Gebruik environment variabelen en gemaskeerde logs.
- Netwerktoegang: Als browsen is ingeschakeld, sandbox het dan en log uitgaande calls.
Lokale vs Cloud Modellen: Kiezen wat het beste voor jou is
- Voordelen: Sterke redenering/codering, minimale setup, snelle iteratie
- Nadelen: Doorlopende kosten, data governance overwegingen
- Voordelen: Privacy, controle, kosten voorspelbaarheid
- Nadelen: Hardware eisen, modelkwaliteit varieert, meer tuning nodig
Zie de officiële Local LLMs instructies om model backends en geheugenlimieten te configureren.
Team Play: OpenHands gebruiken in een Collaborative Flow
- Branch-first workflow: Laat OpenHands een feature branch maken en wijzigingen pushen voor PR review.
- Commit hygiene: Vraag het om atomic commits te produceren met duidelijke berichten en referentie issue nummers.
- PR templates: Genereer en forceer PR templates zodat reviewers weten wat er veranderd is en waarom.
- Code owners: Combineer met CODEOWNERS om AI-gegenereerde PRs naar de juiste reviewers te leiden.
Problemen oplossen
- Het loopt vast of in loops: Verklein de scope. Vraag het om de volgende stap uit te leggen. Geef een mislukte test.
- Rommelige diffs: Vraag om een kleiner, gefaseerd plan—eerst tests, dan minimale codewijzigingen.
- Verkeerde bestandsbewerkingen: Specificeer exacte paden en herinner het aan boundaries.
- Lokaal slagen maar falen in CI: Deel CI environment details en logs; laat het repliceren met een container.
Prestatie Tips en Power Moves
- Warm-start context: Vraag het om eerst belangrijke bestanden te lezen (
README, package.json, main service files).
- Geef het scripts: Geef een
make test of npm run verify zodat het snel kan valideren.
- Leer het de domain: Bied een kort architecturaal overzicht; het loont in minder logic errors.
- Forceer style: Wijs naar
.eslintrc, .prettierrc, black/ruff configs zodat het correct formatteert.
- Gebruik checkpoints: Vraag na elke milestone om een samenvatting en volgende stappen om het op het goede spoor te houden.
Real-World Scenario: Van Bug Report naar Patch in een uur
- Situatie: Een production bug dropt onbehandelde 500s op malformed JSON payloads in
orders API.
- Jouw prompt: "Reproduceer de 500 op malformed JSON in
orders POST. Voeg schema validatie toe en retourneer 400 met error details. Update tests om malformed payloads te dekken."
- Voert de API lokaal uit, reproduceert error
- Voegt een validatie layer en error handler toe
- Update tests en zorgt ervoor dat CI slaagt
- Produceert een compacte PR met een changelog entry
Tijd bespaard: Je focuste op impact analyse en rollout, terwijl OpenHands de scaffolding behandelde.
Integraties die OpenHands Superchargen
- Test runners: pytest, Jest, Vitest, JUnit
- Build tools: Vite, Webpack, Rollup, Babel
- Package managers: npm, pnpm, yarn, pip/poetry
- Linters/formatters: ESLint, Prettier, black, ruff
- Containers: Docker Compose voor local parity met CI
Door deze tools te standaardiseren, kan OpenHands betrouwbaarder redeneren over je stack en meer van de dev loop automatiseren.
Overigens: Sider.AI gebruiken naast OpenHands
Relevantie score: 8/10. Als je OpenHands gebruikt als je AI engineer, is het de moeite waard om het te combineren met een research en drafting copilot voor specs, PR beschrijvingen en documentatie. Sider.AI kan je trouwens helpen om snel technische specs op te stellen, RFCs samen te vatten of OpenHands run logs om te zetten in schone changelogs en release notes. De combinatie vermindert context-switching: OpenHands behandelt code acties terwijl Sider.AI uitkomsten omzet in schone, user-facing documenten.
Security, Privacy en Compliance Checklist
- Bewaar secrets in env vars; embed nooit keys in prompts
- Review elke AI-gegenereerde wijziging zoals je zou doen met de PR van een junior dev
- Log commando's en acties voor auditability
- Pin toolchain versies; vermijd onbedoelde upgrades in lockfiles
- Als je cloud LLMs gebruikt, stem af op je data retention policies
Wanneer OpenHands Niet te gebruiken
- Nieuw algoritme ontwerp zonder sterke test of spec scaffolding
- Sterk gereguleerde codebases zonder een robuust review process
- One-off throwaway scripts waar handmatig coderen sneller is
Je eerste 60 minuten met OpenHands: Een Mini Playbook
- Minuut 0–10: Installeer en start met behulp van de officiële Quickstart
- Minuut 10–20: Verbind je repo; vraag het om project structuur in kaart te brengen
- Minuut 20–35: Definieer een klein, testbaar doel; keur het plan goed
- Minuut 35–50: Laat het implementeren en tests uitvoeren; stuur bij waar nodig
- Minuut 50–60: Review diffs, verfijn en merge in een feature branch
Belangrijke Links en Volgende Stappen
- Officiële "Start Building" en usage docs voor OpenHands: tips, quickstart en best practices.
- Local LLM setup guide: configureer en voer OpenHands volledig op je machine uit.
- Community-driven install walkthrough op een VM: real-world install stappen en een quick demo project.
Takeaways
- Frame taken als tickets met duidelijke acceptatiecriteria.
- Houd iteraties klein; test vroeg en vaak.
- Gebruik guardrails en review wijzigingen—behandel het als een junior teamgenoot.
- Kies cloud voor gemak, lokale modellen voor privacy.
- Combineer met documentatie tools (bijv. Sider.AI) om specs en release notes te versnellen.
FAQ
V1:Hoe installeer ik en begin ik snel met AI OpenHands?
Gebruik de officiële quickstart om vereisten te installeren, een ondersteunde LLM (cloud of local) aan te sluiten en de UI te starten om je repository te verbinden. De "Start Building" docs bieden stapsgewijze instructies met setup tips.
V2:Kan ik OpenHands uitvoeren met een local LLM in plaats van een cloud model?
Ja. Volg de Local LLMs guide om een local model backend te configureren en context instellingen aan te passen. Dit is ideaal voor privacy-gevoelige projecten of het vermijden van API kosten.
V3:Wat is de beste manier om OpenHands te prompten voor coding taken?
Schrijf prompts als beknopte tickets: definieer het doel, verwijs naar specifieke bestanden, stel boundaries in en neem acceptatiecriteria op. Vraag het om tests te maken of uit te voeren om de voortgang te valideren.
V4:Is AI OpenHands veilig te gebruiken op production code?
Behandel het als een junior developer: gebruik branch protections, code review en CI om wijzigingen te valideren. Voeg guardrails toe voor commando's en houd secrets uit prompts.
V5:Hoe verhoudt OpenHands zich tot een traditionele code assistent?
In tegenstelling tot chat-only tools, kan OpenHands commando's uitvoeren, bestanden bewerken en autonoom itereren binnen je repo. Het is gebouwd voor end-to-end taken zoals features, debugging en tests.
