{"id":51280136,"url":"https://github.com/ruvnet/ruqu","last_synced_at":"2026-06-30T01:02:47.733Z","repository":{"id":365554801,"uuid":"1272534358","full_name":"ruvnet/ruqu","owner":"ruvnet","description":"High-performance quantum computing in pure Rust + WebAssembly: state-vector circuit simulator with SIMD \u0026 noise models, VQE, Grover, QAOA, surface-code error correction, and real-time coherence via dynamic min-cut.","archived":false,"fork":false,"pushed_at":"2026-06-17T20:42:53.000Z","size":931,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-17T22:20:49.066Z","etag":null,"topics":["grovers-algorithm","mincut","noise-model","qaoa","quantum","quantum-algorithms","quantum-chemistry","quantum-computing","quantum-error-correction","quantum-simulator","rust","simd","simulator","state-vector","surface-code","vqe","wasm","webassembly"],"latest_commit_sha":null,"homepage":null,"language":"Rust","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/ruvnet.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-17T17:47:23.000Z","updated_at":"2026-06-17T20:42:56.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ruvnet/ruqu","commit_stats":null,"previous_names":["ruvnet/ruqu"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/ruvnet/ruqu","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruvnet%2Fruqu","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruvnet%2Fruqu/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruvnet%2Fruqu/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruvnet%2Fruqu/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ruvnet","download_url":"https://codeload.github.com/ruvnet/ruqu/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruvnet%2Fruqu/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34948227,"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-06-29T02:00:05.398Z","response_time":58,"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":["grovers-algorithm","mincut","noise-model","qaoa","quantum","quantum-algorithms","quantum-chemistry","quantum-computing","quantum-error-correction","quantum-simulator","rust","simd","simulator","state-vector","surface-code","vqe","wasm","webassembly"],"created_at":"2026-06-30T01:02:47.196Z","updated_at":"2026-06-30T01:02:47.726Z","avatar_url":"https://github.com/ruvnet.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ruqu — Quantum Computing in Pure Rust + WebAssembly\n\n[![Rust](https://img.shields.io/badge/Rust-2021-orange?logo=rust)](https://www.rust-lang.org)\n[![WebAssembly](https://img.shields.io/badge/WebAssembly-ready-654ff0?logo=webassembly\u0026logoColor=white)](#webassembly)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](#license)\n\n**`ruqu`** is a fast, dependency-light **quantum computing toolkit written in pure Rust** — a\nstate-vector **quantum circuit simulator** with SIMD acceleration, realistic **noise models**,\nand multi-threading, plus production **quantum algorithms** (VQE, Grover, QAOA, surface-code\nerror correction) and a novel **real-time coherence engine**. It runs natively *and* in the\nbrowser via **WebAssembly**.\n\n\u003e Quantum circuit simulation, VQE quantum chemistry, QAOA optimization, Grover search, surface-code\n\u003e QEC, and 25-qubit in-browser WASM — no Python, no C++, no heavyweight dependencies.\n\n## Why ruqu\n\n- **Pure Rust, no FFI** — portable, memory-safe, easy to embed; compiles to native and `wasm32`.\n- **SIMD + multi-threaded state-vector engine** — high-throughput circuit simulation.\n- **Realistic noise models** — depolarizing, dephasing, amplitude damping for NISQ-style studies.\n- **Batteries-included algorithms** — VQE (chemistry), Grover's search, QAOA (combinatorial\n  optimization), and Surface Code error correction, ready to use.\n- **Runs in the browser** — `ruqu-wasm` exposes circuits, VQE, Grover and QAOA to JavaScript with\n  ~25-qubit support.\n- **Coherence-aware** — a classical \"nervous system for quantum machines\" that assesses qubit\n  coherence in real time via dynamic min-cut.\n\n## Crates\n\n| Crate | What it does |\n|-------|--------------|\n| [`ruqu-core`](crates/ruqu-core) | High-performance state-vector **quantum circuit simulator** — SIMD acceleration, noise models, multi-threading. |\n| [`ruqu-algorithms`](crates/ruqu-algorithms) | Production **quantum algorithms** — **VQE** for chemistry, **Grover's** search, **QAOA** optimization, **Surface Code** error correction. |\n| [`ruqu-exotic`](crates/ruqu-exotic) | Experimental **quantum–classical hybrid** algorithms — quantum memory decay, interference search, reasoning error correction, swarm interference for AI systems. |\n| [`ruqu-wasm`](crates/ruqu-wasm) | **WebAssembly** bindings — run quantum simulations in the browser (25-qubit, VQE/Grover/QAOA). |\n| [`ruqu`](crates/ruQu) | Classical **coherence engine** — real-time coherence assessment for quantum machines via **dynamic min-cut**. |\n\n## Install\n\n```toml\n# Cargo.toml\n[dependencies]\nruqu-core = \"2.2\"\nruqu-algorithms = \"2.2\"   # VQE, Grover, QAOA, surface-code QEC\n```\n\n```bash\ncargo add ruqu-core ruqu-algorithms\n```\n\n## Quick start\n\n```rust\nuse ruqu_algorithms::qaoa::{run_qaoa, Graph, QaoaConfig};\n\n// Solve a MaxCut instance with QAOA on the ruqu state-vector simulator.\nlet graph = Graph::from_edges(4, \u0026[(0, 1), (1, 2), (2, 3), (3, 0)]);\nlet result = run_qaoa(\u0026graph, \u0026QaoaConfig::default());\nprintln!(\"best cut = {:?}\", result.best_bitstring);\n```\n\n## WebAssembly\n\n```bash\n# build the browser bundle\nwasm-pack build crates/ruqu-wasm --target web\n```\n\n```js\nimport init, { simulate } from \"./pkg/ruqu_wasm.js\";\nawait init();\n// run a quantum circuit entirely in the browser — up to ~25 qubits\n```\n\n## Build\n\n```bash\ncargo build --release                            # native\ncargo test                                       # run the test suite\nwasm-pack build crates/ruqu-wasm --target web    # WASM\n```\n\n## Command-line quantum (npx)\n\nRun quantum circuits from your terminal via **[`@ruvector/ruqu`](https://www.npmjs.com/package/@ruvector/ruqu)** —\nthe `ruqu-wasm` state-vector simulator compiled to WebAssembly, wrapped in a metaharness agent CLI:\n\n```bash\nnpx @ruvector/ruqu simulate --qubits 4    # GHZ state-vector simulation\nnpx @ruvector/ruqu grover --qubits 3 --target 5\nnpx @ruvector/ruqu qaoa --nodes 4         # QAOA MaxCut on a ring\nnpx @ruvector/ruqu capabilities           # gates, algorithms, limits\nnpx @ruvector/ruqu doctor                 # verify the quantum WASM\n```\n\nSources in [`cli/`](cli); the bundled `--target nodejs` WASM runs up to 25 qubits in Node — no native addon.\n\n## Use cases\n\nQuantum algorithm research · variational quantum eigensolver (VQE) for quantum chemistry ·\ncombinatorial optimization with QAOA · quantum error-correction (surface codes) experiments ·\nNISQ noise studies · teaching quantum computing · browser-based quantum demos.\n\n## License\n\nMIT © Ruvector Team. Part of the [ruvector](https://github.com/ruvnet/ruvector) ecosystem\n(extracted per ADR-257).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fruvnet%2Fruqu","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fruvnet%2Fruqu","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fruvnet%2Fruqu/lists"}