How gaurav-git7/syrus-quantum works
Quantum Portfolio Optimiser is an interactive portfolio-selection product: users choose assets, portfolio size, risk and rules, then submit a job and review QAOA against classical baselines, including out-of-sample and noise results. The documented runtime stages are market estimation, candidate screening, constrained QUBO construction, solving, and evaluation; the UI also exposes a benchmark study. Edges follow explicit README descriptions or sampled caller references. Several modules and API internals are unsampled, so their undocumented internal wiring is omitted.
Main entry points: pipeline.py Run pipeline · run_study.py Study runner · App.jsx App shell · problem.py Constraints and QUBO
Components 18
Web interface
- App shell
web/src/App.jsx - Run configuration
web/src/components/ConfigPanel.jsx - API client
web/src/api.js - Results view
web/src/components/Results.jsx - Result charts
web/src/components/Charts.jsx - Study tab
web/src/components/StudyTab.jsx
Job service
- Job API
api/main.py - Run pipeline
qpo/pipeline.py
Portfolio modeling
- Market data
qpo/data.py - Asset screening
qpo/screening.py - Constraints and QUBO
qpo/problem.py
Solvers and evaluation
- QAOA solver
qpo/qaoa.py - Classical solvers
qpo/classical.py - Metrics and landscape
qpo/metrics.py - Noise simulation
qpo/noise.py
Benchmark study
- Study runner
experiments/run_study.py - Study results
results/study.json
Other components
- Investor
Connections 25
- Investor → App shell: uses
README.md - App shell → Run configuration: renders
web/src/App.jsx - App shell → API client: requests through
web/src/App.jsx - App shell → Results view: renders
web/src/App.jsx - App shell → Study tab: renders
web/src/App.jsx - Results view → Result charts: renders
web/src/components/Results.jsx - API client → Job API: HTTP requests
README.md - Job API → Run pipeline: runs jobs
README.md - Run pipeline → Market data: loads estimates
qpo/pipeline.py - Run pipeline → Asset screening: screens assets
README.md - Run pipeline → Constraints and QUBO: builds problem
README.md - Run pipeline → Classical solvers: runs baselines
qpo/pipeline.py - Run pipeline → QAOA solver: runs QAOA
qpo/pipeline.py - Run pipeline → Metrics and landscape: computes metrics
README.md - Run pipeline → Noise simulation: evaluates noise
README.md - QAOA solver → Constraints and QUBO: consumes QUBO
qpo/qaoa.py - Classical solvers → Constraints and QUBO: solves constraints
qpo/classical.py - Metrics and landscape → Constraints and QUBO: evaluates solutions
qpo/metrics.py - Study tab → API client: loads study
web/src/components/StudyTab.jsx - Study runner → Market data: uses market data
experiments/run_study.py - Study runner → Constraints and QUBO: builds cases
experiments/run_study.py - Study runner → Classical solvers: benchmarks baselines
experiments/run_study.py - Study runner → QAOA solver: benchmarks circuits
experiments/run_study.py - Study runner → Noise simulation: benchmarks noise
README.md - Study runner → Study results: writes results
experiments/run_study.py