Metadata-Version: 2.5
Name: superpositions-router-client
Version: 0.0.0
Summary: Client for Superpositions Router: run superpositions-kit circuits on real quantum hardware with one Superpositions API key.
Project-URL: Homepage, https://github.com/superpositions-studio/superpositions-router-client
Project-URL: Repository, https://github.com/superpositions-studio/superpositions-router-client
Project-URL: Issues, https://github.com/superpositions-studio/superpositions-router-client/issues
Project-URL: Changelog, https://github.com/superpositions-studio/superpositions-router-client/blob/main/CHANGELOG.md
Author-email: Superpositions Studio <support@superpositions.studio>
Maintainer-email: Superpositions Studio <support@superpositions.studio>
License-Expression: Apache-2.0
License-File: LICENSE
License-File: NOTICE
Keywords: braket,ibm-quantum,qpu,quantum-computing,quantum-hardware,superpositions-kit
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Typing :: Typed
Requires-Python: <3.13,>=3.11
Description-Content-Type: text/markdown

# superpositions-router-client

[![PyPI](https://img.shields.io/pypi/v/superpositions-router-client)](https://pypi.org/project/superpositions-router-client/)
[![Python](https://img.shields.io/pypi/pyversions/superpositions-router-client)](https://pypi.org/project/superpositions-router-client/)
[![License](https://img.shields.io/pypi/l/superpositions-router-client)](LICENSE)

**superpositions-router-client** lets [superpositions-kit](https://pypi.org/project/superpositions-kit/) users run circuits on real quantum hardware (Amazon Braket, IBM Quantum) through Superpositions Router, with one Superpositions API key and a prepaid balance instead of vendor credentials.

> **Public scaffolding.** The full implementation is being prepared for release. Track progress on the [GitHub repository](https://github.com/superpositions-studio/superpositions-router-client).

## Installation

```bash
pip install --pre superpositions-router-client
```

The `--pre` flag is required while the library is on a pre-release placeholder. Once the full implementation lands as `0.1.0`, plain `pip install superpositions-router-client` will work.

## Contributing

We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, testing, and commit conventions. Please also read our [Code of Conduct](CODE_OF_CONDUCT.md).

## Reporting security issues

Do not file public issues for security vulnerabilities. Report them privately as described in [SECURITY.md](SECURITY.md).

## License

`superpositions-router-client` is released under the [Apache License 2.0](LICENSE).
