Library / SDK
OpenBB-finance/OpenBB avatar
OpenBB-finance/OpenBB

OpenBB's open-source layer is a data integration API, and its analyst UI is a separate product

Open data platform that pipes proprietary, licensed, and public financial data into Python, Excel, MCP servers, and REST APIs for analysts, quants, and AI agents.

75,421 stars7,892 forksPythonLicense varies

At a glance

What is it?
The Open Data Platform installs with one pip command and serves the same consolidated data to Python, Excel, MCP servers and REST clients, with a localhost FastAPI server for the Workspace connection. What you get for free is the integration layer; the Workspace that renders it for analysts lives at pro.openbb.co, and the project's own disclaimer says the data is not necessarily accurate.
Who is it for?
Open Data Platform fits a data engineer who has to consolidate several licensed feeds once and expose them to more than one consumer, because the FastAPI server and the MCP path are the parts you would otherwise write and maintain yourself.
Can I use it commercially?
Check first. The repository uses a licence we do not classify automatically, so read its LICENSE file before any commercial use.
Is it still maintained?
Yes. The repository received new commits within the last day.
What is it written in?
Mainly Python, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on November 14, 2026, and from our analysis. They are not legal advice.

From daily snapshots

Star history

  • OpenBB-finance/OpenBB75,421 ★ · +4,295
Star history
Repository2026-07-282026-11-14
OpenBB-finance/OpenBB71.1k75.4k

4,295 Stars in the last 109 days, measured from the daily GitHub snapshot. Compare with other projects

Editorial analysis

Four consumption surfaces share one local API server

The whole design fits in the phrase the README uses, connect once, consume everywhere. Open Data Platform is described as the open-source toolset that helps data engineers integrate proprietary, licensed and public data sources into downstream applications such as AI copilots and research dashboards. The four surfaces it names are Python environments for quants, OpenBB Workspace and Excel for analysts, MCP servers for AI agents, and REST APIs for other applications.

The Python entry point is three lines, and the second one is the detail that matters:

python
from openbb import obb
output = obb.equity.price.historical("AAPL")
df = output.to_dataframe()

The same installation that provides the obb import can also be started as a server:

sh
pip install openbb
sh
openbb-api

That second command launches a FastAPI server, via Uvicorn, at 127.0.0.1:6900, and the README tells you to confirm it by visiting that address in a browser. So the architecture is a local consolidation layer that can present itself as an importable namespace or as an HTTP endpoint, and the README's walkthrough connects OpenBB Workspace to that endpoint.

The analyst interface is a commercial product, and the README is clear about it

The repository contains the data layer, not the application. The README draws the line in its own section: while the Open Data Platform provides the open-source data integration foundation, OpenBB Workspace offers the enterprise UI for analysts to visualise datasets and leverage AI agents, and Workspace is at pro.openbb.co. The extension repositories follow the same split, one for backends and one for agents, both under the OpenBB-finance organisation and both separate from this repository.

The consequence for a reader is straightforward and worth stating before anyone installs anything. Installing openbb from PyPI gives you the integrations, the obb namespace and the local API server. It does not give you the analyst interface, the dataset browser or the agent panel, because those belong to the Workspace. The README frames this as complementary rather than competing, which is a fair description, but a reader who expects a working research dashboard from a pip install will not get one.

The extension model is the part that softens the boundary. Because adding data to the Workspace and adding agents to it are both handled by open source repositories with their own documentation, a team that already uses the Workspace can build its own connectors, and a team that does not can still own the integration layer and present it through something else. The deciding question is whether your consumers are Python processes, in which case the open-source layer is the whole requirement, or people, in which case you are evaluating the Workspace.

The disclaimer says the data is not necessarily accurate, and disclaims liability

Section 4 of the README is a trading disclaimer, and it is unusually direct for a data library. It states that trading in financial instruments involves high risks including the risk of losing some or all of your investment, and that it may not be suitable for all investors. It advises being fully informed of the risks and costs, considering investment objectives, experience and risk appetite, and seeking professional advice where needed.

The sentence that matters for an engineer is this one: the data contained in the Open Data Platform is not necessarily accurate. Not that it is occasionally late, or that a particular provider has known gaps, but that accuracy is not claimed. The following sentence accepts no liability for loss or damage resulting from your trading or your reliance on the information displayed, and the third-party paragraph adds that names, logos and brands referenced in the sites, products or documentation belong to their owners and that OpenBB is not endorsed by, sponsored by or affiliated with them unless stated.

Read as engineering guidance rather than legal boilerplate, this sets the bar. A pipeline built on OpenBB inherits whatever the upstream provider does, and the project is not standing behind it. If you need a figure you can put in front of a client, you need to reconcile it against a source you trust, and the disclaimer tells you in advance that the project will not do that for you.

The Workspace connector asks for a localhost URL, so the browser must be on the same machine

The integration walkthrough is five steps and reads like any other OAuth-style connection flow. Sign in to the Workspace, go to the Apps tab, click Connect backend, then fill in a form with the name Open Data Platform and the URL http://127.0.0.1:6900. Click Test and you should get a Test successful message along with the number of apps found, then click Add.

The form is where the constraint sits. A URL of 127.0.0.1:6900 resolves to the machine running the browser, not the machine running the API server, so the walkthrough only works when the Workspace page, the browser and the FastAPI process are all on one computer. The instructions do not mention a hostname, a tunnel, a reverse proxy or a host configuration option.

For a local analyst this is exactly right, and it keeps the data on the machine with no exposed port. For a team, it is the first thing to solve, and the walkthrough does not describe a solution. The walkthrough covers only the Workspace connection. Read the walkthrough as a development setup rather than as a deployment guide, because that is the only thing it describes.

The command-line tool is openbb-cli, and the README never calls it a terminal

There are two distributions and they are installed separately. The Open Data Platform Python package comes from PyPI with pip install openbb, or from a direct clone of the repository at https://github.com/OpenBB-finance/OpenBB.git, with the fuller process documented at docs.openbb.co/python/installation. The command-line interface is a different package: pip install openbb-cli, with the same clone alternative and its own documentation page at docs.openbb.co/cli/installation.

What the CLI is for is stated in one sentence, that it allows you to access the ODP directly from your command line. That is the whole description. The visible installation section gives no list of subcommands or flags; the CLI documentation is linked at docs.openbb.co/cli/installation.

The naming is worth flagging for anyone arriving with prior expectations. The README calls this the ODP CLI and the package is openbb-cli. The part of the README shown does not use the word terminal, and the repository root has a cli/ directory beside openbb_platform/, desktop/, cookiecutter/, examples/, assets/, images/ and a set of dotfiles.

The default branch is develop while the licence link points at main

The repository's default branch is develop. The licence section links to LICENSE at a URL under the main branch, and the top-level tree does contain a LICENSE file alongside SECURITY.md, CODE_OF_CONDUCT.md and a .pre-commit-config.yaml. So the file is present and the Apache License 2.0 is stated in the README; the branch in the link is simply a different branch from the default one. GitHub's own metadata records the licence field as unasserted rather than Apache 2.0, so a tool that reads repository metadata and a reader who opens the README will get different answers about what licence this is.

The release history explains the pace. Three releases are listed, and all three are dated 2026-09-30: openbb-v5.0.0 titled OpenBB V5, a second tagged Open-Data-Platform-v2.0.0 for ODP Desktop v2.0.0, and a third simply titled ODP for the latest stable desktop. The last push to the repository was on 2026-11-01. This is an active project, and a develop default branch plus same-day major releases means the version you pip install and the version on the default branch can be a major version apart. Pin the package version and read the changelog for it before assuming a behaviour you relied on last week is still there.

Twenty-four example notebooks are the real documentation

The examples directory is where a new user will learn the platform, and its shape tells you what the project expects people to build. Most entries are Jupyter notebooks, and four of them have a matching .webp preview image: financialStatements, findSymbols, impliedEarningsMove and googleColab. Of these, googleColab.ipynb is the one the README's own badge links to. Others stand alone, among them BacktestingMomentumTrading, copperToGoldRatio, currencyExchangeRateForecasting, mAndAImpact, riskReturnAnalysis, sectorRotationStrategy, portfolioOptimizationUsingModernPortfolioTheory and EthereumTrendAnalysis.

Three files in that list matter more than the rest for understanding the direction of the project. openbbPlatformAsLLMTools.ipynb is about exposing the platform to a language model, openbb_vs_langchain.ipynb is an explicit comparison against another agent framework, and platform_standardization.ipynb is about normalising data across providers. There is also a COMMUNITY_EXAMPLE_TEMPLATE.ipynb, which is a template rather than an example, a content.json, a README.md for the directory, and two subdirectories, openbb-apachebeam/ and streamlit/, which are whole applications rather than notebooks.

What is absent is as informative as what is present. No file name in the directory points to the Excel surface or the MCP path, both of which the connect once, consume everywhere claim names, though the notebook contents are not visible.

Editorial conclusion

Open Data Platform fits a data engineer who has to consolidate several licensed feeds once and expose them to more than one consumer, because the FastAPI server and the MCP path are the parts you would otherwise write and maintain yourself. It does not fit an analyst who wants the Workspace interface from the open-source package, since that surface is a separate product, and it does not fit anyone who needs a data-quality guarantee, because the disclaimer states plainly that the data is not necessarily accurate. Before building on it, read the disclaimer in full, then check which of your feeds are actually integrated by looking at the data integration reference rather than assuming coverage, and confirm your Python version falls in the 3.11 to 3.14 window the integration instructions name.

Frequently asked questions

What is OpenBB?

Open Data Platform by OpenBB is an open-source toolset that helps data engineers integrate proprietary, licensed and public data sources into downstream applications such as AI copilots and research dashboards. It presents the same consolidated data to Python environments, OpenBB Workspace and Excel, MCP servers for AI agents, and REST APIs.

How do I install OpenBB?

Run pip install openbb for the Python package, or clone https://github.com/OpenBB-finance/OpenBB.git directly. The command-line interface is a separate package installed with pip install openbb-cli. The integration instructions specify a Python environment from 3.11 to 3.14.

What is the OpenBB platform?

It is the open-source data integration layer, and it runs as a local service as well as an import. The openbb-api command launches a FastAPI server via Uvicorn at 127.0.0.1:6900, which is what the README's walkthrough connects OpenBB Workspace to. The analyst interface itself, OpenBB Workspace, is a separate product at pro.openbb.co.

How do I use OpenBB in Python?

Import obb from openbb, call a route on it, and convert the result to a dataframe: from openbb import obb, then obb.equity.price.historical("AAPL"), then output.to_dataframe(). The full set of available data integrations is listed in the data integration reference at docs.openbb.co/python/reference.

What does OpenBB do?

It consolidates multiple financial data sources behind one interface and exposes them to several consumers at once, which the README calls connect once, consume everywhere. The surfaces are Python, OpenBB Workspace and Excel, MCP servers for AI agents, and REST APIs. Its own disclaimer states that the data it contains is not necessarily accurate.

Official sources

  1. Official documentation
  2. Official README
  3. Project repository
  4. Release notes
Add this badge to your README

If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.

Add this badge to your README

markdown
[![Hysen Labs](https://hysenlabs.com/badge/openbb-finance-openbb.svg)](https://hysenlabs.com/projects/openbb-finance-openbb)

Star history chart for your README

markdown
[![Star history](https://hysenlabs.com/chart/openbb-finance-openbb.svg)](https://hysenlabs.com/projects/openbb-finance-openbb)

Was this useful?