# Kino.Qx v0.3.0 - Table of Contents

Livebook Smart Cells for Qx. A "Qx Credentials" cell builds a %Qx.Hardware.Config{} from Livebook secrets; Kino.Qx.run!/2 pipes a circuit onto real IBM Quantum hardware with a live status panel. Also ships a "Qx Snippet" cell for saved Qx Portal snippets.

## Pages

- [Kino.Qx](readme.md)
- [Changelog](changelog.md)
- [LICENSE](license.md)

## Modules

- [Kino.Qx](Kino.Qx.md): Livebook Smart Cells + pipeline functions for running quantum
circuits on real IBM hardware via the [Qx Portal](https://qxportal.dev).
- [Kino.Qx.Client](Kino.Qx.Client.md): HTTP client for the snippet-browsing slice of the Qx Portal API
at `/api/v1`.
- [Kino.Qx.CredentialsCell](Kino.Qx.CredentialsCell.md): Livebook Smart Cell that emits a `%Qx.Hardware.Config{}` binding
(`qx`) for downstream cells to pipe circuits through.
- [Kino.Qx.Run](Kino.Qx.Run.md): Implementation of `Kino.Qx.run/2,3` and `Kino.Qx.run!/2,3`.
- [Kino.Qx.SafeReason](Kino.Qx.SafeReason.md): The single error-reason → human-readable string mapper used by
`Kino.Qx.Run` (frame + terminal lines) and `Kino.Qx.RunError`.
- [Kino.Qx.SmartCell](Kino.Qx.SmartCell.md): Livebook Smart Cell that browses a user's Qx Portal snippets and
injects the chosen one's source into the notebook.

- Exceptions
  - [Kino.Qx.Interrupted](Kino.Qx.Interrupted.md): Raised by `Kino.Qx.run/2,3` and `Kino.Qx.run!/2,3` when the caller
cell process is interrupted via Livebook's **trappable** "Stop"
(`:shutdown`) while a hardware run is in flight.
  - [Kino.Qx.RunError](Kino.Qx.RunError.md): Raised by `Kino.Qx.run!/2,3` when the underlying `Qx.Hardware.run/3`
returns an `{:error, reason}` tuple.

