OpenHands
Qué cubre este artículo
- Qué es OpenHands y para qué sirve.
- Cómo iniciar OpenHands con Docker.
- Cómo conectar un repositorio de GitHub.
- Cómo se ve un flujo de trabajo con OpenHands.
- Cuándo OpenHands es útil y dónde encuentra limitaciones.
Introducción
OpenHands es un proyecto de código abierto para desarrollo de software asistido por IA. Un agente puede entender código, editarlo, proponer commits y generar pull requests. Lo interesante es que OpenHands trabaja en un repositorio real, puede leer archivos, ejecutar tests y procesar feedback del código.
OpenHands en pocas palabras
OpenHands consiste en un contenedor que ejecuta el agente y una interfaz web. Conectas un repositorio de GitHub o una carpeta local. Luego das instrucciones en lenguaje natural. El agente planifica qué archivos abre, qué cambia y cómo lo prueba.
Instalación
La forma más rápida es con 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.18Después del inicio, abre http://localhost:3000. Para imágenes antiguas u otras versiones, revisa la documentación actual.
Configurar el token de GitHub
Para repositorios necesitas un token de GitHub:
export GITHUB_TOKEN="tu-token"OpenHands puede crear commits, branches y pull requests con él. Sin el token solo funciona localmente.
Primeros pasos: asignar una tarea
- Abre
http://localhost:3000. - Conecta tu repositorio o selecciona una carpeta local.
- Ingresa una tarea, por ejemplo: “Añade una función que valide direcciones de correo electrónico.”
- Espera mientras el agente crea y ejecuta el plan.
- Revisa los cambios propuestos.
¿Para qué es útil OpenHands?
| Caso de uso | Beneficio |
|---|---|
| Refactoring | Limpiar y mejorar el código |
| Sugerencias de features | Implementar pequeñas funciones a partir de descripciones |
| Documentación | Complementar comentarios de código y README |
| Aprendizaje | Entender paso a paso cómo un agente aborda el código |
Obstáculos comunes
- Seguridad - OpenHands puede ejecutar código. Úsalo solo en repositorios aislados o Docker.
- Permisos del token - El token de GitHub necesita permisos apropiados para commits y pull requests.
- Costos y tiempo - Las tareas grandes requieren muchas llamadas a modelos y tardan más.
Enlaces relacionados
FAQ - Preguntas frecuentes
¿Es OpenHands gratuito?
Sí, el proyecto de código abierto es gratuito. Los costos surgen solo por APIs de modelos u hosting en la nube.
¿Puedo ejecutar OpenHands localmente?
Sí, con Docker. Es la forma recomendada para probarlo.
¿Necesito GitHub?
No, las carpetas locales también funcionan. Para trabajo real en proyectos, un repositorio de GitHub es práctico.