⚛️ Quantum Information Science Kit for JavaScript. 💡 This project born as a clone (in JS) of its big brother.
beta: Until v1 breaking changes could be included.
📙 The basic concept of our quantum program is an array of quantum circuits. The program workflow consists of three stages: Build, Compile, and Run. Build allows you to make different quantum circuits that represent the problem you are solving. Compile allows you to rewrite them to run on different backends (simulators/real chips of different quantum volumes, sizes, fidelity, etc); and Run launches the jobs. After the jobs have been run, the data is collected. There are methods for putting this data together, depending on the program. This either gives you the answer you wanted or allows you to make a better program for the next instance.
If you want to learn more about Quantum Computing, you're invited to visit our Quamtum Experience project.
👜 The components of this repository are exposed as these libraries:
- @qiskit/sdk: Meta-package, documented in this file. It also includes a command line client, which is your friend if you want to play with all these features without having to use any programming language.
- @qiskit/devs: High level algorithms, thought for developers.
- @qiskit/devs-js: JavaScript engine.
- @qiskit/devs-anu: Australian National University Quantum Random Numbers Server engine.
- @qiskit/devs-ibm: Quantum Experience engine.
- @qiskit/cloud: Library to make easier the interaction with the Quantum Experience.
- @qiskit/utils: Helpers shared among all packages.
- @qiskit/qasm: Some OpenQASM tools, like parser.
- @qiskit/sim: An experimental JS simulator for OpenQASM circuits we're working on.
📥 You can find a bundled version with the same stuff ready to be used in the browser with each release.
qiskit-cloud.js
: The same for the@qiskit/cloud
component, also the same API and the global isQiskitCloud
.qiskit-devs.js
: The same for the@qiskit/devs
component, also the same API and the global isqiskitDevs
.qiskit-qasm.js
: Only the@qiskit/qasm
component, also the same API that for node.js. The globalqiskitQasm
is exposed.qiskit-sim.js
: The same for the@qiskit/sim
component, also the same API and the global isqiskitSim
.
If you need a new version of the bundled files, please run:
npm run bundle
Once bundled, visit this this one to see the JS version in action. You can use next command for a quick run:
npm run browser
☕ Install last Node.js stable version (or LTS) and then:
npm i -g @qiskit/sdk
🚀 The command line client allows to play with the circuits without having to use any programming language API.
qiskitjs --help
📝 As you can see in the next section, we have to use it like in the rest of independent modules. The only difference is we need to select the proper field of the main object before.
const qiskit = require('@qiskit/sdk');
console.log('Simulator version');
console.log(qiskit.sim.version);
👀 Full specification.
The actual version of the library.
version
(string) - Version number.
A wrapper fot the qiskit-qasm
project.
qasm
(object) - The same object provided in the original library.
A wrapper fot the qiskit-sim
project.
sim
(object) - The same object provided in the original library.
A wrapper fot the qiskit-cloud
project.
Cloud
(object) - The same constructor provided in the original library.
A wrapper fot the qiskit-utils
project.
utils
(object) - The same object provided in the original library.
A wrapper fot the qiskit-devs
project.
devs
(object) - The same object provided in the original library.
👽 https://github.com/Qiskit/qiskit-js/graphs/contributors
Original code (Python) authors here.
🎒
- Python Qiskit
- ibmqx backend information: Information about the different IBM Q experience backends.
- ibmqx user guide: The users guides for the IBM Q experience.
- OpenQasm: Examples and tools for the OpenQASM intermediate representation.
- Python API: API Client to use IBM Q experience in Python.
- Tutorials: Jupyter notebooks for using Qiskit.
🐧 Qiskit is released under the Apache license, v2.0.
😎 If you'd like to help please take a look to our contribution guidelines.