Troubleshooting
Installation
Section titled “Installation”pip install qubithub-sdk fails
Section titled “pip install qubithub-sdk fails”Ensure you have Python 3.11 or later:
python --versionTry using a virtual environment:
python -m venv .venvsource .venv/bin/activatepip install qubithub-sdkAuthentication
Section titled “Authentication”qubithub login prompts for email but authentication fails
Section titled “qubithub login prompts for email but authentication fails”Double-check your email and password. If you don’t have an account yet, register at qubithub.co/register. For non-interactive auth (CI/CD), pass an API key directly:
qubithub login --api-key qh_abc123...“Unauthorized” error on API calls
Section titled ““Unauthorized” error on API calls”Your token may have expired. Re-authenticate:
qubithub logout && qubithub loginExecution
Section titled “Execution”Circuit times out
Section titled “Circuit times out”The default timeout is 30 seconds. Large circuits with many shots may need more time. Try reducing --shots.
”Module not found” during execution
Section titled “”Module not found” during execution”QubitHub’s sandbox includes Qiskit, PennyLane, Cirq, NumPy, and SciPy. Other packages are not available in the sandbox environment.
Uploads
Section titled “Uploads””Invalid TOML” error on push
Section titled “”Invalid TOML” error on push”Validate your manifest locally:
qubithub circuits metadata -f jsonCheck the qubithub.toml Reference for required fields.