superquantx 0.1.0__tar.gz → 0.1.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (59) hide show
  1. {superquantx-0.1.0 → superquantx-0.1.1}/.gitignore +5 -1
  2. {superquantx-0.1.0 → superquantx-0.1.1}/CHANGELOG.md +2 -2
  3. superquantx-0.1.1/LICENSE +180 -0
  4. {superquantx-0.1.0 → superquantx-0.1.1}/PKG-INFO +18 -16
  5. {superquantx-0.1.0 → superquantx-0.1.1}/README.md +16 -12
  6. superquantx-0.1.1/mkdocs.yml +186 -0
  7. {superquantx-0.1.0 → superquantx-0.1.1}/pyproject.toml +1 -3
  8. superquantx-0.1.1/resources/logo.png +0 -0
  9. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/__init__.py +24 -12
  10. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/algorithms/__init__.py +1 -1
  11. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/algorithms/base_algorithm.py +36 -36
  12. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/algorithms/hybrid_classifier.py +22 -22
  13. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/algorithms/qaoa.py +29 -28
  14. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/algorithms/quantum_agents.py +57 -56
  15. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/algorithms/quantum_kmeans.py +17 -17
  16. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/algorithms/quantum_nn.py +18 -18
  17. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/algorithms/quantum_pca.py +26 -26
  18. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/algorithms/quantum_svm.py +26 -25
  19. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/algorithms/vqe.py +40 -39
  20. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/algorithms.py +56 -55
  21. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/backends/__init__.py +12 -12
  22. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/backends/base_backend.py +25 -24
  23. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/backends/braket_backend.py +21 -21
  24. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/backends/cirq_backend.py +26 -26
  25. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/backends/ocean_backend.py +38 -38
  26. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/backends/pennylane_backend.py +12 -11
  27. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/backends/qiskit_backend.py +12 -12
  28. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/backends/simulator_backend.py +31 -17
  29. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/backends/tket_backend.py +23 -23
  30. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/circuits.py +25 -25
  31. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/cli/commands.py +6 -7
  32. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/cli/main.py +5 -6
  33. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/client.py +42 -42
  34. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/config.py +14 -14
  35. superquantx-0.1.1/src/superquantx/datasets/__init__.py +58 -0
  36. superquantx-0.1.1/src/superquantx/datasets/molecular.py +307 -0
  37. superquantx-0.1.1/src/superquantx/datasets/preprocessing.py +279 -0
  38. superquantx-0.1.1/src/superquantx/datasets/quantum_datasets.py +277 -0
  39. superquantx-0.1.1/src/superquantx/datasets/synthetic.py +300 -0
  40. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/exceptions.py +29 -29
  41. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/gates.py +26 -26
  42. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/logging_config.py +29 -29
  43. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/measurements.py +53 -54
  44. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/ml.py +51 -52
  45. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/noise.py +49 -49
  46. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/utils/benchmarking.py +41 -36
  47. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/utils/classical_utils.py +32 -32
  48. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/utils/feature_mapping.py +40 -35
  49. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/utils/optimization.py +28 -26
  50. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/utils/quantum_utils.py +47 -48
  51. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/utils/visualization.py +49 -49
  52. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/version.py +3 -3
  53. superquantx-0.1.0/LICENSE +0 -21
  54. {superquantx-0.1.0 → superquantx-0.1.1}/CONTRIBUTING.md +0 -0
  55. {superquantx-0.1.0 → superquantx-0.1.1}/Makefile +0 -0
  56. {superquantx-0.1.0 → superquantx-0.1.1}/requirements-dev.txt +0 -0
  57. {superquantx-0.1.0 → superquantx-0.1.1}/requirements.txt +0 -0
  58. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/cli/__init__.py +0 -0
  59. {superquantx-0.1.0 → superquantx-0.1.1}/src/superquantx/utils/__init__.py +0 -0
@@ -298,8 +298,10 @@ google_quantum_cache/
298
298
  *.json
299
299
  *.yaml
300
300
  *.yml
301
+ !mkdocs.yml
302
+ !.github/**/*.yml
303
+ !.github/**/*.yaml
301
304
  data/
302
- datasets/
303
305
  raw_data/
304
306
  processed_data/
305
307
  *.sqlite
@@ -322,6 +324,8 @@ logs/
322
324
  plots/
323
325
  figures/
324
326
  *.png
327
+ !resources/*.png
328
+ !docs/assets/logo.png
325
329
  *.jpg
326
330
  *.jpeg
327
331
  *.gif
@@ -13,7 +13,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
13
13
  - Fault-tolerant quantum algorithms
14
14
  - Quantum federated learning
15
15
 
16
- ## [0.1.0] - 2024-09-06
16
+ ## [0.1.1] - 2025-09-11
17
17
 
18
18
  ### Added
19
19
  - Initial release of SuperQuantX
@@ -60,4 +60,4 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
60
60
  - API documentation structure
61
61
  - Contributing guidelines
62
62
  - Example notebooks and tutorials
63
- - Performance benchmarks
63
+ - Performance benchmarks
@@ -0,0 +1,180 @@
1
+ Apache License
2
+ Version 2.0, January 2004
3
+ http://www.apache.org/licenses/
4
+
5
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
6
+
7
+ 1. Definitions.
8
+
9
+ "License" shall mean the terms and conditions for use, reproduction,
10
+ and distribution as defined by Sections 1 through 9 of this document.
11
+
12
+ "Licensor" shall mean the copyright owner or entity granting the License.
13
+
14
+ "Legal Entity" shall mean the union of the acting entity and all
15
+ other entities that control, are controlled by, or are under common
16
+ control with that entity. For the purposes of this definition,
17
+ "control" means (i) the power, direct or indirect, to cause the
18
+ direction or management of such entity, whether by contract or
19
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
20
+ outstanding shares, or (iii) beneficial ownership of such entity.
21
+
22
+ "You" (or "Your") shall mean an individual or Legal Entity
23
+ exercising permissions granted by this License.
24
+
25
+ "Source" shall mean the preferred form for making modifications,
26
+ including but not limited to software source code, documentation
27
+ source, and configuration files.
28
+
29
+ "Object" shall mean any form resulting from mechanical
30
+ transformation or translation of a Source form, including but
31
+ not limited to compiled object code, generated documentation,
32
+ and conversions to other media types.
33
+
34
+ "Work" shall mean the work of authorship covered by this License,
35
+ whether in Source or Object form, made available under the License,
36
+ as indicated by a copyright notice that is included in or attached
37
+ to the work. (For the purposes of this definition, "derivative works"
38
+ shall not include works that remain separable from, or merely link
39
+ (or bind by name) to the interfaces of, the Original Work and its
40
+ derivative works.)
41
+
42
+ "Derivative Works" shall mean any work, whether in Source or Object
43
+ form, that is based upon (or derived from) the Work and for which the
44
+ editorial revisions, annotations, elaborations, or other modifications
45
+ represent, as a whole, an original work of authorship. For the purposes
46
+ of this License, Derivative Works shall not include works that remain
47
+ separable from, or merely link (or bind by name) to the interfaces of,
48
+ the Work and related derivative works.
49
+
50
+ "Contribution" shall mean any work of authorship, including
51
+ the original version of the Work and any modifications or additions
52
+ to that Work or Derivative Works thereof, that is intentionally
53
+ submitted to Licensor for inclusion in the Work by the copyright owner
54
+ or by an individual or Legal Entity authorized to submit on behalf of
55
+ the copyright owner. For the purposes of this definition, "submitted"
56
+ means any form of electronic, verbal, or written communication sent
57
+ to the Licensor or its representatives, including but not limited to
58
+ communication on electronic mailing lists, source code control
59
+ systems, and issue tracking systems that are managed by, or on behalf
60
+ of, the Licensor for the purpose of discussing and improving the Work,
61
+ but excluding communication that is conspicuously marked or otherwise
62
+ designated in writing by the copyright owner as "Not a Contribution."
63
+
64
+ "Contributor" shall mean Licensor and any individual or Legal Entity
65
+ on behalf of whom a Contribution has been received by Licensor and
66
+ subsequently incorporated within the Work.
67
+
68
+ 2. Grant of Copyright License. Subject to the terms and conditions of
69
+ this License, each Contributor hereby grants to You a perpetual,
70
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
71
+ copyright license to use, reproduce, modify, distribute, prepare
72
+ Derivative Works of, publicly display, publicly perform, sublicense,
73
+ and distribute the Work and such Derivative Works in Source or Object
74
+ form.
75
+
76
+ 3. Grant of Patent License. Subject to the terms and conditions of
77
+ this License, each Contributor hereby grants to You a perpetual,
78
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
79
+ (except as stated in this section) patent license to make, have made,
80
+ use, offer to sell, sell, import, and otherwise transfer the Work,
81
+ where such license applies only to those patent claims licensable
82
+ by such Contributor that are necessarily infringed by their
83
+ Contribution(s) alone or by combination of their Contribution(s)
84
+ with the Work to which such Contribution(s) was submitted. If You
85
+ institute patent litigation against any entity (including a
86
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
87
+ or a Contribution incorporated within the Work constitutes direct
88
+ or contributory patent infringement, then any patent licenses
89
+ granted to You under this License for that Work shall terminate
90
+ as of the date such litigation is filed.
91
+
92
+ 4. Redistribution. You must retain, on each copy of the Work or
93
+ Derivative Works thereof, all copyright, patent, trademark, and
94
+ attribution notices from the Source form of the Work,
95
+ excluding those notices that do not pertain to any part of
96
+ the Derivative Works; and
97
+
98
+ If the Work includes a "NOTICE" text file as part of its
99
+ distribution, then any Derivative Works that You distribute must
100
+ include a readable copy of the attribution notices contained
101
+ within such NOTICE file, excluding those notices that do not
102
+ pertain to any part of the Derivative Works, in at least one
103
+ of the following places: within a NOTICE text file distributed
104
+ as part of the Derivative Works; within the Source form or
105
+ documentation, if provided along with the Derivative Works; or,
106
+ within a display generated by the Derivative Works, if and
107
+ wherever such third-party notices normally appear. The contents
108
+ of the NOTICE file are for informational purposes only and
109
+ do not modify the License. You may add Your own attribution
110
+ notices within Derivative Works that You distribute, alongside
111
+ or as an addendum to the NOTICE text from the Work, provided
112
+ that such additional attribution notices cannot be construed
113
+ as modifying the License.
114
+
115
+ You may add Your own copyright notice to Your modifications and
116
+ may provide additional or different license terms and conditions
117
+ for use, reproduction, or distribution of Your modifications, or
118
+ for any such Derivative Works as a whole, provided Your use,
119
+ reproduction, and distribution of the Work otherwise complies with
120
+ the conditions stated in this License.
121
+
122
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
123
+ any Contribution intentionally submitted for inclusion in the Work
124
+ by You to the Licensor shall be under the terms and conditions of
125
+ this License, without any additional terms or conditions.
126
+ Notwithstanding the above, nothing herein shall supersede or modify
127
+ the terms of any separate license agreement you may have executed
128
+ with Licensor regarding such Contributions.
129
+
130
+ 6. Trademarks. This License does not grant permission to use the trade
131
+ names, trademarks, service marks, or product names of the Licensor,
132
+ except as required for reasonable and customary use in describing the
133
+ origin of the Work and reproducing the content of the NOTICE file.
134
+
135
+ 7. Disclaimer of Warranty. Unless required by applicable law or
136
+ agreed to in writing, Licensor provides the Work (and each
137
+ Contributor provides its Contributions) on an "AS IS" BASIS,
138
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
139
+ implied, including, without limitation, any warranties or conditions
140
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
141
+ PARTICULAR PURPOSE. You are solely responsible for determining the
142
+ appropriateness of using or redistributing the Work and assume any
143
+ risks associated with Your exercise of permissions under this License.
144
+
145
+ 8. Limitation of Liability. In no event and under no legal theory,
146
+ whether in tort (including negligence), contract, or otherwise,
147
+ unless required by applicable law (such as deliberate and grossly
148
+ negligent acts) or agreed to in writing, shall any Contributor be
149
+ liable to You for damages, including any direct, indirect, special,
150
+ incidental, or consequential damages of any character arising as a
151
+ result of this License or out of the use or inability to use the
152
+ Work (including but not limited to damages for loss of goodwill,
153
+ work stoppage, computer failure or malfunction, or any and all
154
+ other commercial damages or losses), even if such Contributor
155
+ has been advised of the possibility of such damages.
156
+
157
+ 9. Accepting Warranty or Support. You may choose to offer, and to
158
+ charge a fee for, warranty, support, indemnity or other liability
159
+ obligations and/or rights consistent with this License. However, in
160
+ accepting such obligations, You may act only on Your own behalf and
161
+ on Your sole responsibility, not on behalf of any other Contributor,
162
+ and only if You agree to indemnify, defend, and hold each Contributor
163
+ harmless for any liability incurred by, or claims asserted against,
164
+ such Contributor by reason of your accepting any such warranty or support.
165
+
166
+ END OF TERMS AND CONDITIONS
167
+
168
+ Copyright 2025 Superagentic AI
169
+
170
+ Licensed under the Apache License, Version 2.0 (the "License");
171
+ you may not use this file except in compliance with the License.
172
+ You may obtain a copy of the License at
173
+
174
+ http://www.apache.org/licenses/LICENSE-2.0
175
+
176
+ Unless required by applicable law or agreed to in writing, software
177
+ distributed under the License is distributed on an "AS IS" BASIS,
178
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
179
+ See the License for the specific language governing permissions and
180
+ limitations under the License.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: superquantx
3
- Version: 0.1.0
3
+ Version: 0.1.1
4
4
  Summary: Quantum AI Research Platform - Unified API for QuantumAgentic AIsystems research
5
5
  Project-URL: Homepage, https://github.com/SuperagenticAI/superquantx
6
6
  Project-URL: Documentation, https://superagenticai.github.io/superquantx
@@ -8,10 +8,8 @@ Project-URL: Repository, https://github.com/SuperagenticAI/superquantx
8
8
  Project-URL: Bug Tracker, https://github.com/SuperagenticAI/superquantx/issues
9
9
  Project-URL: Source Code, https://github.com/SuperagenticAI/superquantx
10
10
  Project-URL: Changelog, https://github.com/SuperagenticAI/superquantx/blob/main/CHANGELOG.md
11
- Project-URL: Discussions, https://github.com/SuperagenticAI/superquantx/discussions
12
- Project-URL: Funding, https://github.com/sponsors/SuperagenticAI
13
11
  Author-email: Shashi Jagtap <shashi@super-agentic.ai>, Shashi Jagtap <shashikant.jagtap@icloud.com>, SuperXLab Research Team <research@super-agentic.ai>
14
- Maintainer-email: Shashi Jagtap <shashi@super-agentic.ai>, Shashi Jagtap <shashikant.jagtap@icloud.com>, SuperXLab Research Team <research@super-agentic.ai>
12
+ Maintainer-email: Shashi Jagtap <shashi@super-agentic.ai>, Shashi Jagtap <shashikant.jagtap@icloud.com>, Superagentic AI Research Team <research@super-agentic.ai>
15
13
  License: Apache-2.0
16
14
  License-File: LICENSE
17
15
  Keywords: agentic-ai,braket,cirq,experimental,pennylane,qiskit,quantum-agents,quantum-algorithms,quantum-computing,quantum-machine-learning,research-platform,unified-api
@@ -123,20 +121,18 @@ Requires-Dist: pytket-qiskit>=0.50.0; extra == 'tket'
123
121
  Requires-Dist: pytket>=1.25.0; extra == 'tket'
124
122
  Description-Content-Type: text/markdown
125
123
 
126
- <div align="center">
127
- <img src="resources/logo.png" alt="SuperQuantX Logo" width="600"/>
128
- </div>
129
-
130
- # SuperQuantX
131
-
132
124
  [![PyPI - Version](https://img.shields.io/pypi/v/superquantx)](https://pypi.org/project/superquantx/)
133
125
  [![Python Version](https://img.shields.io/pypi/pyversions/superquantx)](https://pypi.org/project/superquantx/)
134
- [![License](https://img.shields.io/github/license/SuperagenticAI/superquantx)](https://github.com/SuperagenticAI/superquantx/blob/main/LICENSE)
126
+ [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
135
127
  [![Tests](https://github.com/SuperagenticAI/superquantx/workflows/Tests/badge.svg)](https://github.com/SuperagenticAI/superquantx/actions)
136
- [![Documentation](https://img.shields.io/badge/docs-mkdocs-blue)](#-documentation)
128
+ [![Documentation](https://img.shields.io/badge/docs-mkdocs-blue)](https://superagenticai.github.io/superquantx)
137
129
  [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
138
130
  [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
139
131
 
132
+ # SuperQuantX
133
+ ### The foundation for the future of Agentic and Quantum AI
134
+ SuperQuantX unified API for the next wave of Quantum AI. It's a foundation to build powerful Quantum Agentic AI systems with a single interface to Qiskit, Cirq, PennyLane, and more. SuperQuantX is your launchpad into the world of Quantum + Agentic AI.
135
+
140
136
  **Unified Quantum Computing Platform - Building autonomous quantum-enhanced AI systems**
141
137
 
142
138
  > 📖 **[Read the Full Documentation →](https://superagenticai.github.io/superquantx/)**
@@ -152,6 +148,12 @@ SuperQuantX is a **unified quantum computing platform** that makes quantum algor
152
148
  - **🧠 Quantum ML** - Advanced quantum machine learning algorithms and neural networks
153
149
  - **⚡ Easy Setup** - Get started in minutes with comprehensive documentation
154
150
 
151
+ <div align="center">
152
+ <a href="https://super-agentic.ai" target="_blank">
153
+ <img src="resources/logo.png" alt="SuperQuantX Logo" width="500">
154
+ </a>
155
+ </div>
156
+
155
157
  ## ✨ Key Features
156
158
 
157
159
  ### **🔗 Universal Quantum Backend Support**
@@ -236,7 +238,7 @@ solution = qaoa.solve()
236
238
  The documentation includes comprehensive guides for getting started, detailed API references, tutorials, and examples for all supported quantum backends. Visit the documentation site for:
237
239
 
238
240
  - **Getting Started** - Installation, configuration, and your first quantum program
239
- - **User Guides** - Platform overview, backends, and algorithms
241
+ - **User Guides** - Platform overview, backends, and algorithms
240
242
  - **Tutorials** - Hands-on quantum computing and machine learning examples
241
243
  - **API Reference** - Complete API documentation with examples
242
244
  - **Development** - Contributing guidelines, architecture, and testing
@@ -330,7 +332,7 @@ Help improve our documentation:
330
332
 
331
333
  ## 📄 License
332
334
 
333
- SuperQuantX is released under the [MIT License](LICENSE). Feel free to use it in your projects, research, and commercial applications.
335
+ SuperQuantX is released under the [Apache License 2.0](LICENSE). Feel free to use it in your projects, research, and commercial applications.
334
336
 
335
337
  ---
336
338
 
@@ -350,13 +352,13 @@ print('✅ SuperQuantX is ready!')
350
352
 
351
353
  **Ready to explore quantum computing?**
352
354
 
353
- 👉 **[Start with the Quick Start Guide →](docs/getting-started/quickstart.md)**
355
+ 👉 **[Start with the Quick Start Guide →](https://superagenticai.github.io/superquantx/)**
354
356
 
355
357
  ---
356
358
 
357
359
  <div align="center">
358
360
 
359
- **SuperQuantX: Making Quantum Computing Accessible**
361
+ **SuperQuantX: Making Quantum Computing Accessible to all**
360
362
 
361
363
  *Built with ❤️ by [Superagentic AI](https://super-agentic.ai)*
362
364
 
@@ -1,17 +1,15 @@
1
- <div align="center">
2
- <img src="resources/logo.png" alt="SuperQuantX Logo" width="600"/>
3
- </div>
4
-
5
- # SuperQuantX
6
-
7
1
  [![PyPI - Version](https://img.shields.io/pypi/v/superquantx)](https://pypi.org/project/superquantx/)
8
2
  [![Python Version](https://img.shields.io/pypi/pyversions/superquantx)](https://pypi.org/project/superquantx/)
9
- [![License](https://img.shields.io/github/license/SuperagenticAI/superquantx)](https://github.com/SuperagenticAI/superquantx/blob/main/LICENSE)
3
+ [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
10
4
  [![Tests](https://github.com/SuperagenticAI/superquantx/workflows/Tests/badge.svg)](https://github.com/SuperagenticAI/superquantx/actions)
11
- [![Documentation](https://img.shields.io/badge/docs-mkdocs-blue)](#-documentation)
5
+ [![Documentation](https://img.shields.io/badge/docs-mkdocs-blue)](https://superagenticai.github.io/superquantx)
12
6
  [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
13
7
  [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
14
8
 
9
+ # SuperQuantX
10
+ ### The foundation for the future of Agentic and Quantum AI
11
+ SuperQuantX unified API for the next wave of Quantum AI. It's a foundation to build powerful Quantum Agentic AI systems with a single interface to Qiskit, Cirq, PennyLane, and more. SuperQuantX is your launchpad into the world of Quantum + Agentic AI.
12
+
15
13
  **Unified Quantum Computing Platform - Building autonomous quantum-enhanced AI systems**
16
14
 
17
15
  > 📖 **[Read the Full Documentation →](https://superagenticai.github.io/superquantx/)**
@@ -27,6 +25,12 @@ SuperQuantX is a **unified quantum computing platform** that makes quantum algor
27
25
  - **🧠 Quantum ML** - Advanced quantum machine learning algorithms and neural networks
28
26
  - **⚡ Easy Setup** - Get started in minutes with comprehensive documentation
29
27
 
28
+ <div align="center">
29
+ <a href="https://super-agentic.ai" target="_blank">
30
+ <img src="resources/logo.png" alt="SuperQuantX Logo" width="500">
31
+ </a>
32
+ </div>
33
+
30
34
  ## ✨ Key Features
31
35
 
32
36
  ### **🔗 Universal Quantum Backend Support**
@@ -111,7 +115,7 @@ solution = qaoa.solve()
111
115
  The documentation includes comprehensive guides for getting started, detailed API references, tutorials, and examples for all supported quantum backends. Visit the documentation site for:
112
116
 
113
117
  - **Getting Started** - Installation, configuration, and your first quantum program
114
- - **User Guides** - Platform overview, backends, and algorithms
118
+ - **User Guides** - Platform overview, backends, and algorithms
115
119
  - **Tutorials** - Hands-on quantum computing and machine learning examples
116
120
  - **API Reference** - Complete API documentation with examples
117
121
  - **Development** - Contributing guidelines, architecture, and testing
@@ -205,7 +209,7 @@ Help improve our documentation:
205
209
 
206
210
  ## 📄 License
207
211
 
208
- SuperQuantX is released under the [MIT License](LICENSE). Feel free to use it in your projects, research, and commercial applications.
212
+ SuperQuantX is released under the [Apache License 2.0](LICENSE). Feel free to use it in your projects, research, and commercial applications.
209
213
 
210
214
  ---
211
215
 
@@ -225,13 +229,13 @@ print('✅ SuperQuantX is ready!')
225
229
 
226
230
  **Ready to explore quantum computing?**
227
231
 
228
- 👉 **[Start with the Quick Start Guide →](docs/getting-started/quickstart.md)**
232
+ 👉 **[Start with the Quick Start Guide →](https://superagenticai.github.io/superquantx/)**
229
233
 
230
234
  ---
231
235
 
232
236
  <div align="center">
233
237
 
234
- **SuperQuantX: Making Quantum Computing Accessible**
238
+ **SuperQuantX: Making Quantum Computing Accessible to all**
235
239
 
236
240
  *Built with ❤️ by [Superagentic AI](https://super-agentic.ai)*
237
241
 
@@ -0,0 +1,186 @@
1
+ site_name: SuperQuantX Documentation
2
+ site_description: Quantum AI research platform that provides a unified API for future quantum agentic AI systems research
3
+ site_author: Superagentic AI
4
+ site_url: https://superagenticai.github.io/superquantx/
5
+
6
+ repo_url: https://github.com/SuperagenticAI/superquantx
7
+ edit_uri: edit/main/docs/
8
+
9
+ theme:
10
+ name: material
11
+ features:
12
+ - navigation.tabs
13
+ - navigation.sections
14
+ - navigation.expand
15
+ - navigation.path
16
+ - navigation.top
17
+ - navigation.indexes
18
+ - navigation.instant
19
+ - navigation.tracking
20
+ - search.highlight
21
+ - search.share
22
+ - search.suggest
23
+ - toc.follow
24
+ - toc.integrate
25
+ - content.code.copy
26
+ - content.code.annotate
27
+ - content.tabs.link
28
+ - content.tooltips
29
+ - header.autohide
30
+ palette:
31
+ # Palette toggle for light mode
32
+ - media: "(prefers-color-scheme: light)"
33
+ scheme: default
34
+ primary: white
35
+ accent: deep purple
36
+ toggle:
37
+ icon: material/brightness-7
38
+ name: Switch to dark mode
39
+ # Palette toggle for dark mode
40
+ - media: "(prefers-color-scheme: dark)"
41
+ scheme: slate
42
+ primary: black
43
+ accent: deep purple
44
+ toggle:
45
+ icon: material/brightness-4
46
+ name: Switch to light mode
47
+ font:
48
+ text: Inter
49
+ code: JetBrains Mono
50
+ icon:
51
+ repo: fontawesome/brands/github
52
+ edit: material/pencil
53
+ view: material/eye
54
+ logo: assets/logo.png
55
+
56
+ plugins:
57
+ - search:
58
+ lang: en
59
+ - mkdocstrings:
60
+ default_handler: python
61
+ handlers:
62
+ python:
63
+ paths: ["src"]
64
+ options:
65
+ docstring_style: google
66
+ show_source: true
67
+ show_bases: true
68
+ show_inheritance_diagram: false
69
+ show_root_heading: true
70
+ show_root_toc_entry: true
71
+ show_object_full_path: false
72
+ show_category_heading: true
73
+ show_signature_annotations: true
74
+ separate_signature: true
75
+ filters: ["!^_"]
76
+ heading_level: 1
77
+ members_order: source
78
+ docstring_section_style: table
79
+ merge_init_into_class: true
80
+ show_submodules: true
81
+
82
+ markdown_extensions:
83
+ - abbr
84
+ - admonition
85
+ - attr_list
86
+ - def_list
87
+ - footnotes
88
+ - md_in_html
89
+ - toc:
90
+ permalink: true
91
+ - pymdownx.arithmatex:
92
+ generic: true
93
+ - pymdownx.betterem:
94
+ smart_enable: all
95
+ - pymdownx.caret
96
+ - pymdownx.details
97
+ - pymdownx.emoji:
98
+ emoji_generator: !!python/name:material.extensions.emoji.to_svg
99
+ emoji_index: !!python/name:material.extensions.emoji.twemoji
100
+ - pymdownx.highlight:
101
+ anchor_linenums: true
102
+ line_spans: __span
103
+ pygments_lang_class: true
104
+ - pymdownx.inlinehilite
105
+ - pymdownx.keys
106
+ - pymdownx.magiclink:
107
+ repo_url_shorthand: true
108
+ user: SuperagenticAI
109
+ repo: superquantx
110
+ - pymdownx.mark
111
+ - pymdownx.smartsymbols
112
+ - pymdownx.superfences:
113
+ custom_fences:
114
+ - name: mermaid
115
+ class: mermaid
116
+ format: !!python/name:pymdownx.superfences.fence_code_format
117
+ - pymdownx.tabbed:
118
+ alternate_style: true
119
+ - pymdownx.tasklist:
120
+ custom_checkbox: true
121
+ - pymdownx.tilde
122
+
123
+ extra:
124
+ generator: false
125
+ analytics:
126
+ provider: google
127
+ property: !ENV GOOGLE_ANALYTICS_KEY
128
+ social:
129
+ - icon: fontawesome/brands/github
130
+ link: https://github.com/SuperagenticAI/superquantx
131
+ - icon: fontawesome/brands/python
132
+ link: https://pypi.org/project/superquantx/
133
+ - icon: material/email
134
+ link: mailto:research@super-agentic.ai
135
+
136
+ extra_css:
137
+ - stylesheets/extra.css
138
+
139
+ extra_javascript:
140
+ - javascripts/mathjax.js
141
+ - https://polyfill.io/v3/polyfill.min.js?features=es6
142
+ - https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js
143
+
144
+ nav:
145
+ - Home:
146
+ - Overview: index.md
147
+ - Quick Start: getting-started/quickstart.md
148
+ - Installation: getting-started/installation.md
149
+ - Getting Started:
150
+ - Installation Guide: getting-started/installation.md
151
+ - Quick Start: getting-started/quickstart.md
152
+ - First Program: getting-started/first-program.md
153
+ - Configuration: getting-started/configuration.md
154
+ - User Guide:
155
+ - Overview: user-guide/overview.md
156
+ - Quantum Backends: user-guide/backends.md
157
+ - Algorithms: user-guide/algorithms.md
158
+ - Tutorials:
159
+ - Basic Quantum Computing: tutorials/basic-quantum.md
160
+ - Quantum Machine Learning: tutorials/quantum-ml.md
161
+ - Backends:
162
+ - Overview: BACKENDS.md
163
+ - Simulator: backends/simulator.md
164
+ - PennyLane: backends/pennylane.md
165
+ - Qiskit: backends/qiskit.md
166
+ - Cirq: backends/cirq.md
167
+ - Amazon Braket: backends/braket.md
168
+ - TKET: backends/tket.md
169
+ - D-Wave Ocean: backends/ocean.md
170
+ - API Reference:
171
+ - Core: api/core.md
172
+ - Backends: api/backends.md
173
+ - Algorithms: api/algorithms.md
174
+ - Circuits: api/circuits.md
175
+ - Agents: api/agents.md
176
+ - Utilities: api/utilities.md
177
+ - Development:
178
+ - Contributing: development/contributing.md
179
+ - Architecture: development/architecture.md
180
+ - Testing: development/testing.md
181
+ - Release Process: development/releases.md
182
+ - Code Standards: development/standards.md
183
+
184
+ copyright: |
185
+ Copyright &copy; 2025 <a href="https://super-agentic.ai" target="_blank">Superagentic AI</a> -
186
+ <a href="https://github.com/SuperagenticAI/superquantx" target="_blank">SuperQuantX</a>
@@ -17,7 +17,7 @@ authors = [
17
17
  maintainers = [
18
18
  { name = "Shashi Jagtap", email = "shashi@super-agentic.ai" },
19
19
  { name = "Shashi Jagtap", email = "shashikant.jagtap@icloud.com" },
20
- { name = "SuperXLab Research Team", email = "research@super-agentic.ai" },
20
+ { name = "Superagentic AI Research Team", email = "research@super-agentic.ai" },
21
21
  ]
22
22
  keywords = [
23
23
  "quantum-computing",
@@ -138,8 +138,6 @@ Repository = "https://github.com/SuperagenticAI/superquantx"
138
138
  "Bug Tracker" = "https://github.com/SuperagenticAI/superquantx/issues"
139
139
  "Source Code" = "https://github.com/SuperagenticAI/superquantx"
140
140
  Changelog = "https://github.com/SuperagenticAI/superquantx/blob/main/CHANGELOG.md"
141
- "Discussions" = "https://github.com/SuperagenticAI/superquantx/discussions"
142
- "Funding" = "https://github.com/sponsors/SuperagenticAI"
143
141
 
144
142
  [project.scripts]
145
143
  superquantx = "superquantx.cli:main"
Binary file
@@ -1,38 +1,49 @@
1
1
  """SuperQuantX: Experimental Quantum AI Research Platform.
2
2
 
3
- ⚠️ RESEARCH SOFTWARE WARNING: This is experimental research software developed by
4
- SuperXLab (Superagentic AI Research Division). NOT intended for production use.
3
+ ⚠️ RESEARCH SOFTWARE WARNING: This is experimental research software developed by
4
+ SuperXLab (Superagentic AI Research Division). NOT intended for production use.
5
5
  For research and educational purposes only.
6
6
 
7
- Part of SuperXLab's comprehensive quantum research program - the practical implementation
7
+ Part of SuperXLab's comprehensive quantum research program - the practical implementation
8
8
  platform for validating theoretical research in:
9
9
  🔬 Quantum-Inspired Agentic Systems: Superposition, interference, entanglement in agents
10
- 🔬 Quantum Neural Networks (QNNs): Hardware-validated quantum neural architectures
10
+ 🔬 Quantum Neural Networks (QNNs): Hardware-validated quantum neural architectures
11
11
  🔬 QuantumML for AI Training: Quantum-accelerated machine learning techniques
12
12
  🔬 Quantinuum Integration: Real hardware validation on H-Series quantum computers
13
13
 
14
14
  Research Examples:
15
15
  Experimental quantum agent research:
16
16
  >>> import superquantx as sqx # EXPERIMENTAL
17
- >>> agent = sqx.QuantumTradingAgent(strategy="quantum_portfolio", backend="simulator")
17
+ >>> agent = sqx.QuantumTradingAgent(strategy="quantum_portfolio", backend="simulator")
18
18
  >>> results = agent.solve(research_data) # Research use only
19
19
  >>> print(f"Research findings: {results.metadata}")
20
-
20
+
21
21
  Quantum neural network experiments:
22
22
  >>> qnn = sqx.QuantumNN(architecture='hybrid', backend='pennylane') # EXPERIMENTAL
23
23
  >>> qnn.fit(X_research, y_research) # Research data only
24
24
  >>> analysis = qnn.analyze_expressivity() # Research analysis
25
-
25
+
26
26
  Quantum algorithm benchmarking:
27
- >>> qsvm = sqx.QuantumSVM(backend='simulator') # EXPERIMENTAL
27
+ >>> qsvm = sqx.QuantumSVM(backend='simulator') # EXPERIMENTAL
28
28
  >>> benchmark = sqx.benchmark_algorithm(qsvm, classical_baseline)
29
29
  """
30
30
 
31
31
  import logging
32
- from typing import Any, Dict
32
+ from typing import Any
33
33
 
34
34
  # Core imports - make available at top level
35
- from . import algorithms, backends, cli, datasets, utils
35
+ from . import algorithms, backends, cli, utils
36
+
37
+
38
+ # Import datasets lazily to avoid circular imports
39
+ try:
40
+ from . import datasets
41
+ except ImportError:
42
+ # If datasets import fails, create a placeholder
43
+ import sys
44
+ import types
45
+ datasets = types.ModuleType('datasets')
46
+ sys.modules[f'{__name__}.datasets'] = datasets
36
47
  from .config import config, configure
37
48
  from .version import __version__
38
49
 
@@ -164,7 +175,7 @@ __title__ = "SuperQuantX"
164
175
  __description__ = "Experimental Quantum AI Research Platform - NOT for production use"
165
176
  __author__ = "SuperXLab - Superagentic AI Research Division"
166
177
  __author_email__ = "research@superagentic.ai"
167
- __license__ = "MIT (Research and Educational Use)"
178
+ __license__ = "Apache-2.0"
168
179
  __url__ = "https://github.com/superagentic/superquantx"
169
180
 
170
181
  # Version information
@@ -172,7 +183,7 @@ def get_version() -> str:
172
183
  """Get SuperQuantX version."""
173
184
  return __version__
174
185
 
175
- def get_backend_info() -> Dict[str, Any]:
186
+ def get_backend_info() -> dict[str, Any]:
176
187
  """Get information about available backends."""
177
188
  info = {}
178
189
 
@@ -288,6 +299,7 @@ __all__ = [
288
299
  "HybridClassifier",
289
300
 
290
301
  # Common backends
302
+ "BaseBackend",
291
303
  "AutoBackend",
292
304
  "QiskitBackend",
293
305
  "PennyLaneBackend",