Instalación¶
Guía básica para instalar el harness y comprobar que funciona. Para pipx, extras, una versión concreta, verificación de la firma, instalación sin red, actualización y desinstalación, ver Instalación avanzada.
Requisitos¶
- Python 3.12 o superior.
- Git: el harness calcula los cambios contra el repositorio.
- Para proyectos Node.js, Node.js LTS y npm.
El harness es un paquete de Python. No se instala con npm ni con npx.
Elige un canal¶
| Canal | Cuándo usarlo | Comando |
|---|---|---|
| PyPI | Lo más simple, si el mantenedor ya habilitó la publicación. | pip install governed-agent-harness |
| Wheel del release de GitHub | Una versión concreta, verificable con suma de comprobación y atestación. | pip install "governed-agent-harness @ <URL del wheel>" |
| Docker (GHCR) | No quieres instalar Python en tu equipo. | docker run --rm ghcr.io/sebasbarrera/harness-engineering:<versión> --help |
| Código fuente | Vas a modificar el harness. | pip install -e ".[dev,api]" dentro del clon |
La publicación en PyPI se activa con una variable del repositorio y una configuración que hace el mantenedor una sola vez (ver Publicación). Está previsto que la 2.0.1 sea la primera versión publicada ahí. Sin verificar todavía: el 2026-11-11, antes del release 2.0.1, https://pypi.org/pypi/governed-agent-harness/json respondía 404 y pip index versions governed-agent-harness no encontraba el paquete; mientras sea así, usa el wheel del release.
Desde PyPI¶
Dentro de un entorno virtual:
python3.12 -m venv .venv
source .venv/bin/activate
pip install governed-agent-harness
harness --version
Desde el wheel del release¶
Cada versión publica en GitHub Releases el wheel, el sdist, SHA256SUMS y un SBOM. Instala el wheel directamente desde su URL:
python3.12 -m venv .venv
source .venv/bin/activate
pip install "governed-agent-harness @ https://github.com/SebasBarrera/harness-engineering/releases/download/v2.0.1/governed_agent_harness-2.0.1-py3-none-any.whl"
harness --version
Cambia v2.0.1 y 2.0.1 por la versión que quieras. Para verificar el archivo antes de instalarlo, ver Instalación avanzada.
Con Docker¶
La imagen se publica en GHCR con cada versión, para linux/amd64 y linux/arm64, y corre con un usuario sin privilegios (uid 10001):
docker run --rm ghcr.io/sebasbarrera/harness-engineering:2.0.1 --help
Para trabajar sobre un proyecto, monta el repositorio en /workspace, que es el directorio de trabajo de la imagen:
docker run --rm -v "$PWD":/workspace ghcr.io/sebasbarrera/harness-engineering:2.0.1 doctor --path /workspace
No pude ejecutar los comandos de Docker de esta página (sin red en el entorno de prueba). Lo que sí comprueba el flujo docker.yml en cada push es que la imagen responde a --help y a doctor y que corre con el uid 10001. Dos cuidados esperables con el montaje: el usuario de la imagen debe poder escribir en el directorio montado, y Git puede quejarse de «dubious ownership» si el propietario del montaje es otro usuario.
Comprobar la instalación¶
harness --version
harness doctor
harness --version imprime la versión (en la prueba, harness 1.0.0). harness doctor revisa Python, Git, Node.js y npm; fuera de un proyecto solo valida el entorno, y con --path también valida el proyecto.
Primeros pasos¶
- Entra a un repositorio de Git con al menos un commit.
harness initcrea.harness/project.yamly una tarea de ejemplo.- Sigue Primeros pasos para tu primera ejecución, o las guías de proyecto nuevo y proyecto existente.
Si quieres el tablero web local, instala también el extra api:
pip install "governed-agent-harness[api]"