Skip to content

pdaxt/homaya

Repository files navigation

HOMAYA

Some connections transcend distance.

A quantum computing framework built from scratch.
Named for my wife. Like entangled qubits, some bonds don't need explanation.


THE MISSION

Make quantum computing accessible to everyone.

WHAT Build a complete quantum computing framework from scratch
HOW Learn it ourselves and document everything along the way
WHY So anyone curious can learn quantum computing - no PhD required

We're not waiting until we're experts. We're learning in public and building as we go.


Try It NowThe JourneyCourseLearn With Us

Rust License Status


Try It Now

No installation needed! Start learning quantum computing in your browser:

Click the link above to start learning. Works on any device.

Want to go deeper? Follow the full learning journey at bskiller.com - behind-the-scenes of building this framework, what's working, what's failing, and lessons learned.


The Journey

This is us learning quantum computing. In public. From scratch.

We're not quantum physicists. We're not academics. We're just curious people who wanted to understand how quantum computers actually work.

Every resource we found was either:

  • Written for physics PhDs (too hard)
  • Oversimplified YouTube videos (too shallow)

So we decided: let's build a quantum computer simulator ourselves and see if we actually understand it.

The Crazy Part

If our simulator passes physics tests, that means we actually understand the math. We can't fake it. The computer will tell us if we're wrong.

✓ Probability Conservation - All probabilities sum to 1
✓ H² = I - Hadamard is self-inverse
✓ Bell State - Perfect entanglement correlation
✓ CNOT Truth Table - Controlled operations work
... and 4 more physics tests

It passes. We're learning.


The Interactive Course

As we learn, we write explanations. Not for experts - for ourselves. For people who have never touched quantum computing.

Take the Course

What You'll Learn

Lesson What You'll Understand
Light Switches How regular computers work (bits = on/off switches)
The Spinning Coin What makes quantum different (qubits can be BOTH)
Weighted Coins How we control quantum probabilities
The H Button The most important quantum operation (Hadamard)
Building Circuits Chaining operations together
Two Qubits Exponential power (2 qubits = 4 states at once!)
CNOT Gate Making qubits work together
Entanglement The "spooky" thing Einstein hated

No Prerequisites

  • No physics degree
  • No linear algebra
  • No quantum mechanics background
  • Just curiosity

We explain everything like you're 10 years old. Because that's how we had to explain it to ourselves.


Our Learning Philosophy

1. Build it → Forces you to truly understand
2. Test it → Can't fake understanding to a computer
3. Explain it simply → If you can't explain it simply, you don't understand it
4. Share it → Others help you find gaps in your knowledge

What We've Built So Far

Component What It Does Did We Learn It?
homaya-types Core types and traits Yes
homaya-core Qubits, quantum gates, circuits Yes
homaya-sim Simulates quantum circuits Yes
homaya-algorithms Grover, Deutsch-Jozsa, Bernstein-Vazirani Yes
Interactive Course Teaches what we learned Writing as we go
Verification Tests Proves our math is right All passing

For Developers

Want to run the simulator locally?

# Clone and enter
git clone https://github.com/pdaxt/homaya.git
cd homaya

# Run a demo
cargo run --example sim_demo -p homaya-sim

# Prove it's mathematically correct
cargo run --example verify_correctness -p homaya-sim

Build Your First Quantum Circuit

use homaya_core::Circuit;
use homaya_sim::Simulator;

// Create entangled qubits (Bell state)
let circuit = Circuit::new(2)
    .h(0)        // Put qubit 0 in superposition
    .cx(0, 1)    // Entangle qubit 1 with qubit 0
    .measure_all();

// Simulate it
let mut sim = Simulator::new();
let counts = sim.sample(&circuit, 1000).unwrap();

// You'll get ~50% "00" and ~50% "11"
// Never "01" or "10" - they're entangled!
println!("{:?}", counts);

Learn With Us

You don't need to be an expert to contribute. We're not experts either!

Ways to Help

If you're... You can...
A beginner Tell us what's confusing - seriously, this helps us write better explanations
Learning too Try the course and let us know what clicks (or doesn't)
A developer Add features to the simulator
Quantum-curious Share it with others who might want to learn

Ask Questions!

If something doesn't make sense, that's a bug in our explanation, not a bug in you.

Open an issue. We'll either:

  1. Improve the explanation, or
  2. Realize we don't understand it either (and learn together!)

Project Status

What Works

  • Full state vector quantum simulation
  • All standard gates: X, Y, Z, H, S, T, Rx, Ry, Rz, CNOT, CZ, SWAP, Toffoli
  • Measurement and sampling
  • Interactive browser-based course
  • 8 physics verification tests (all passing)

What We're Learning Next

  • Python bindings (so more people can use it)
  • Browser/WASM support (run simulations in the course!)
  • More course lessons (quantum algorithms!)
  • GPU acceleration (for bigger simulations)

Project Structure

homaya/
├── crates/
│   ├── homaya-core/      # The fundamentals (we learned this first)
│   ├── homaya-sim/       # The simulator (we learned this second)
│   └── ...               # More to come as we learn
├── docs/
│   └── learn/            # Interactive course (our notes, but prettier)
└── examples/
    └── rust/             # Working examples (proof we understand it)

About

Built by Pran - learning quantum computing one qubit at a time.

Named for Homaya - because like entangled qubits, some connections transcend distance.

Connect & Learn More

Platform What You'll Find
bskiller.com Deep dives, experiments, behind-the-scenes
dataxlr8.ai Enterprise AI & quantum solutions
LinkedIn Let's connect!

Enterprise

Building production quantum applications? Need consulting, custom development, or enterprise support?

dataxlr8.ai - We help companies navigate the quantum future.


License

MIT / Apache 2.0 - Use it however you want.


Learning in public. Building in the open.

We started confused. We're getting less confused. Join us.

Start Learning Now

bskiller.comdataxlr8.ai

About

Some connections transcend distance. A quantum computing framework built from scratch.

Resources

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages