# qbraid-core
[![Documentation](https://img.shields.io/badge/Documentation-DF0982)](https://docs.qbraid.com/projects/core/en/latest/)
[![PyPI version](https://img.shields.io/pypi/v/qbraid-core.svg?color=blue)](https://pypi.org/project/qbraid-core/)
[![Python verions](https://img.shields.io/pypi/pyversions/qbraid-core.svg?color=blue)](https://pypi.org/project/qbraid-core/)
[![GitHub](https://img.shields.io/badge/issue_tracking-github-blue?logo=github)](https://github.com/qBraid/qBraid-Lab/issues)
[![Discord](https://img.shields.io/discord/771898982564626445.svg?color=pink)](https://discord.gg/KugF6Cnncm)
Python library providing core abstractions for software development within the qBraid ecosystem, and a low-level interface to a growing array of qBraid cloud services. The qbraid-core package forms the foundational base for the [qBraid CLI](https://pypi.org/project/qbraid-cli/), the [qBraid SDK](https://pypi.org/project/qbraid/), and the
[jupyter-environment-manager](https://pypi.org/project/jupyter-environment-manager/).
You can find the latest, most up to date, documentation [here](https://docs.qbraid.com/projects/core/en/latest/), including a list of services that are supported.
## Getting Started
You can install qbraid-core from PyPI with:
```bash
python -m pip install qbraid-core
```
### Local configuration
After installing qbraid-core, you must configure your account credentials:
1. Create a qBraid account or log in to your existing account by visiting
[account.qbraid.com](https://account.qbraid.com/)
2. Copy your API Key token from the left side of
your [account page](https://account.qbraid.com/):
3. Save your API key from step 2 in local configuration file `~/.qbraid/qbraidrc`, where `~` corresponds to your home (`$HOME`) directory:
```bash
[default]
api-key = YOUR_KEY
url = https://api.qbraid.com/api
```
Or generate your `~/.qbraid/qbraidrc` file via the qbraid-core Python interface:
```python
>>> from qbraid_core import QbraidSession
>>> session = QbraidSession(api_key='API_KEY')
>>> session.save_config()
>>> session.get_available_services()
['environments', 'quantum']
```
Other credential configuration methods can be found [here](https://docs.qbraid.com/projects/cli/en/latest/tree/qbraid_configure.html).
### Verify setup
After configuring your qBraid credentials, verify your setup by running the following from a Python interpreter:
```python
>>> import qbraid_core
>>> quantum_client = qbraid_core.client('quantum')
>>> device_data = quantum_client.search_devices()
>>> for item in device_data:
... print(item['qbraid_id'])
```
## Community
- For feature requests and bug reports: [Submit an issue](https://github.com/qBraid/qBraid-Lab/issues)
- For discussions and/or specific questions about qBraid services, [join our discord community](https://discord.gg/KugF6Cnncm)
- For questions that are more suited for a forum, post to [Stack Overflow](https://stackoverflow.com/) with the [`qbraid`](https://stackoverflow.com/questions/tagged/qbraid) tag.
## Launch on qBraid
The "Launch on qBraid" button (below) can be added to any public GitHub
repository. Clicking on it automaically opens qBraid Lab, and performs a
`git clone` of the project repo into your account's home directory. Copy the
code below, and replace `YOUR-USERNAME` and `YOUR-REPOSITORY` with your GitHub
info.
[<img src="https://qbraid-static.s3.amazonaws.com/logos/Launch_on_qBraid_white.png" width="150">](https://account.qbraid.com?gitHubUrl=https://github.com/qBraid/qBraid.git)
Use the badge in your project's `README.md`:
```markdown
[<img src="https://qbraid-static.s3.amazonaws.com/logos/Launch_on_qBraid_white.png" width="150">](https://account.qbraid.com?gitHubUrl=https://github.com/YOUR-USERNAME/YOUR-REPOSITORY.git)
```
Use the badge in your project's `README.rst`:
```rst
.. image:: https://qbraid-static.s3.amazonaws.com/logos/Launch_on_qBraid_white.png
:target: https://account.qbraid.com?gitHubUrl=https://github.com/YOUR-USERNAME/YOUR-REPOSITORY.git
:width: 150px
```
Raw data
{
"_id": null,
"home_page": null,
"name": "qbraid-core",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "qbraid, quantum, cloud",
"author": "qBraid Development Team",
"author_email": "contact@qbraid.com",
"download_url": "https://files.pythonhosted.org/packages/b1/39/0bea514bd6529319acc115ed165e4238b843acb4553b5eb4bc3704755a20/qbraid_core-0.1.9.tar.gz",
"platform": null,
"description": "# qbraid-core\n\n[![Documentation](https://img.shields.io/badge/Documentation-DF0982)](https://docs.qbraid.com/projects/core/en/latest/)\n[![PyPI version](https://img.shields.io/pypi/v/qbraid-core.svg?color=blue)](https://pypi.org/project/qbraid-core/)\n[![Python verions](https://img.shields.io/pypi/pyversions/qbraid-core.svg?color=blue)](https://pypi.org/project/qbraid-core/)\n[![GitHub](https://img.shields.io/badge/issue_tracking-github-blue?logo=github)](https://github.com/qBraid/qBraid-Lab/issues)\n[![Discord](https://img.shields.io/discord/771898982564626445.svg?color=pink)](https://discord.gg/KugF6Cnncm)\n\nPython library providing core abstractions for software development within the qBraid ecosystem, and a low-level interface to a growing array of qBraid cloud services. The qbraid-core package forms the foundational base for the [qBraid CLI](https://pypi.org/project/qbraid-cli/), the [qBraid SDK](https://pypi.org/project/qbraid/), and the\n[jupyter-environment-manager](https://pypi.org/project/jupyter-environment-manager/).\n\nYou can find the latest, most up to date, documentation [here](https://docs.qbraid.com/projects/core/en/latest/), including a list of services that are supported.\n\n## Getting Started\n\nYou can install qbraid-core from PyPI with:\n\n```bash\npython -m pip install qbraid-core\n```\n\n### Local configuration\n\nAfter installing qbraid-core, you must configure your account credentials:\n\n1. Create a qBraid account or log in to your existing account by visiting\n [account.qbraid.com](https://account.qbraid.com/)\n2. Copy your API Key token from the left side of\n your [account page](https://account.qbraid.com/):\n3. Save your API key from step 2 in local configuration file `~/.qbraid/qbraidrc`, where `~` corresponds to your home (`$HOME`) directory:\n\n```bash\n[default]\napi-key = YOUR_KEY\nurl = https://api.qbraid.com/api\n```\n\nOr generate your `~/.qbraid/qbraidrc` file via the qbraid-core Python interface:\n\n```python\n>>> from qbraid_core import QbraidSession\n>>> session = QbraidSession(api_key='API_KEY')\n>>> session.save_config()\n>>> session.get_available_services()\n['environments', 'quantum']\n```\n\nOther credential configuration methods can be found [here](https://docs.qbraid.com/projects/cli/en/latest/tree/qbraid_configure.html).\n\n### Verify setup\n\nAfter configuring your qBraid credentials, verify your setup by running the following from a Python interpreter:\n\n```python\n>>> import qbraid_core\n>>> quantum_client = qbraid_core.client('quantum')\n>>> device_data = quantum_client.search_devices()\n>>> for item in device_data:\n... print(item['qbraid_id'])\n```\n\n## Community\n\n- For feature requests and bug reports: [Submit an issue](https://github.com/qBraid/qBraid-Lab/issues)\n- For discussions and/or specific questions about qBraid services, [join our discord community](https://discord.gg/KugF6Cnncm)\n- For questions that are more suited for a forum, post to [Stack Overflow](https://stackoverflow.com/) with the [`qbraid`](https://stackoverflow.com/questions/tagged/qbraid) tag.\n\n## Launch on qBraid\n\nThe \"Launch on qBraid\" button (below) can be added to any public GitHub\nrepository. Clicking on it automaically opens qBraid Lab, and performs a\n`git clone` of the project repo into your account's home directory. Copy the\ncode below, and replace `YOUR-USERNAME` and `YOUR-REPOSITORY` with your GitHub\ninfo.\n\n[<img src=\"https://qbraid-static.s3.amazonaws.com/logos/Launch_on_qBraid_white.png\" width=\"150\">](https://account.qbraid.com?gitHubUrl=https://github.com/qBraid/qBraid.git)\n\nUse the badge in your project's `README.md`:\n\n```markdown\n[<img src=\"https://qbraid-static.s3.amazonaws.com/logos/Launch_on_qBraid_white.png\" width=\"150\">](https://account.qbraid.com?gitHubUrl=https://github.com/YOUR-USERNAME/YOUR-REPOSITORY.git)\n```\n\nUse the badge in your project's `README.rst`:\n\n```rst\n.. image:: https://qbraid-static.s3.amazonaws.com/logos/Launch_on_qBraid_white.png\n :target: https://account.qbraid.com?gitHubUrl=https://github.com/YOUR-USERNAME/YOUR-REPOSITORY.git\n :width: 150px\n```\n",
"bugtrack_url": null,
"license": "Proprietary",
"summary": "Python library with core abstractions for software development in the qBraid ecosystem.",
"version": "0.1.9",
"project_urls": {
"Bug Tracker": "https://github.com/qBraid/qBraid-Lab/issues",
"Discord": "https://discord.gg/KugF6Cnncm",
"Documentation": "https://docs.qbraid.com/projects/core/en/latest/",
"Homepage": "https://www.qbraid.com/",
"Launch on Lab": "https://account.qbraid.com/?gitHubUrl=https://github.com/qBraid/qBraid-Lab.git"
},
"split_keywords": [
"qbraid",
" quantum",
" cloud"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1f5f25f14a8524b5a5725d8e41b132394bb9387001943ece556bc9c22291dbd1",
"md5": "f998bbac0f011785b18b5a020f28ddef",
"sha256": "42b785a97102c358cf9b49bf0190e5faf5783f10290dd73f916b5a0820886f8b"
},
"downloads": -1,
"filename": "qbraid_core-0.1.9-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f998bbac0f011785b18b5a020f28ddef",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 55437,
"upload_time": "2024-05-22T19:53:30",
"upload_time_iso_8601": "2024-05-22T19:53:30.003900Z",
"url": "https://files.pythonhosted.org/packages/1f/5f/25f14a8524b5a5725d8e41b132394bb9387001943ece556bc9c22291dbd1/qbraid_core-0.1.9-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b1390bea514bd6529319acc115ed165e4238b843acb4553b5eb4bc3704755a20",
"md5": "79b96bfc1d53d65317c2f12683b7b4d1",
"sha256": "79b4ed36b1c29258efa46508c05cbfdc6471e609fb35f0f435e9515fdd6ec53e"
},
"downloads": -1,
"filename": "qbraid_core-0.1.9.tar.gz",
"has_sig": false,
"md5_digest": "79b96bfc1d53d65317c2f12683b7b4d1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 266735,
"upload_time": "2024-05-22T19:53:31",
"upload_time_iso_8601": "2024-05-22T19:53:31.524726Z",
"url": "https://files.pythonhosted.org/packages/b1/39/0bea514bd6529319acc115ed165e4238b843acb4553b5eb4bc3704755a20/qbraid_core-0.1.9.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-22 19:53:31",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "qBraid",
"github_project": "qBraid-Lab",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "qbraid-core"
}