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.15 y declara Python >=3.11.
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 qzxEntorno 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 qzxEvaluar 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 versionVerifica 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 --jsonCuando 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.
¿Instalaste QZX pero la terminal no encuentra qzx?
Elige la recuperación que corresponda a tu instalación. Que falte el lanzador no significa necesariamente que falte el paquete.
Lo instalé con pip: usar el mismo Python
Usa el mismo Python con el que instalaste: python, python3 o py -3.13.
python -m qzx version --json
python -m qzx getCurrentDateTime --output-format iso --jsonUsa exactamente el intérprete que ejecutó python -m pip install --upgrade qzx. La ejecución como módulo no necesita el lanzador qzx en PATH.
Si instalaste con python3 o py -3.13, sustituye python por ese mismo prefijo en todos los comandos siguientes. No cambies de intérprete a mitad del proceso.
¿No module named qzx o una versión inesperada?
Comprueba este intérprete antes de reinstalar. Activa el entorno donde instalaste QZX y revisa su pip y la ubicación del paquete:
python -m pip --version
python -m pip show qzxSi pip no encuentra QZX aquí, el paquete no está en este intérprete. Si qzx version --json y el comando como módulo muestran versiones distintas, resuelven instalaciones diferentes. Actualiza sólo la que quieras usar. Un error externally-managed-environment sigue requiriendo un entorno que controles o pipx, no forzar el Python administrado.
Lo instalé con pipx: recuperar su lanzador
Ejecuta primero pipx list. Si QZX aparece, ejecuta pipx ensurepath y sigue sus indicaciones para volver a abrir o refrescar la terminal; después prueba qzx version --json. Si QZX no aparece, usa la opción de instalación con pipx de arriba.
El Python del sistema normalmente no puede importar un paquete aislado por pipx: python -m qzx no es una reparación de pipx. pipx run prueba un entorno temporal, no tu instalación existente.
Cuando la verificación funcione, abre la carpeta de tu propio proyecto y prueba python -m qzx diagnoseProject . con el intérprete usado por pip, o qzx diagnoseProject . con el lanzador de pipx. QZX inspecciona el proyecto; no ejecuta sus pruebas ni sus scripts de build.
Antes de compartir diagnósticos, elimina rutas personales, credenciales y detalles de proyectos privados.
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.
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 qzxSi 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.