Metadata-Version: 2.4
Name: superpositions-kit
Version: 0.0.0
Summary: Hardware-agnostic Python library for variational quantum circuits with PennyLane, Qiskit, Braket backends.
Project-URL: Homepage, https://superpositions-studio.github.io/superpositions-kit
Project-URL: Documentation, https://superpositions-studio.github.io/superpositions-kit
Project-URL: Repository, https://github.com/superpositions-studio/superpositions-kit
Project-URL: Issues, https://github.com/superpositions-studio/superpositions-kit/issues
Project-URL: Changelog, https://github.com/superpositions-studio/superpositions-kit/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,hybrid-quantum-classical,pennylane,pytorch,qiskit,qml,quantum-computing,quantum-machine-learning,variational-quantum-circuits,vqc
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 :: Artificial Intelligence
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Typing :: Typed
Requires-Python: <3.13,>=3.11
Requires-Dist: numpy>=2.0
Requires-Dist: pydantic>=2.0
Description-Content-Type: text/markdown

# superpositions-kit

[![PyPI](https://img.shields.io/pypi/v/superpositions-kit)](https://pypi.org/project/superpositions-kit/)
[![Python](https://img.shields.io/pypi/pyversions/superpositions-kit)](https://pypi.org/project/superpositions-kit/)
[![License](https://img.shields.io/pypi/l/superpositions-kit)](LICENSE)
[![Docs](https://img.shields.io/badge/docs-superpositions--studio.github.io-blue)](https://superpositions-studio.github.io/superpositions-kit)

**superpositions-kit** is a hardware-agnostic Python library for building variational quantum circuits (VQCs) targeting PennyLane, Qiskit, and Amazon Braket backends with the same code.

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

## Installation

```bash
pip install --pre superpositions-kit
```

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-kit` 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-kit` is released under the [Apache License 2.0](LICENSE).
