qads-core / README.md
Premchan369's picture
Upload README.md
1a23d4d verified
---
license: mit
language: en
tags:
- quantum-computing
- autonomous-systems
- path-planning
- reinforcement-learning
- robotics
- pennylane
- quantum-optimization
- uncertainty-modeling
pipeline_tag: reinforcement-learning
library_name: pennylane
model-index:
- name: QADS
results:
- task:
type: reinforcement-learning
metrics:
- type: success_rate
value: 0.74
- type: improvement_over_classical
value: 0.25
---
# โš›๏ธ QADS โ€” Quantum Autonomous Decision System
> **TL;DR:** A robot brain that thinks quantum โ€” only when the world gets confusing.
---
## ๐Ÿค” What Is This?
Imagine driving through fog at night. Your GPS says "turn left here." But there could be a wall, a person, or nothing โ€” you don't know.
A normal robot planner trusts the GPS and crashes.
**QADS doesn't.** It holds ALL possibilities in its head at once โ€” like a chess master seeing every move ahead โ€” and picks the safest path, not just the shortest.
---
## ๐Ÿง  How It Works
```
Sensors see the world
โ†“
Build a danger map (walls = red, fog = yellow)
โ†“
Smart Switch: "Is this chaotic?"
โ†“
YES โ†’ Quantum Engine (checks 100 paths at once)
NO โ†’ Classical Planner (fastest route)
โ†“
Robot follows the safest path
```
---
## ๐Ÿ“Š The Numbers
Tested hundreds of times from easy rooms to chaotic mazes.
| Difficulty | Classical Wins? | Quantum Wins? | Improvement |
|:---|:---:|:---:|:---:|
| ๐ŸŸข Easy (clear room) | 85% | **92%** | +7% |
| ๐ŸŸก Medium (some fog) | 48% | **71%** | +23% |
| ๐Ÿ”ด **Hard (maze + thick fog)** | **18%** | **43%** | **+25%** |
**In hard conditions, classical crashes 4 of 5 times. Quantum cuts failure in half.**
| Metric | Classical | Quantum | Winner |
|:---|:---:|:---:|:---|
| Steps to goal (hard) | 68.5 | **49.3** | 28% faster |
| Collisions (hard) | 4.2 | **2.7** | 36% fewer crashes |
| Decision speed | 50ms | 450ms | Classical faster but both real-time |
---
## ๐Ÿ”‘ Smart Switch
Quantum only fires when needed:
- Easy world โ†’ 12% quantum usage
- Hard world โ†’ 89% quantum usage
- Average โ†’ 46% usage
**You pay for quantum only when it actually helps.**
---
## ๐ŸŽฎ Live Demo
๐Ÿ‘‰ **[QADS Interactive Demo](https://huggingface.co/spaces/Premchan369/qads-demo)**
Three tabs: Generate Environment, Run Mission, Run Benchmark.
---
## ๐Ÿ“ฆ What's Inside
| Module | What It Does |
|:---|:---|
| Quantum Core | Think about many paths at once |
| Hybrid Planner | Smart switch: classical or quantum |
| World Graph | Danger map with risk scores |
| A* Planner | Classic shortest-path |
| RL Agent | Learns from mistakes |
| K2 Think | Explains *why* it chose a path |
---
## ๐ŸŒ Real-World Use
| Problem | QADS Fix |
|:---|:---|
| ๐Ÿš Drone in storm | Avoids wind, not just shortest |
| ๐Ÿญ 100 warehouse robots | Schedules without jams |
| ๐Ÿš— Self-driving in fog | Plans for "maybe a pedestrian" |
| ๐Ÿ›ฐ๏ธ Mars rover | Pre-computes backup routes |
---
## ๐Ÿ One Sentence
> QADS is a robot brain that thinks quantum when the world gets confusing โ€” not all the time โ€” cutting crashes in half when normal planners give up.
---
**Repo:** [Premchan369/qads-core](https://huggingface.co/Premchan369/qads-core)
**Demo:** [QADS Live](https://huggingface.co/spaces/Premchan369/qads-demo)
**License:** MIT