JSPM – @thiagovt-dev/xodex-cli@0.2.7

Package Exports

@thiagovt-dev/xodex-cli
@thiagovt-dev/xodex-cli/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@thiagovt-dev/xodex-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Wrapper em Node.js para o Xodex, um utilitário escrito em Python que oferece ferramentas de automação, integração com IA e fluxos de desenvolvimento.

Este pacote permite que você instale e execute o Xodex diretamente via npm, sem precisar lidar manualmente com pip ou dependências Python — o wrapper cuida da instalação automática do core quando necessário.

🚀 Instalação

npm i -g @thiagovt-dev/xodex-cli

O comando xodex ficará disponível globalmente.
Na primeira execução, caso o core Python ainda não esteja instalado, o wrapper tentará instalá-lo automaticamente usando múltiplas estratégias:

pipx (recomendado para ambientes isolados)
pip com --break-system-packages (para ambientes externamente gerenciados como Ubuntu/Debian)
pip --user (instalação tradicional)

Requisitos:

Node.js >= 18
Python 3.8+ disponível no sistema
pipx (opcional, mas recomendado para melhor isolamento)

🛠️ Uso

xodex --help

Exemplos:

# rodar comando padrão
xodex run

# verificar versão
xodex --version

🔧 Troubleshooting

Erro "externally-managed-environment"

Se você encontrar o erro externally-managed-environment (comum em Ubuntu/Debian), o wrapper tentará automaticamente usar --break-system-packages. Se ainda assim falhar, instale manualmente:

# Opção 1: Usando pipx (recomendado)
pipx install xodex-cli

# Opção 2: Usando pip com --break-system-packages
python3 -m pip install --break-system-packages xodex-cli

# Opção 3: Instalação tradicional
python3 -m pip install --user xodex-cli

Python não encontrado

Se o Python não for encontrado, instale-o:

# Ubuntu/Debian
sudo apt update && sudo apt install python3 python3-pip

# macOS (com Homebrew)
brew install python

# Windows
# Baixe do site oficial: https://www.python.org/downloads/

Instalar pipx (recomendado)

# Ubuntu/Debian
sudo apt install pipx

# macOS
brew install pipx

# Windows
pip install pipx

📚 Links úteis

Core Python (repositório principal): github.com/thiagovt-dev/xodex
Reportar problemas: Issues

@thiagovt-dev/xodex-cli