From API key to quantum results in 3 steps. Install the SDK, configure your credentials, and run your first circuit.
Make sure you have the following set up before installing the EpochCore Quantum SDK.
Free tier available at quantum.ibm.com. Generate an API token from your account dashboard.
The SDK requires Python 3.10 or later. Verify with python --version in your terminal.
Included with Python. Update to latest with pip install --upgrade pip before proceeding.
Get from zero to running quantum circuits on real IBM hardware in under five minutes.
Install the EpochCore Quantum package from PyPI. This includes the CLI, Python client, and all required dependencies.
$ pip install epochcore-quantumAuthenticate with your EpochCore API key. This stores your credentials securely in ~/.epochcore/config.json.
$ epochcore config --api-key YOUR_KEYExecute a Bell pair circuit on IBM Fez, a 156-qubit Heron processor. The CLI handles transpilation, error correction, and result retrieval automatically.
$ epochcore run bell-pair --backend ibm_fez
Backend: ibm_fez (156 qubits, Heron r2)
Shots: 1024
Fidelity: 99.2%
Queue time: 0ms (zero-queue)
Results:
|00⟩ 512 (50.0%)
|11⟩ 512 (50.0%)Use the Python client for full control over circuit submission, backend selection, and result analysis.
from epochcore import QuantumClient
# Initialize with your API key
client = QuantumClient(api_key="your-key")
# Submit a circuit with fidelity-first routing
result = client.run_circuit(
qasm="...",
backend="auto", # fidelity-first routing
shots=1024
)
# Access measurement results
print(result.counts)
The backend="auto" parameter enables fidelity-first routing, automatically selecting the best available backend based on real-time calibration data across all 6 Heron processors.
Choose a plan that fits your workload and start running quantum circuits on real hardware today.