This release is a pre-release and may not be stable for production use.
| Information | Links |
|---|---|
| Project |    |
| Community |   |
| CI |     |
Table of contents
- QHub HPC
- QHub
- :computer: Installation
- :label: Usage
- :question: Questions?
- :book: Code of Conduct
- :gear: Installing the Development version of QHub
- :raised_hands: Contributions
- License
Automated data science platform. From JupyterHub to Cloud environments with Dask Gateway.
QHub is an open source tool that enables users to build and maintain cost-effective and scalable compute/data science platforms on HPC or on Kubernetes with minimal DevOps experience.
This repository details the QHub (Kubernetes) version.
Not sure what to choose? Check out our Setup Initialization page.
QHub HPC
Version of QHub based on OpenHPC.
NOTE: The tool is currently under development. Curious? Check out the Qhub HPC repository.
QHub
The Kubernetes version of QHub is built using Terraform, Helm, and
GitHub Actions.
Terraform handles the build, change, and versioning of the infrastructure. Helm helps to define, install, and manage
Kubernetes. GitHub
Actions is used to automatically create commits when the configuration file (qhub-config.yaml) is rendered, as well as
to kick off the deployment action.
QHub aims to abstract all these complexities for its users. Hence, it is not necessary to know any of the above mentioned technologies to have your project successfully deployed.
TLDR: If you know GitHub and feel comfortable generating and using API keys, you should have all it takes to deploy and maintain your system without the need for a dedicated DevOps team. No need to learn Kubernetes, Terraform, or Helm.
:cloud: Cloud Providers
QHub offers out-of-the-box support for Digital Ocean, Amazon AWS, GCP, and Microsoft Azure.
For more details, check out the release blog post.
:computer: Installation
Pre-requisites
- QHub is supported by macOS and Linux operating systems (Windows is NOT currently supported).
- Compatible with Python 3.7+. New to Python? We recommend using Anaconda.
- Adoption of virtual environments (
conda,pipenvorvenv) is also encouraged.
Install QHub
To install QHub type the following commands in your command line:
-
Install using
conda:conda install -c conda-forge qhub
-
Install using
pip:pip install qhub
Once finished, you can check QHub's version (and additional CLI args) by typing:
qhub --help
If successful, the CLI output will be similar to the following:
usage: qhub [-h] [-v] {deploy,destroy,render,init,validate} ...
QHub command line
positional arguments:
{deploy,destroy,render,init,validate}
QHub
optional arguments:
-h, --help show this help message and exit
-v, --version QHub version
:label: Usage
QHub requires the setting of environment variables to automate the deployments fully. For details on how to obtain those variables, check the installation guide in the docs.
Once all the necessary credentials are gathered and set as UNIX environment variables, QHub can be deployed in under 20 minutes using:
qhub init ... # generates initial config file and optionally automates deployment steps
qhub deploy ... # creates and configures the cloud infrastructure
:question: Questions?
Have a look at our FAQ to see if your query has been answered.
We separate the queries for QHub into:
-
GitHub Discussions used to raise discussions about a subject, such as: "What is the recommended way to do X with QHub?"
-
Issues for queries, bug reporting, feature requests,documentation, etc.
We work around the clock to make QHub better, but sometimes your query might take a while to get a reply. We apologise in advance and ask you to please, be patient :pray:.
:book: Code of Conduct
To guarantee a welcoming and friendly community, we require contributors to follow our Code of Conduct.
:gear: Installing the Development version of QHub
To install the latest developer version (unstable) use:
pip install git+https://github.com/Quansight/qhub.git@dev
:raised_hands: Contributions
Thinking about contributing? Check out our Contribution Guidelines.
License
4 maintainers
Metadata
4 maintainers
Release files for qhub 0.4.0rc1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| qhub-0.4.0rc1.tar.gz | 345.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| qhub-0.4.0rc1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 722.3 kB
Release files / qhub-0.4.0rc1.tar.gz
| Download URL | qhub-0.4.0rc1.tar.gz |
|---|---|
| Size | 345.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0171a6ee6a94508ef7948b33996bea0d21568f541bacebfa9cda5cdbe7165adf
|
|
BLAKE2b-256 checksum How to use checksums |
8414d09adf498827502869568b7daace55d5a17ce63ad891ab2d836dc396ed21
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.8.0 pkginfo/1.8.2 readme-renderer/32.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.62.3 importlib-metadata/4.11.1 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.9.10
|
Release files / qhub-0.4.0rc1-py3-none-any.whl
| Download URL | qhub-0.4.0rc1-py3-none-any.whl |
|---|---|
| Size | 377.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d3d1b1a1cd7da738bfd62f5192ae569a393b1d6dd7f1757ce8945835e9d7a111
|
|
BLAKE2b-256 checksum How to use checksums |
5274fc1ad3ce02e52b4a0beec391e74cc1eaeee2fdfd297779b42c61652b979b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.8.0 pkginfo/1.8.2 readme-renderer/32.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.62.3 importlib-metadata/4.11.1 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.9.10
|
