Skip to main content

OpenBB Python Package

This section will highlight how you can run the open-source ODP Python Package locally and integrate 350+ different datasets into the OpenBB Workspace in under 5 minutes.

If you want to learn more about the open source ecosystem, check our documentation.

Step by step​

Follow the quick start steps here.

note

If you are using Brave/Safari you will need an HTTPS connection - see the Self-Signed Certificate section of the ODP Desktop documentation for steps to run your server over HTTPS.

These are some apps available out of the box:

Table Widget Example

Advanced - Access this data on mobile​

This section will use ngrok as the proxy between our platform API endpoints running locally and the internet. You can do this in ngrok free plan.

  1. Install ngrok by following these instructions.

  2. Open a terminal and run ngrok http 6900. This assume that the open source platform API is running on http://localhost:6900.

    If that runs correctly, you'll get an output similar to the following.

    ngrok

    Note the Forwarding row. That will contain a public URL that has access to your endpoint.

  3. Update your localhost endpoint with the public URL provided by ngrok.

    ngrok-2

  4. Add a request header as authentication.

    Click on "Add Authentication" button, and add the following:

    Key: ngrok-skip-browser-warning Value: x Location: Header

    You have to include the request header ngrok-skip-browser-warning with any value in the request header, to bypass the Ngrok Browser Warning.

    ngrok-3

    You are now ready to access this data on your phone, just ensure that you keep running the API endpoint and ngrok locally.

Advanced - Filter widgets​

If you run the steps above, you will have access to a dozen different data vendors and hundreds of different widgets. However, some of these may not work because you haven't set up the API key for the data vendor or you may not be interested to bring some of those widgets into your OpenBB Workspace.

This section will explore how you can filter the platform integration datasets that are made available on OpenBB.

  1. Go to the widgets filter page where you can set the data vendors you are interested and also select the widgets within. Once you are happy you can download the widget_settings.json configuration file by clicking on Download.

    widgets

  2. In the OpenBB folder that has been created when you installed the Platform. There must be a Settings folder within. This folder should be the destination of your widget settings file (widget_settings.json), which will serve as the configuration file for your custom backend.

    Now, similarly to the previous section, you should:

    • Run OpenBB/openbb-api
    • Set your PAT
    • Refresh the connection inside the "Manage Backends" button or follow instructions above to add again.

    Take into consideration that, if you change the default configurations on the OpenBB Platform settings, the URL (http://127.0.0.1:6900) might differ.

    widgets-filter

On this page