> For the complete documentation index, see [llms.txt](https://docs.qubixquantum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.qubixquantum.com/how-it-works.md).

# How It Works

#### The Journey

Between typing "flip a coin" and getting your result, your request travels through four steps:

* **The AI writes it** as quantum code
* **It gets translated** to fit the real machine
* **IBM's computer runs it** on real qubits, usually thousands of times
* **You get the proof** back as a chart, an answer, and a receipt

Words go in one end, a real quantum result comes out the other, with nothing faked in between.

#### Tech Stack

Qubix is built from a few parts, each doing one job:

* **Quantum hardware** — the real machine your circuit runs on
* **AI** — turns your words into code, checks your request, and explains the result back to you
* **The transpiler** — our own service that prepares the code so it can run on the hardware (next section)
* **Wallet & payments** — sign in and pay simply, the usual Web3 way

That's the whole picture: AI to understand you, a translator to prepare your request, and real quantum hardware to run it, all tied together behind a simple app.

#### The Transpiler

This is the piece we built ourselves, and it's what makes the runs possible.

The code the AI writes is clean and general, but real hardware only understands its own basic operations, so a circuit has to be rewritten to fit. IBM won't accept a circuit until it's translated, and their own tool is locked behind a paid plan. So we built our own free service that does it automatically, every run.

It's also why your receipt shows two versions of the code, the clean one, and the translated one that actually ran. Nothing hidden in between.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.qubixquantum.com/how-it-works.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.