A Jupyter and Dask-powered open source data science platform.
Project description
Your open source data science platform. Built for scale, designed for collaboration.
Information | Links |
---|---|
Project | |
Community | |
CI |
Table of contents
- Table of contents
- QHub HPC
- Nebari
- Installation 💻
- Usage 🚀
- Contributing to Nebari 👩🏻💻
- Code of Conduct 📖
- Ongoing Support
- License
⚠️ Warning ⚠️ The project has recently been renamed from QHub to Nebari. If your deployment is still managed by
qhub
, performing an in place upgrade will IRREVOCABLY BREAK your deployment. This will cause you to lose any data stored on the platform, including but not limited to, NFS (file system) data,conda-store
environments, Keycloak users and groups, etc. Make sure to back up your data before attempting an upgrade.
Automated data science platform. From JupyterHub to Cloud environments with Dask Gateway.
Nebari is an open source data platform that enables users to build and maintain cost-effective and scalable compute platforms on HPC or Kubernetes with minimal DevOps overhead.
This repository details the Nebari (Kubernetes) version.
Not sure what to choose? Check out our Setup Initialization page.
QHub HPC
The HPC version of Nebari is based on OpenHPC.
NOTE: The tool is currently under development. Curious? Check out the Nebari HPC repository.
Nebari
The Kubernetes version of Nebari uses Terraform, Helm, and GitHub Actions.
- Terraform handles the build, change, and versioning of the infrastructure.
- Helm helps to define, install, and manage Kubernetes resources.
- GitHub Actions is used to automatically create commits when the configuration file (
nebari-config.yaml
) is rendered, as well as to kick off the deployment action.
Nebari aims to abstract all these complexities for its users. Hence, it is not necessary to know any of the technologies mentioned above 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 Providers ☁️
Nebari offers out-of-the-box support for the major public cloud providers: Digital Ocean,
Amazon AWS, GCP, and Microsoft Azure.
Installation 💻
Pre-requisites
- Operating System: Currently, Nebari supports development on macOS and Linux operating systems. Windows is NOT supported. However, we would welcome contributions that add and improve support for Windows.
- You need Python >= 3.7 on your local machine or virtual environment to work on Nebari.
- Adopting virtual environments (
conda
,pipenv
orvenv
) is also encouraged.
Install Nebari
To install Nebari type the following commands in your command line:
-
Install using
conda
:conda install -c conda-forge nebari # if you prefer using mamba mamba install -c conda-forge nebari
-
Install using
pip
:pip install nebari
Once finished, you can check Nebari's version (and additional CLI arguments) by typing:
nebari --help
If successful, the CLI output will be similar to the following:
usage: nebari [-h] [-v] {deploy,destroy,render,init,validate} ...
Nebari command line
positional arguments:
{deploy,destroy,render,init,validate}
Nebari
optional arguments:
-h, --help show this help message and exit
-v, --version Nebari version
Usage 🚀
Nebari requires setting multiple environment variables to automate the deployments fully. For details on obtaining those variables, check the Nebari Get started documentation.
Once all the necessary credentials are gathered and set as UNIX environment variables, Nebari can be deployed in minutes.
For detailed step-by-step instructions on how to deploy Nebari, check the Nebari documentation.
Contributing to Nebari 👩🏻💻
Thinking about contributing? Check out our Contribution Guidelines to get started.
Installing the Development version of Nebari ⚙️
To install the latest developer version (unstable) use:
pip install git+https://github.com/nebari-dev/nebari.git
Questions? 🤔
Have a look at our Frequently Asked Questions (FAQ) to see if your query has been answered.
Getting help:
- GitHub Discussions is our user forum. It can be used to raise discussions about a subject, such as: "What is the recommended way to do X with Nebari?"
- Issues for queries, bug reporting, feature requests, documentation, etc.
We work around the clock to make Nebari better, but sometimes your query might take a while to get a reply. We apologize in advance and ask you to please, be patient :pray:.
Code of Conduct 📖
To guarantee a welcoming and friendly community, we require all community members to follow our Code of Conduct.
Ongoing Support
The v0.4.0
release introduced many changes that will irrevocably break your deployment if you attempt an in-place upgrade; for details, see our
RELEASE notes. To focus on the future direction of the project, we have decided as a team that we will provide limited support for older versions. Any new user is encouraged to use v0.4.0
or greater.
If you're using an older version of Nebari and would like professional support, please get in touch with the Nebari development team.
License
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for nebari-2023.5.1rc1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 594c9b21fb51f96857bd895cec3ee756f97a0e095d3bef8e26feaae44bcbc706 |
|
MD5 | 8d90789be5793759d672cd1d3ed9caa0 |
|
BLAKE2b-256 | c8ad78da79fe24f9ba024bb415de560a844498a79c6eb99c5809a78913154d29 |