Instalação
Instale QZX em um ambiente Python que você controla
A instalação não precisa ser complicada: use pip em um ambiente virtual ou pipx para manter a CLI isolada. Depois confirme a versão e execute um diagnóstico somente leitura.
Já instalou, mas qzx não inicia?
Experimente o QZX em 60 segundos
Confirme o QZX com um timestamp ISO rápido e somente leitura.
python -m pip install --upgrade qzx
qzx getCurrentDateTime --output-format iso --json
Execute estes dois comandos no seu terminal. Um JSON com success: true e message não vazio confirma a primeira verificação; copiar não instala nem executa nada.
QZX — Quick Zap Exchange, criado e mantido por Alejandro Sánchez.
QZX para Codex, Claude Code e Gemini CLI — Início RápidoOpção direta com pip
Dentro de um ambiente Python apropriado, instale o pacote publicado em PyPI.
python -m pip install --upgrade qzx
qzx version
Opção isolada com pipx
pipx cria um ambiente dedicado para a CLI e expõe o executável no seu PATH.
pipx install qzx
qzx version
Primeiro teste útil
Depois da instalação, execute um comando que não altera o sistema. Se você está trabalhando com um agente de programação, diagnoseProject costuma ser um ponto de partida melhor do que inventar um script de reconhecimento.
qzx getCurrentDateTime
qzx diagnoseProject .
Instalou QZX, mas o terminal não encontra qzx?
Escolha a recuperação correspondente à sua instalação. A ausência do executável no PATH não significa necessariamente que o pacote não foi instalado.
Instalei com pip: usar o mesmo Python
Use o mesmo Python da instalação: python, python3 ou py -3.13.
python -m qzx version --json
python -m qzx getCurrentDateTime --output-format iso --json
Use exatamente o interpretador que executou python -m pip install --upgrade qzx. A execução como módulo não depende do executável qzx no PATH.
Se instalou com python3 ou py -3.13, substitua python pelo mesmo prefixo em todos os comandos abaixo. Não troque de interpretador no meio do processo.
No module named qzx ou uma versão inesperada?
Confira este interpretador antes de reinstalar. Ative o ambiente em que instalou QZX e verifique o pip e a localização do pacote:
python -m pip --version
python -m pip show qzx
Se o pip não encontrar QZX aqui, o pacote não está neste interpretador. Se qzx version --json e o comando como módulo mostrarem versões diferentes, eles usam instalações distintas. Atualize somente a que pretende usar. Um erro externally-managed-environment ainda exige um ambiente sob seu controle ou pipx, não uma alteração forçada no Python gerenciado.
Instalei com pipx: restaurar o executável
Execute primeiro pipx list. Se QZX estiver listado, execute pipx ensurepath e siga as instruções para reabrir ou atualizar o terminal; depois tente qzx version --json. Se QZX não aparecer, use a opção de instalação com pipx acima.
O Python do sistema normalmente não consegue importar um pacote isolado pelo pipx: python -m qzx não é uma correção do pipx. pipx run testa um ambiente temporário, não a instalação existente.
Quando a verificação funcionar, abra a pasta do seu próprio projeto e tente python -m qzx diagnoseProject . com o interpretador usado pelo pip, ou qzx diagnoseProject . com o executável do pipx. QZX inspeciona o projeto; não executa seus testes nem scripts de build.
Antes de compartilhar diagnósticos, remova caminhos pessoais, credenciais e detalhes de projetos privados.