🪴 Nebari - your open source data science platform
Information | Links |
---|---|
Project | |
Community | |
CI |
⚠️ Warning ⚠️ The
2023.10.1
release includes the initial implementation of a Pluggy-based extension mechanism, for more details refer here. This version also fully deprecates CDS Dashboards as it is no longer compatible with the newer versions of JupyterHub. For more details on all of changes included in this release, please refer to our release notes. After you've installed version2023.10.1
, you can update yournebari-config.yaml
by runningnebari upgrade -c nebari-config.yaml
, please follow the upgrades instructions output by this command. And please 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 documentation on choosing a deployment platform
The Kubernetes version of Nebari uses Terraform, Helm, and GitHub Actions.
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.
Nebari offers out-of-the-box support for the major public cloud providers: Digital Ocean, Amazon AWS, GCP, and Microsoft Azure.
conda
, pipenv
or
venv
) is also encouraged.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
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.
An HPC version of Nebari is currently not available. There is one under development for Nebari's precursor QHub. Curious? Check out the QHub HPC repository.
Thinking about contributing? Check out our Contribution Guidelines to get started.
To install the latest developer version (unstable) use:
pip install git+https://github.com/nebari-dev/nebari.git
Have a look at our Frequently Asked Questions (FAQ) to see if your query has been answered.
Getting help:
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:.
To guarantee a welcoming and friendly community, we require all community members to follow our Code of Conduct.
If you're using Nebari and would like professional support, please get in touch with the Nebari development team.