Metadata-Version: 2.4
Name: LoomQ
Version: 0.1.0
Summary: LoomQ: 量子接入平权计划 (Quantum Access Equality Project) - 统一量子中间层与智能体适配器
Author-email: QIanGua <15757826110@163.com>
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.12
Description-Content-Type: text/markdown

# LoomQ: 量子接入平权计划 (Quantum Access Equality Project)

LoomQ 旨在打破硬核科技的门槛与话语权壁垒，让不懂底层“黑话”与物理指令集的创造者，也能通过自然语言和统一接口自由指挥前沿的量子算力。

---

## 🎯 核心目标

1. **量子通用中间层 (Unified Quantum Layer)**：以 OpenQASM 2.0 为统一输入，提供跨平台的翻译、适配与运行能力。
2. **说“人话”的量子智能体 (Natural Language Agent)**：支持通过自然语言生成/修复量子电路、智能推荐执行后端。
3. **量子-经典混合编译 (Hybrid-QASM & RISC-V)**：将混合了经典控制流的量子电路编译为 RISC-V 汇编与量子序列，探索量子软硬件一体化设计。

---

## 📦 支持后端

目前 LoomQ 规划并打通以下后端的适配：
- **量旋云 / SpinQit** (支持 Taurus 超导真机及模拟器)
- **本源量子云** (QPanda3 / OriginIR，支持悟空真机)
- **AWS Braket** (支持 OpenQASM 3.0 与本地模拟器)

---

## 🚀 快速开始

### 安装

```bash
pip install LoomQ
```

### 核心接口使用示例

```python
import loomq

# 1. 线路转译 (Transpile OpenQASM 2.0 to Target Backend Native Code)
qasm_code = """
OPENQASM 2.0;
include "qelib1.inc";
qreg q[2];
creg c[2];
h q[0];
cx q[0], q[1];
measure q -> c;
"""
target_code = loomq.transpile(qasm_code, target="braket")
print("Braket QASM 3.0:\n", target_code)

# 2. 统一运行接口 (Run on Target Backend)
result = loomq.run(qasm_code, target="spinq", shots=1024)
print("Execution Result:\n", result)

# 3. 智能体交互 (Interactive Quantum Agent)
response = loomq.agent_chat("帮我生成一个 3 比特 GHZ 最大纠缠态线路")
print("Agent:\n", response)

# 4. 混合控制流编译 (Hybrid Compilation to RISC-V Assembly)
quantum_ops, riscv_asm = loomq.compile_hybrid("""
OPENQASM 2.0;
qreg q[2];
creg c[2];
h q[0];
measure q[0] -> c[0];
classical {
    if (c[0] == 1) {
        r1 = 1;
    }
}
""")
```

---

## 📄 开源协议

本项目采用 MIT 协议开源。
