text4q-cortex 0.1.0a0__tar.gz

text4q_cortex-0.1.0a0/LICENSE

@@ -0,0 +1,96 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form.
+
+      "Work" shall mean the work of authorship made available under
+      the License, as indicated by a copyright notice that is included in
+      or attached to the work.
+
+      "Derivative Works" shall mean any work that is based on the Work.
+
+      "Contribution" shall mean any work of authorship submitted to the
+      Licensor for inclusion in the Work by the copyright owner or by
+      an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner.
+
+      "Contributor" shall mean Licensor and any Legal Entity on behalf of
+      whom a Contribution has been received by the Licensor.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      patent license to make, use, sell, offer for sale, import, and
+      otherwise transfer the Work.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or Derivative
+          Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in all copies or Derivative Works of the Work,
+          all copyright, patent, trademark, and attribution notices; and
+
+      (d) If the Work includes a "NOTICE" text file, include a readable
+          copy of the attribution notices contained within such NOTICE file.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      shall be under the terms and conditions of this License.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor.
+
+   7. Disclaimer of Warranty. The Work is provided on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND.
+
+   8. Limitation of Liability. In no event shall any Contributor be
+      liable for any damages arising from use of this Work.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work, You may offer additional warranty or liability obligations
+      consistent with this License.
+
+   Copyright 2024 text4q Cortex Contributors
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0

text4q_cortex-0.1.0a0/PKG-INFO

@@ -0,0 +1,131 @@
+Metadata-Version: 2.4
+Name: text4q-cortex
+Version: 0.1.0a0
+Summary: Natural language interface for quantum computing infrastructure
+Author: text4q Cortex Contributors
+License: Apache-2.0
+Keywords: quantum computing,nlp,qiskit,openqasm,orchestration
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Physics
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: qiskit>=1.0
+Requires-Dist: qiskit-ibm-runtime>=0.20
+Requires-Dist: pennylane>=0.35
+Requires-Dist: openai>=1.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: typer>=0.9
+Requires-Dist: rich>=13.0
+Requires-Dist: httpx>=0.25
+Requires-Dist: python-dotenv>=1.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: ruff>=0.1; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: pre-commit>=3.0; extra == "dev"
+Provides-Extra: aer
+Requires-Dist: qiskit-aer>=0.13; extra == "aer"
+Dynamic: license-file
+
+# text4q Cortex
+
+> Natural language interface for quantum computing infrastructure.  
+> Write quantum intent in plain language — Cortex compiles, schedules, and executes it on real QPUs.
+
+```python
+from cortex import Cortex
+
+cx = Cortex(backend="ibm_quantum")
+result = cx.run("Simulate a Bell state with 2 qubits and measure 1024 times")
+print(result.counts)
+# {'00': 512, '11': 512}
+```
+
+## What is text4q Cortex?
+
+Cortex is an open-source quantum orchestration platform built on three pillars:
+
+- **NLP → Circuit**: Translate natural language descriptions into OpenQASM 3.0 circuits
+- **Orchestration**: Manage QPU resources via QRMI, integrating quantum and classical HPC
+- **Execution**: Schedule and run jobs across IBM Quantum, Google, or custom lab QPUs
+
+## Architecture
+
+```
+User (natural language)
+        ↓
+  Cortex NLP Engine          ← text4q core: language → OpenQASM
+        ↓
+  OQTOPUS Job Queue          ← cloud layer: scheduling + auth
+        ↓
+  QAOA Scheduler             ← quantum-native optimization (roadmap)
+        ↓
+  QRMI Resource Manager      ← QPU as HPC node
+        ↓
+  QPU / Simulator            ← IBM Quantum, Google, Qiskit Aer
+```
+
+## Installation
+
+```bash
+pip install text4q-cortex
+```
+
+Or from source:
+
+```bash
+git clone https://github.com/your-org/text4q-cortex
+cd text4q-cortex
+pip install -e ".[dev]"
+```
+
+## Quick Start
+
+```python
+from cortex import Cortex
+from cortex.connectors import IBMQuantumConnector
+
+# Connect to IBM Quantum
+connector = IBMQuantumConnector(token="YOUR_IBM_TOKEN")
+cx = Cortex(connector=connector)
+
+# Run from natural language
+result = cx.run(
+    "Create a GHZ state with 3 qubits, apply noise model T1=50us, measure 2048 shots"
+)
+
+print(result.circuit)   # the generated OpenQASM circuit
+print(result.counts)    # measurement results
+print(result.metadata)  # backend, shots, execution time
+```
+
+## Modules
+
+| Module | Description | Status |
+|--------|-------------|--------|
+| `cortex.nlp` | NLP → OpenQASM translation engine | 🚧 v0.1 |
+| `cortex.connectors` | IBM Quantum, Aer, Google backends | 🚧 v0.1 |
+| `cortex.scheduler` | Job queue and QPU resource management | 📋 planned |
+| `cortex.cloud` | Multi-user cloud layer (OQTOPUS-based) | 📋 planned |
+
+## Roadmap
+
+- [x] Project structure and architecture
+- [ ] v0.1 — NLP engine (pattern-based) + IBM Quantum connector
+- [ ] v0.2 — LLM-powered circuit generation + multi-backend
+- [ ] v0.3 — OQTOPUS job queue integration
+- [ ] v0.4 — QAOA Scheduler (quantum-native scheduling)
+- [ ] v1.0 — text4q Cortex Cloud (SaaS)
+
+## Contributing
+
+Contributions welcome. Please read [CONTRIBUTING.md](docs/CONTRIBUTING.md) first.
+
+## License
+
+Apache 2.0 — see [LICENSE](LICENSE).

text4q_cortex-0.1.0a0/README.md

@@ -0,0 +1,97 @@
+# text4q Cortex
+
+> Natural language interface for quantum computing infrastructure.  
+> Write quantum intent in plain language — Cortex compiles, schedules, and executes it on real QPUs.
+
+```python
+from cortex import Cortex
+
+cx = Cortex(backend="ibm_quantum")
+result = cx.run("Simulate a Bell state with 2 qubits and measure 1024 times")
+print(result.counts)
+# {'00': 512, '11': 512}
+```
+
+## What is text4q Cortex?
+
+Cortex is an open-source quantum orchestration platform built on three pillars:
+
+- **NLP → Circuit**: Translate natural language descriptions into OpenQASM 3.0 circuits
+- **Orchestration**: Manage QPU resources via QRMI, integrating quantum and classical HPC
+- **Execution**: Schedule and run jobs across IBM Quantum, Google, or custom lab QPUs
+
+## Architecture
+
+```
+User (natural language)
+        ↓
+  Cortex NLP Engine          ← text4q core: language → OpenQASM
+        ↓
+  OQTOPUS Job Queue          ← cloud layer: scheduling + auth
+        ↓
+  QAOA Scheduler             ← quantum-native optimization (roadmap)
+        ↓
+  QRMI Resource Manager      ← QPU as HPC node
+        ↓
+  QPU / Simulator            ← IBM Quantum, Google, Qiskit Aer
+```
+
+## Installation
+
+```bash
+pip install text4q-cortex
+```
+
+Or from source:
+
+```bash
+git clone https://github.com/your-org/text4q-cortex
+cd text4q-cortex
+pip install -e ".[dev]"
+```
+
+## Quick Start
+
+```python
+from cortex import Cortex
+from cortex.connectors import IBMQuantumConnector
+
+# Connect to IBM Quantum
+connector = IBMQuantumConnector(token="YOUR_IBM_TOKEN")
+cx = Cortex(connector=connector)
+
+# Run from natural language
+result = cx.run(
+    "Create a GHZ state with 3 qubits, apply noise model T1=50us, measure 2048 shots"
+)
+
+print(result.circuit)   # the generated OpenQASM circuit
+print(result.counts)    # measurement results
+print(result.metadata)  # backend, shots, execution time
+```
+
+## Modules
+
+| Module | Description | Status |
+|--------|-------------|--------|
+| `cortex.nlp` | NLP → OpenQASM translation engine | 🚧 v0.1 |
+| `cortex.connectors` | IBM Quantum, Aer, Google backends | 🚧 v0.1 |
+| `cortex.scheduler` | Job queue and QPU resource management | 📋 planned |
+| `cortex.cloud` | Multi-user cloud layer (OQTOPUS-based) | 📋 planned |
+
+## Roadmap
+
+- [x] Project structure and architecture
+- [ ] v0.1 — NLP engine (pattern-based) + IBM Quantum connector
+- [ ] v0.2 — LLM-powered circuit generation + multi-backend
+- [ ] v0.3 — OQTOPUS job queue integration
+- [ ] v0.4 — QAOA Scheduler (quantum-native scheduling)
+- [ ] v1.0 — text4q Cortex Cloud (SaaS)
+
+## Contributing
+
+Contributions welcome. Please read [CONTRIBUTING.md](docs/CONTRIBUTING.md) first.
+
+## License
+
+Apache 2.0 — see [LICENSE](LICENSE).

text4q_cortex-0.1.0a0/cortex/__init__.py

@@ -0,0 +1,16 @@
+"""
+text4q Cortex
+=============
+Natural language interface for quantum computing infrastructure.
+
+Quick start:
+    from cortex import Cortex
+    cx = Cortex(backend="ibm_quantum")
+    result = cx.run("Bell state with 2 qubits, 1024 shots")
+"""
+
+from cortex.core import Cortex
+from cortex.models import CortexResult, CircuitIntent
+
+__version__ = "0.1.0-alpha"
+__all__ = ["Cortex", "CortexResult", "CircuitIntent"]