Skip to content

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

  1. Entra a un repositorio de Git con al menos un commit.
  2. harness init crea .harness/project.yaml y una tarea de ejemplo.
  3. 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]"