Files
OpenBB/website/content/sdk/quickstart/installation.md
Jeroen Bouma 6316d36be1 Many improvements to the documentation (#3562)
* Many improvements

* Forgot these

* Set menus correctly

* Delete unrelated code

* Add in chart styling

* Add in simple guide to chart styling

* More updates

* last changes

* Update changing-sources.md

* Update file to redirect to proper folder and formatting

Co-authored-by: Jeroen Bouma <jeroenbouma@Jeroens-MacBook-Pro.local>
Co-authored-by: Jeroen Bouma <jeroenbouma@jeroens-mbp.home>
2022-11-25 18:10:28 +00:00

2.7 KiB
Vendored

title, sidebar_position
title sidebar_position
Installation 2

We provide a simple installation method in order to utilize the OpenBB SDK. You must first create an environment, which allows you to isolate the SDK from the rest of your system. It is our recommendation that you utilize a conda environment because there are optional features, such as forecast, that utilize libraries that are specifically sourced from conda-forge. Due to this, if you do not use a conda environment, you will not be able to use some of these features. As such, the installation steps will be written under the assumption that you are using conda.

Steps

1. Install Miniconda

Download the x86_64 Miniconda for your respective system and follow along with it's installation instructions. The Miniconda architecture MUST be x86_64 in order to use certain features.

2. Create the virtual environment

conda create -n obb python=3.9.6 -y

3. Activate the virtual environment

conda activate obb

4. Install OpenBB SDK Core package

pip install openbb

5. (Optional) Install the Toolkits

5.1 If you would like to use the Portfolio Optimization features

On Apple Silicon Macs (M1/M2) install dependency from conda-forge

conda install -c conda-forge cvxpy=1.2.2 -y

And install the Portfolio Optimization Toolkit

pip install "openbb[optimization]"

5.2 If you would like ML Forecasting features

On Apple Silicon Macs (M1/M2) install dependency from conda-forge

conda install -c conda-forge lightgbm=3.3.3 -y

And install the Forecasting Toolkit

pip install "openbb[prediction]"

5.3 If you would like to use both Portfolio Optimization and ML forecast features

On Apple Silicon Macs (M1/M2) install dependencies from conda-forge

conda install -c conda-forge lightgbm=3.3.3 cvxpy=1.2.2 -y

And install the Both Toolkits

pip install "openbb[all]"

Congratulations! You have successfully installed openbb on an environment and are now able to begin using it. However, it is important to note that if you close out of your CLI you must re-activate your environment in order begin using it again. This can be done with the following:

conda activate obb

The OpenBB SDK can be imported to a Jupyter Notebook or any code editor with, from openbb_terminal.sdk import openbb as explained in the Structure of the SDK and Using the SDK guides. By following the above process, the OpenBB Terminal is automatically included as well which can be ran by typing openbb.