Registry / aws / qcs-sdk-python

qcs-sdk-python

library0.26.1pypypi✓ verified 87d ago

Python interface for the QCS Rust SDK, providing the core data structures and client for interacting with Rigetti Quantum Cloud Services. Version 0.26.1 requires Python >=3.10 and <4.0. Release cadence is irregular, tied to the underlying Rust SDK.

aws llm-agents ai-ml

pip install qcs-sdk-python

package ↗homepage ↗

INSTALL

IMPORT

SIG · QCS-SDK-PYTHON

qcs-sdk-python

awspythonv0.26.1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

QCSClient

✓ from qcs_sdk import QCSClient

✗ from qcs_sdk.client import QCSClient

QCSClient is exposed directly from the top-level module since v0.20.

ExecutionData

✓ from qcs_sdk import ExecutionData

✗ from qcs_sdk.execution import ExecutionData

ExecutionData was moved to top-level to simplify the API.

Initialize a QCSClient and list available quantum processors. Set environment variables QCS_API_KEY and QUANTUM_PROCESSOR_ID for authentication.

import os from qcs_sdk import QCSClient client = QCSClient( quantum_processor_id=os.environ.get("QUANTUM_PROCESSOR_ID", ""), api_key=os.environ.get("QCS_API_KEY", ""), api_url=os.environ.get("QCS_API_URL", "https://api.qcs.rigetti.com") ) print(client.list_quantum_processors())

Debug

Known issues

breakingIn v0.24, the 'QCSClient' constructor changed: 'api_key' and 'api_url' parameters replaced 'credentials' and 'endpoint'. Code using the old signature will fail.

fix

Update client initialization to use new parameters: QCSClient(api_key=..., api_url=...).

affects: <0.24

breakingThe 'ExecutionData' class was moved from qcs_sdk.execution.ExecutionData to qcs_sdk.ExecutionData in v0.20. Old imports break.

fix

Change import to 'from qcs_sdk import ExecutionData'.

affects: <0.20

deprecatedThe function 'get_qpu' is deprecated in favor of 'QCSClient.get_quantum_processor()' since v0.22.

fix

Use client.get_quantum_processor(quantum_processor_id) instead.

affects: >=0.22

gotchaThe package name on PyPI is 'qcs-sdk-python', but the importable module is 'qcs_sdk' (underscore, not hyphen). This mismatch confuses beginners.

fix

Always use 'import qcs_sdk' or 'from qcs_sdk import ...' in code, never 'qcs-sdk-python'.

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'qcs.sdk'

Incorrect import path; many tutorials use the old 'qcs.sdk' module name.

fix

Use 'from qcs_sdk import ...' (underscore, not dot).

TypeError: __init__() got an unexpected keyword argument 'credentials'

Using the old QCSClient constructor with 'credentials' parameter. It was renamed to 'api_key' and 'api_url'.

fix

Use 'QCSClient(api_key='...', api_url='...')' instead.

AttributeError: module 'qcs_sdk' has no attribute 'ExecutionConfig'

ExecutionConfig was removed in v0.21; configuration is now done via client methods.

fix

Use client methods like 'client.compile_program()' or 'client.run_program()' instead of ExecutionConfig.

Upgrade

Version history

0.26.1latest on PyPI · released Mar 30, 2026

Audit

Dependencies

qcs-sdk-pythonrequiredThe package itself has no hard dependencies beyond Python standard library; Rust extensions are pre-built.

Agent activity

32 hits · last 30 days

node

OpenAI (training)

Resources

packagehttps://pypi.org/project/qcs-sdk-python/ ↗

homepagehttps://docs.rigetti.com ↗