Mindket

OpenBB

Newversion 2 · updated
Star75.2k

Overview

OpenBB’s free, open source Open Data Platform: connect financial and economic data once, then use it from Python, a command line, a REST API, OpenBB Workspace and MCP servers for AI agents. The setup notes cover each route.

OpenBB is an open-source project on GitHub in the Finance & accounting category, listed by Mindket. It is free. This is version 2, last updated on . Install it from GitHub as its README says. Get Mindket’s setup notes on your Mindket account, as a zip.

At a glance

Runs in
  • Python: the obb object, after pip install openbb
  • The command line: the openbb command, for one command, a batch or an interactive REPL
  • ODP Desktop: a Windows and macOS app that manages Python environments and backend servers
  • REST API: openbb-api serves every installed command over HTTP
Start with
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip

Platform

WindowsOperating system
macOSOperating system
Claude DesktopDesktop app
CursorCode editor
VS CodeCode editor

About

What it is

Open Data Platform by OpenBB, ODP for short, is an open source toolset that connects data sources once so many tools can read them. Its README says it helps data engineers bring proprietary, licensed and public data into downstream applications like AI copilots and research dashboards. The same installed commands are available from Python, as a REST API, as MCP tools and as OpenBB Workspace widgets. The README also names Excel as a surface for analysts. It comes as a Python package, a command line and a desktop app.

  1. You install the openbb package or single providers
  2. Each provider adds one data source and its own namespace
  3. The installed commands become one set of data calls
  4. Python, REST, MCP tools and Workspace widgets all use it

Who it suits

Quants who work in Python, analysts who want the same data in OpenBB Workspace, and developers who give an AI agent market and economic data through MCP. Skip it if you want a finished trading product. The README’s own disclaimer says the data is not necessarily accurate and that trading in financial instruments carries high risk.

Who uses it, and how
IndustryWho uses itHow they use itExample
Quant researchQuants and data scientistsCall provider data from Python and get pandas DataFrames backA quant requests the FRED series GDP from 2015 and calls to_dataframe() on the result.
Analyst desksAnalysts who use OpenBB WorkspaceServe the installed commands with openbb-api and connect that server as a backendAn analyst starts openbb-api, adds http://127.0.0.1:6900 in Workspace and finds each command as a widget.
AI agent buildersDevelopers who give agents dataRun openbb-mcp so an agent can call the commands as toolsA developer adds openbb-mcp to Claude Desktop and asks the agent for an Apple quote from Cboe.
Data engineeringEngineers who feed other applicationsPut one REST API in front of public and licensed data sourcesAn engineer starts openbb-api --host 0.0.0.0 --port 6900 on a server with a Basic login set, and another service calls /api/v1/cboe/equity/quote.

Where to use it

The maker documents these routes, and the kit has a page for each.

  • Python: the obb object, after pip install openbb
  • The command line: the openbb command, for one command, a batch or an interactive REPL
  • ODP Desktop: a Windows and macOS app that manages Python environments and backend servers
  • REST API: openbb-api serves every installed command over HTTP
  • OpenBB Workspace: connect the running REST API as a backend
  • MCP: openbb-mcp serves the commands as tools for Claude Desktop, Cursor and VS Code
Data sources it connects
AreaProvidersKey
Markets and optionsCboe, Nasdaq, FINRA, TMX (unofficial) and Deribit for crypto derivativesNone needed
Economy and statisticsFRED, IMF, OECD, ECB, BLS and the Federal ReserveFRED needs a free key. BLS takes an optional one
Government and energyUS Treasury, USDA, Congress.gov, EIA, JODI and CFTCEIA needs a free key. CFTC and Congress.gov take optional ones
Filings and researchSEC EDGAR and the Kenneth French Data LibraryNone needed

How to set it up

Get it saves a zip of Mindket’s setup notes in your downloads folder, with a page for each route above. The main route is pip, inside a virtual environment.

What you need first
NeedDetail
Python3.10 or newer, below 4. The README says 3.11 to 3.14 for the Workspace route. A virtual environment is advised
A provider keyOnly for some providers. FRED and EIA commands that call their APIs need a free one. Cboe, Deribit, FINRA, Nasdaq and SEC need none
uvFor the Claude Desktop route, which starts the server with uvx, and for an install from source, whose steps install uv with pip
A Workspace sign-inOnly to connect a server to OpenBB Workspace at pro.openbb.co
ODP DesktopOnly for the desktop app: Windows 11 or macOS 10.15 or newer, 8 GB of RAM, 2 GB or more of usable storage and an internet connection
  1. Make a virtual environment and activate it.
  2. Install the openbb package.
  3. Make a first call to a provider that needs no key.
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
pip install openbb

On Windows, activate with .venv\Scripts\activate.

How to use it

Import obb and call a command. Each provider’s commands sit under its own namespace, so the source is part of the path. This first call uses Cboe, which needs no key.

from openbb import obb

quote = obb.cboe.equity.quote(symbol="AAPL", provider="cboe")
quote.to_dataframe()

To serve the same commands over HTTP, install the launcher and start it. It listens on 127.0.0.1:6900 and moves to the next free port if that one is taken.

pip install openbb-platform-api openbb-cboe
openbb-api

Routes mirror the Python path, and keyword arguments become query parameters.

curl "http://127.0.0.1:6900/api/v1/cboe/equity/quote?symbol=AAPL&provider=cboe"

Example

You want Claude Desktop to answer a question about an Apple quote. With uv installed, you add this to its configuration and restart it.

{
  "mcpServers": {
    "openbb-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "openbb-mcp-server",
        "--with",
        "openbb-cboe",
        "--with",
        "openbb-imf",
        "openbb-mcp",
        "--transport",
        "stdio"
      ]
    }
  }
}

Ask for the Apple quote. The tool for it is cboe_equity_quote, which the docs name from the route /api/v1/cboe/equity/quote. The docs say each installed provider contributes its commands, so this setup serves the Cboe and IMF ones.

For newcomers and experts

If you are new. A provider is a connector to one data source, such as Cboe or the FRED economic database. OpenBB does not host or serve data. Provider packages are connectors to public or third-party services, which set their own coverage, rate limits and terms of use. Start with the Python route and a provider that needs no key, then add a key for FRED when you want economic series.

For experts. Any FastAPI router registered under the openbb_core_extension entry-point group becomes an extension. The REST API serves its routes, and the Python interface generates them as methods on obb after openbb-build or on the next import. openbb-mcp names each tool from its route path, so obb.cboe.equity.quote is cboe_equity_quote. On a large install, one flag hides the command tools behind four tools named available_categories, available_tools, search_tools and call_tool.

openbb-mcp --tool-discovery

The tool run_pipeline chains tools on the server, so a price history does not travel through the conversation. A .spec file from openbb --generate-spec lets openbb-api or openbb-mcp proxy a remote server with no provider packages installed.

Good to know

The kit’s notes follow the V5 documentation. The options below cover what can surprise you.

  • Version 5: V5 moved commands from shared routers such as obb.equity into provider namespaces such as obb.cboe, removed fifteen V4 provider packages, and changed the license from AGPL-3.0 to Apache-2.0. The README’s own example still uses the V4 call obb.equity.price.historical, and videos may show V4 commands
  • Data: OpenBB does not host or serve data. Provider packages connect to public or third-party services, whose terms may restrict storage, redistribution or commercial use. The license covers the software, not the data
  • Accuracy: the README says the data is not necessarily accurate, and that OpenBB and its data providers accept no liability for losses from trading or from relying on the data
  • Open by default: the REST API accepts every request and every origin until you set a Basic login and a CORS list. The MCP server’s install_skill tool writes files to the server’s disk for any connected client, so require server_auth when clients are not trusted
  • Desktop app: it installs Miniforge and environments, runs background tasks and shell scripts, and can start at login. Its Uninstall removes them with the app data. The docs say it is not meant for virtual machines or CI
  • OpenBB Workspace: a separate, commercial OpenBB app at pro.openbb.co that needs a sign-in. OpenBB’s site says its Community Edition is free for individuals. The same site says the non-profit OpenBQ is taking over OpenBB’s assets and that users of the hosted products will hear about timelines. These notes cover connecting your own server to it, not the app itself
  • Excel: the README names Excel beside Workspace for analysts. The kit has no Excel steps
  • Usage data: the README and the pages used here say nothing about it
  • Removal: the installation page says to add or remove providers with pip, and the providers page says to run openbb-build or restart the Python session after removing one. No page gives a command that removes everything. Uninstall what you installed with pip and delete the virtual environment. Settings and keys stay in ~/.openbb_platform/ (user_settings.json, mcp_settings.json), and openbb-sec keeps a disk cache in ~/OpenBBUserData/cache/sec (up to 8 GB by default), so delete those folders too
  • License: Apache-2.0. GitHub’s API lists the license as “Other”, but the LICENSE file gives the full Apache 2.0 text and reads “Copyright (c) 2021-2026 OpenBB Inc.” The license grants no rights to the OpenBB trademarks

README and files

README

OpenBB: setup notes

This kit holds setup notes only. Mindket wrote them. The platform installs from PyPI, or from the repository: https://github.com/openbq-org/OpenBB

These notes are not made or endorsed by OpenBB. The README says "Open Data Platform by OpenBB (ODP) is the open-source toolset that helps data engineers integrate proprietary, licensed, and public data sources into downstream applications like AI copilots and research dashboards." The documentation is at https://docs.openbb.co/odp

The README's own links and its clone command name OpenBB-finance/OpenBB, not openbq-org/OpenBB. These notes copy them as written.

License: Apache-2.0. The LICENSE file (https://github.com/openbq-org/OpenBB/blob/develop/LICENSE) opens with "Copyright (c) 2021-2026 OpenBB Inc." and "All files in this repository are licensed under the Apache License, Version 2.0.", then gives the standard text. The license FAQ (https://docs.openbb.co/odp/python/faqs/license) says V4 and earlier were AGPL-3.0-only, that V5 is Apache-2.0, that the license covers the software and not the data providers return, and that it grants no rights to the OpenBB trademarks.

The README's disclaimer says: "Trading in financial instruments involves high risks including the risk of losing some, or all, of your investment amount, and may not be suitable for all investors." It also says: "The data contained in the Open Data Platform is not necessarily accurate."

What installs

  • The openbb package from PyPI. The installation page (https://docs.openbb.co/odp/python/installation) says it holds no code of its own. It installs openbb-core, every provider package, openbb-news, openbb-charting with PyWry, openbb-cli, openbb-platform-api, openbb-mcp-server and openbb-devtools. It does not install openbb-econometrics, openbb-quantitative or openbb-technical.
  • Or openbb-core with only the provider packages you pick. Each provider package adds its own namespace on obb, such as obb.fred or obb.cboe. Source: https://docs.openbb.co/odp/python/installation
  • The openbb Python import package is generated from whatever is installed, on the first import or with openbb-build. Source: https://docs.openbb.co/odp/python/installation
  • OpenBB does not host or serve data. The providers page says provider packages connect to public or third-party services, whose coverage, rate limits and terms of use those services set. Source: https://docs.openbb.co/odp/python/extensions/providers

What you need first

  • Python. The installation page says every V5 package declares requires-python = ">=3.10,<4", and that you install into a virtual environment. The README says Python 3.11 to 3.14 for the Workspace route.
  • For some providers, an API key. The credentials page (https://docs.openbb.co/odp/python/user-guide/credentials) names five: bls_api_key, cftc_app_token, congress_gov_api_key, eia_api_key and fred_api_key. Providers such as cboe, deribit, finra, nasdaq and sec need no setup. A key you choose goes in your own settings file or environment, never in this kit.
  • For the desktop app, Windows 11 or macOS 10.15 or newer, 8 GB of RAM, 2 GB or more of usable storage and an internet connection. Source: https://docs.openbb.co/odp/desktop/installation
  • For OpenBB Workspace, a sign-in at https://pro.openbb.co

Main install command

Run it in an activated virtual environment.

pip install openbb

Source: the README, https://github.com/openbq-org/OpenBB/blob/develop/README.md, and https://docs.openbb.co/odp/python/installation

Per-platform notes

  • setup/python.md: install, first call, API keys, building, and installing from source
  • setup/cli.md: the openbb command
  • setup/desktop.md: ODP Desktop for Windows and macOS
  • setup/rest-api-and-workspace.md: the REST API and connecting it to OpenBB Workspace
  • setup/claude-desktop.md: the MCP server in Claude Desktop
  • setup/cursor.md: the MCP server in Cursor
  • setup/vs-code.md: the MCP server in VS Code and Cline
  • setup/other-agents.md: other MCP clients, tool discovery, skills and server login

V4 and V5

The documentation pages these notes use describe V5, which the installation page says is on the repository's default branch, develop. The documentation keeps V4 under a separate path. The migration page (https://docs.openbb.co/odp/python/migration-from-v4) lists what changed. One change shows in the README: its example calls obb.equity.price.historical, and the migration page maps the V4 call obb.equity.price.historical(..., provider="cboe") to obb.cboe.equity.historical(...) in V5. The shared routers such as openbb-equity are not part of the plain openbb install. Source: https://docs.openbb.co/odp/python/installation

Update or remove

The installation page says to add or remove providers later with pip, and that the Python interface picks up the change on the next import. It gives no upgrade or uninstall command for the whole platform. Use pip's own upgrade and uninstall on the packages you installed. If you have V4, the installation page says to install V5 into a new virtual environment instead of upgrading a V4 one.

Run this after installing or removing a package so the obb client is rebuilt. Source: https://docs.openbb.co/odp/python/extensions/providers

openbb-build

For ODP Desktop, the Uninstall page (https://docs.openbb.co/odp/desktop/uninstall) says to choose Uninstall from the tray icon menu. It removes Miniforge, the environments and all application data, and, if you agree, the OpenBBUserData and openbb_platform folders. On Windows, uninstall.exe or Control Panel removes only the interface.

Credentials and data

Keys live in ~/.openbb_platform/user_settings.json or in an environment variable named after the credential in upper case. The settings file wins when both hold a value. Source: https://docs.openbb.co/odp/python/user-guide/credentials

Usage data

The README and the documentation pages these notes use say nothing about usage data.

Sources

Files
README.md  7 KB
setup/claude-desktop.md  3 KB
setup/cli.md  4 KB
setup/cursor.md  2 KB
setup/desktop.md  4 KB
setup/other-agents.md  4 KB
setup/python.md  6 KB
setup/rest-api-and-workspace.md  6 KB
setup/vs-code.md  2 KB

9 files, 38 KB, downloaded as a zip.

What’s new

  • Version 2 · 2026-11-09

    Updated by Mindket to the current version of this kit.

  • Version 1 · 2026-11-03

Reviews

No ratings yet

Write a review

No reviews yet.

What people say

Posts and comments that name this project on Hacker News, Bluesky, X, Reddit, Facebook and YouTube, found by a weekly search and on Trendshift. Mindket doesn’t write or check them. Open one to read it where it was posted.

EUVD Bot🚨 EUVD-2026-109600 📊 5.3/10 🏢 openbq-org 📝 A flaw has been found in openbq-org OpenBB up to 4.7.2/5.0.0. This affects an unknown part of the file openbb_platform/core/openbb_core/app/model/api... 🔗 https://euvd.enisa.europa.eu/vulnerability/EUVD-2026-109600 #cybersecurity #infosec #cve #euvd@qklxsqf想用 AI 搭自己的交易研究台,这 8 个开源项目可以先存着。 查数据用 OpenBB,算财务和风险看 FinanceToolkit;想让多空观点互相挑毛病,可以看 TradingAgents。 策略验证这边,VectorBT 适合批量比较参数,LEAN、LumiBot 可以衔接回测和模拟交易。想进一步做模型研究看 Qlib,最后用 QuantStats 把收益、回撤这些账算清楚。 我觉得不用一次全装。先拿一个自己熟悉的策略,把数据、费用和模拟跑通,比堆一堆工具实在。 AI 几秒钟就能给你一个交易理由,但这个理由值不值得掏钱,后面还有不少活要干。 项目地址放评论区。@JinLiXZ$82@Doomsweep3000More 👇 last30days-skill (+809 ★) https://t.co/fT6OfB4QiT trader-skill (+479 ★) https://t.co/OPEjKWSjFF freqtrade (+341 ★) https://t.co/ltbAquwmxj@CandleCode7$83@balance0014对冲基金每年花几百万买数据终端和研究系统,这10个GitHub仓库加起来,能免费搭出一套完整的AI量化交易栈。 小白也能看懂每个是干啥的: 1OpenBB 免费金融数据平台。股票价格、期权、宏观数据、基本面都能一键拉取,给后面所有工具喂数据。 https://t.co/ROKAiVotbt 2TradingAgents AI版“交易公司”。分析师写报告、多空研究员辩论、交易员决策、风险团队最后签字,模拟真人团队做决定。 https://t.co/zwRptTySzf 3qlib 微软出品的AI量化研究平台。从想法探索到回测落地,用机器学习做量化研究的一整套工具。…@quantscience_Algorithmic trading is the domain of secretive Hedge Funds. Python unlocked these secrets for everyone (even Goldman Sachs has an open-source tool). Here are 17 Python libraries that open the hedge fund black box (📚bookmark this for later): https://t.co/N3vyDsmsPC@quantscience_OpenBB: A free alternative to the $20,000 Bloomberg Terminal Available 100% free on GitHub: https://t.co/XK13abc3jH@yang3izc彭博终端一年几万美元,这个开源项目直接平替。 OpenBB 把股票、期权、宏观、加密数据统一到一个接口,Python 里 pip install openbb 就能调,Excel 和 API 也通。 我本来以为开源数据都半残,结果上手比想象顺手。 仓库:https://t.co/GAqRFUFIzi https://t.co/n6c9wRr12y@bi_9527zx准备做Ai Agent自动交易的兄弟们一定要参考的免费开源软件: 加密货币交易机器人(主力) Freqtrade(约55k⭐):Python全功能Bot,回测+Hyperopt优化+FreqAI机器学习+Telegram/Web UI,支持多交易所(via CCXT)。目前最活跃、最完整的策略开发框架。 https://t.co/V9NOHBLuxl Hummingbot(约20k⭐):专注做市、跨所套利、资金费率套利,CEX+DEX覆盖广。 https://t.co/ELb07oWay4…@letmein77885 个开源仓库,拼出一张 AI 投研台:取数、分析师吵架、风控、回测、下单闸门全有,加起来约 25 万星。 按流水线排好了,照着顺序接就行: 1. 取数:OpenBB(7.4 万星)。一个 Python 接口接多家数据源,本来就是给分析师、量化和 agent 用的 2. 分析:TradingAgents(11.1 万星)。基本面、情绪、新闻、技术四个分析师并行出报告,多空两派研究员辩论,再交给交易员和风控团队拍板 3. 复核:ai-hedge-fund(6.4 万星)。一群「投资人人格」agent 加一个风险经理,本身不真下单,新版加了模拟盘和一键停机 4. 回测:bt(3 千星)。用…@quantscience_OpenBB: A free alternative to the $20,000 Bloomberg Terminal Available 100% free on GitHub: https://t.co/Q1z9pEY12H

Searched

More from Mindket

See all from Mindket

Huashu Design

alchaincyf · Skill

Turns a one-line request in your AI agent into a finished design: a launch animation, a clickable app prototype, an editable slide deck, an infographic or a se…

New29.4k

Guizang PPT Skill

op7418 · Skill

Skill that makes single-file HTML slide decks, slide illustrations and platform covers in two visual styles, with a presenter mode for rehearsal. For speakers…

New29.8k

Claude Code Skills & Plugins

alirezarezvani · Skill

Adds 411 ready-made skills for Claude Code and other coding agents, grouped by role from engineering and product to marketing, finance and compliance. Installs…

New29.8k

Scrapling

D4Vinci · Kit

This Python web scraping framework combines fast HTTP requests, browser automation, and data parsing into one library. It includes an MCP server for AI agents…

New99.9k

Crawl4AI

unclecode · Kit

UncleCode’s open source web crawler and scraper for language models and AI agents. It loads a page in a browser and returns clean Markdown, or JSON in a shape…

New87k

Rohit Ghumare’s free, MIT-licensed course that builds AI from raw math up to agents and production, in twenty phases. Tutor skills for Claude Code, Codex and C…

New77.8k