Metadata-Version: 2.4
Name: patoka
Version: 0.3.1
Summary: A collection of Jupyter Lab widgets for IBM Qiskit
Author: Hyeok Kim, Mingyoung J. Jeng, Kaitlin N. Smith
Project-URL: Homepage, https://github.com/see-mike-out/patoka
Project-URL: Issues, https://github.com/see-mike-out/patoka/issues
Requires-Python: >=3.14
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
Requires-Dist: qiskit>=2.5
Requires-Dist: qiskit-aer>=0.17
Requires-Dist: qiskit_ibm_runtime>=0.50
Requires-Dist: qiskit_algorithms>=0.4
Requires-Dist: qiskit_machine_learning>=0.9
Requires-Dist: numpy>=2.5
Requires-Dist: pandas>=2.3
Requires-Dist: altair>=6.3
Requires-Dist: scipy>=1.18
Requires-Dist: tqdm>=4.70
Requires-Dist: jupyter>=1.1
Requires-Dist: anywidget>=0.11
Requires-Dist: matplotlib>=3.11
Requires-Dist: python-dotenv
Dynamic: license-file

# Patoka

Patoka is a collection of Jupyter Lab widgets for IBM Qiskit

[Website](https://see-mike-out.github.io/patoka/)

## User-side installation

`pip install patoka`

## Usage

Refer to notebooks in the `demos` directory.

## Developers

### Virtual environment

Use your preferred virtual environment methods.
We used `uv`.

### Install libraries

1. For Python:
 `pip install -e .`

2. For Node:
 `npm i`

### Running the dev version widget server

Run: `npm run dev`

Then, import the loader functions from `patoka.widgets_dev` (e.g., `from patoka.widgets_dev import getCircuitViewer`).

### Bug report

Please use issues. Because the production version cannot attribute to Javascript source files, please run with the dev version.

## Citation

[Preprint](https://arxiv.org/abs/2502.00202)

```latex
@inproceedings{kim:patoka2025,
 title        = {Toward Human-Quantum Computer Interaction: Interface Techniques for Usable Quantum Computing},
 author       = {Kim, Hyeok and Jeng, Mingyoung J. and Smith, Kaitlin N.},
 year         = 2025,
 booktitle    = {ACM Proc. CHI},
 doi          = {10.1145/3706598.3713370}
}
```
