Guía de instalación

Instala QZX sin pelearte con tu entorno Python

Elige una ruta de instalación según cómo uses Python. Mantén QZX aislado como CLI independiente con pipx, o instálalo con pip dentro de un entorno que controles intencionalmente.

QZX — Quick Zap Exchange es gratis y de código abierto, creado y mantenido por Alejandro Sánchez. El paquete publicado actual es 0.2.2.0.7 y declara Python >=3.11.

Elegir una ruta de instalación Continuar al inicio rápido para agentes

Elige según tu entorno

Tres formas honestas de empezar

CLI independiente

Mantén QZX aislado con pipx

Usa esta ruta cuando QZX sea una aplicación de línea de comandos de tu equipo y no una dependencia de un proyecto Python. pipx le da su propio entorno mientras expone el comando qzx en tu PATH.

pipx install qzx

Entorno Python controlado

Usa pip donde tú controles el entorno

Un entorno virtual activado u otro entorno Python que administres deliberadamente es un lugar válido para QZX. El comando del canal publicado sigue siendo compatible.

python -m pip install --upgrade qzx

Evaluar primero

Prueba la CLI publicada sin conservarla

Si ya tienes pipx, ejecuta QZX en un entorno aislado temporal y pídele al runtime que se identifique. Es útil cuando quieres evidencia antes de decidir si conservar la instalación.

pipx run --spec qzx qzx version

Verifica el runtime

Convierte la instalación en un primer éxito

No des por hecho que un instalador funcionó sólo porque no mostró un error evidente. Pide al runtime instalado que se identifique y luego completa el primer éxito canónico de solo lectura de QZX.

qzx version --json
qzx getCurrentDateTime --output-format iso --json

Cuando eso funcione, el inicio rápido para agentes de IA convierte la instalación en un flujo útil de inspección de proyectos. El runtime instalado sigue siendo la fuente de verdad de su propia versión y catálogo de comandos.

Si pip muestra externally-managed-environment

Respeta el límite del Python administrado

Algunos sistemas operativos y gestores de paquetes protegen su instalación base de Python. Ese mensaje significa que el intérprete base no es el destino adecuado para instalar una aplicación común con pip.

No lo fuerces con sudo pip, --break-system-packages, borrando un marcador EXTERNALLY-MANAGED ni cambiando la propiedad de directorios Python administrados. Instala pipx mediante el método admitido por tu plataforma y luego ejecuta pipx install qzx.

Guía oficial de instalación de pipx Evidencia de Python y plataformas de QZX

Conserva el control después

Actualiza o elimina la CLI aislada limpiamente

Una instalación con pipx sigue siendo administrable por separado en vez de convertirse en una dependencia invisible de otro proyecto.

pipx upgrade qzx
pipx uninstall qzx

Si qzx no aparece después de instalarlo, ejecuta pipx ensurepath y sigue la indicación de pipx para refrescar o volver a abrir el shell.

Límite de distribución

Usa canales publicados, no un binario imaginario

QZX publica actualmente su paquete Python para usuarios en PyPI. Ejecutables nativos independientes para Windows, bundles de aplicación para macOS, fórmulas de Homebrew y paquetes de distribuciones Linux no se anuncian actualmente como canales oficiales de QZX. Consulta versiones para ver artefactos publicados exactos y compatibilidad para la evidencia actual por plataforma.

¿Prefieres el documento de instalación junto al código fuente? La guía de instalación en GitHub registra el mismo límite público junto al código.