{"id":34782874,"url":"https://github.com/vinerya/quantum_forge","last_synced_at":"2026-05-27T14:09:17.092Z","repository":{"id":259460090,"uuid":"861803638","full_name":"vinerya/quantum_forge","owner":"vinerya","description":"QuantumForge is a quantum circuit design environment that focuses on adaptive synthesis of quantum circuits. It leverages reinforcement learning techniques to construct and optimize quantum circuits that generate desired quantum states.","archived":false,"fork":false,"pushed_at":"2024-10-24T14:04:15.000Z","size":41,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-09T15:34:41.818Z","etag":null,"topics":["cirq","qiskit","quantum-circuit","quantum-computing"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vinerya.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-09-23T14:38:21.000Z","updated_at":"2025-12-25T15:16:49.000Z","dependencies_parsed_at":"2024-10-25T17:16:02.113Z","dependency_job_id":"3fd9ee86-445a-46c1-bc43-3f16afbd2cc9","html_url":"https://github.com/vinerya/quantum_forge","commit_stats":null,"previous_names":["vinerya/quantum_forge"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/vinerya/quantum_forge","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vinerya%2Fquantum_forge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vinerya%2Fquantum_forge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vinerya%2Fquantum_forge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vinerya%2Fquantum_forge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vinerya","download_url":"https://codeload.github.com/vinerya/quantum_forge/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vinerya%2Fquantum_forge/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33569099,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-27T02:00:06.184Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cirq","qiskit","quantum-circuit","quantum-computing"],"created_at":"2025-12-25T08:57:59.051Z","updated_at":"2026-05-27T14:09:17.087Z","avatar_url":"https://github.com/vinerya.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# QuantumForge: Advanced Quantum Circuit Design and Optimization Framework\n\nQuantumForge is a comprehensive quantum circuit design and optimization framework that combines reinforcement learning, circuit cutting, error mitigation, and dynamic compilation to create optimal quantum circuits.\n\n## Features\n\n### Core Circuit Design\n- Support for both Qiskit and Cirq backends\n- Gymnasium-compatible environment\n- Advanced action space including multi-qubit gates\n- Realistic noise simulation\n- Reinforcement learning integration with Stable Baselines3\n- Hyperparameter optimization using Optuna\n- Circuit optimization and visualization\n\n### Circuit Optimization\n- Template-based optimization\n- Quantum Shannon Decomposition\n- Gate commutation analysis\n- Multi-objective optimization\n- Hardware-aware optimization\n- Resource estimation\n- Circuit equivalence verification\n\n### Circuit Cutting\n- Intelligent cut-point selection\n- Dependency graph analysis\n- Balanced subcircuit generation\n- Entanglement cost minimization\n- Automated qubit remapping\n- Result reconstruction\n- Cutting visualization\n\n### Error Mitigation\n- Zero-noise extrapolation\n- Probabilistic error cancellation\n- Measurement error mitigation\n- Noise characterization\n- Confidence interval calculation\n- Error analysis visualization\n- Fidelity improvement tracking\n\n### Dynamic Compilation\n- Runtime optimization with caching\n- Pulse-level optimization\n- Hardware-specific compilation\n- Automated gate decomposition\n- Timing constraint optimization\n- Qubit mapping optimization\n- Compilation analysis tools\n\n## Installation\n\n1. Clone this repository\n2. Install the required dependencies:\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n## Usage\n\n### Basic Example\nSee `example.py` for basic usage demonstrating:\n- Training a PPO agent on the QuantumForge environment\n- Evaluating the trained agent\n- Visualizing rewards and quantum states\n\n```bash\npython example.py\n```\n\n### Advanced Examples\n\n#### Hardware-Aware Optimization\nSee `hardware_aware_example.py` for:\n- Hardware constraint integration\n- Noise-aware optimization\n- Connectivity optimization\n\n```bash\npython hardware_aware_example.py\n```\n\n#### Circuit Cutting\nSee `circuit_cutting_example.py` for:\n- Large circuit decomposition\n- Subcircuit execution\n- Result reconstruction\n\n```bash\npython circuit_cutting_example.py\n```\n\n#### Error Mitigation\nSee `advanced_examples.py` for:\n- Error mitigation techniques\n- Dynamic compilation\n- Advanced optimization strategies\n\n```bash\npython advanced_examples.py\n```\n\n## Components\n\n### Environment (QuantumForgeEnv)\n- Observations: Current quantum state as complex vector\n- Actions: (operation, qubit1, qubit2, parameter)\n  - Operations: X, Z, H, RY, CNOT, CZ, RXX, RZZ, etc.\n  - Qubits: Indices for operation application\n  - Parameters: Used for parameterized gates\n\n### Circuit Optimizer\n- Gate sequence optimization\n- Template matching\n- Quantum Shannon Decomposition\n- Resource estimation\n- Circuit equivalence checking\n\n### Circuit Cutter\n- Dependency analysis\n- Cut-point selection\n- Subcircuit generation\n- Result reconstruction\n- Performance analysis\n\n### Error Mitigator\n- Multiple mitigation strategies\n- Noise characterization\n- Error analysis\n- Result improvement tracking\n\n### Dynamic Compiler\n- Runtime optimization\n- Pulse-level control\n- Hardware adaptation\n- Performance analysis\n- Visualization tools\n\n## Backends\n\nQuantumForge supports two quantum computing backends:\n\n1. Qiskit: IBM's quantum computing framework\n   - Full noise simulation\n   - Hardware-specific optimization\n   - Pulse-level control\n\n2. Cirq: Google's quantum computing framework\n   - Noise modeling\n   - Device specification\n   - Custom gate sets\n\n## Visualization\n\nThe framework generates various visualizations:\n- Reward plots\n- Quantum state visualizations\n- Circuit cut diagrams\n- Error mitigation results\n- Compilation analysis\n- Resource usage comparisons\n\n## Contributing\n\nContributions are welcome! Please feel free to submit pull requests.\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## Citation\n\nIf you use QuantumForge in your research, please cite:\n\n```bibtex\n@software{quantumforge2024,\n  title = {QuantumForge: Advanced Quantum Circuit Design and Optimization Framework},\n  year = {2024},\n  author = {Moudather Chelbi},\n  url = {https://github.com/vinerya/QuantumForge}\n}\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvinerya%2Fquantum_forge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvinerya%2Fquantum_forge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvinerya%2Fquantum_forge/lists"}