Metadata-Version: 2.4
Name: moons-quantum
Version: 0.1.0
Summary: Python SDK for Moons Quantum — AI-powered quantum circuit optimization and routing
Author-email: "Moons Quantum Corp." <info@moonsenterprises.com>
License: MIT
Project-URL: Homepage, https://moonsquantum.com
Project-URL: Documentation, https://moonsquantum.com/docs
Project-URL: Repository, https://github.com/DEBURGEMEESTER/Moons-Quantum-Corp.
Project-URL: Issues, https://github.com/DEBURGEMEESTER/Moons-Quantum-Corp./issues
Keywords: quantum,qiskit,pennylane,circuit,optimization,routing
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.24.0
Dynamic: license-file

# moons-quantum

Python SDK for **Moons Quantum** — AI-powered quantum circuit optimization and routing.

Optimize your quantum circuits before they hit real hardware. Reduce SWAP overhead, skip the queue, and cut cloud compute costs.

## Installation

```bash
pip install moons-quantum
```

## Quick Start

```python
import moons_quantum as moons

# Set your API key (get one free at moonsquantum.com)
moons.api_key = "mqc_your_key_here"

# Optimize a circuit
result = moons.optimize(qubits=4, topology="grid", generations=10)

print(result.status)              # "completed"
print(result.best_circuit_qasm)   # OPENQASM 2.0; ...
print(result.fidelity)            # 98.5 (percentage)
print(result.depth)               # 12
```

## Route API

The high-level `route()` function picks the best optimization strategy automatically:

```python
result = moons.route(budget=50, topology="linear", qubits=6)
print(result.best_circuit_qasm)
```

## Check Job Status

For async workflows, submit without waiting and check later:

```python
result = moons.optimize(qubits=8, wait=False)
print(result.job_id)  # "a1b2c3d4-..."

# Check later
status = moons.get_job(result.job_id)
print(status.is_complete)
```

## Topology Options

| Topology | Description | Use Case |
|---|---|---|
| `"all"` | All-to-all connectivity | Ideal / trapped-ion |
| `"linear"` | Linear chain | Basic NISQ devices |
| `"ring"` | Ring connectivity | Neutral atom arrays |
| `"grid"` | 2D grid / square lattice | IBM superconducting QPUs |

## API Health Check

```python
print(moons.health())
# {"status": "healthy"}
```

## Configuration

```python
import moons_quantum as moons

moons.api_key = "mqc_..."                          # Your API key
moons.api_url = "https://custom-server.com"        # Custom server URL (optional)
```

## Links

- **Website**: [moonsquantum.com](https://moonsquantum.com)
- **GitHub**: [github.com/DEBURGEMEESTER/Moons-Quantum-Corp.](https://github.com/DEBURGEMEESTER/Moons-Quantum-Corp.)
- **Issues**: [Report a bug](https://github.com/DEBURGEMEESTER/Moons-Quantum-Corp./issues)

## License

MIT
