4.4.5

OpenBB-finance/OpenBB4.4.5Jul 22, 2025by github-actions[bot]

AI Summary

This release adds the Fama-French data library and MCP Server extensions, enhances shipping data coverage via IMF Port Watch, and disables the logging service by default. It also deprecates Python 3.9 and moves specific economy endpoints to a new shipping router.

Key Highlights

  • New Fama-French data library extension
  • Implementation of MCP Server (FastMCP)
  • IMF Port Watch data integration
  • New derivatives options surface endpoint
  • Standalone openbb-nasdaq app for SEC filings

Breaking Changes

  • Logging service disabled by default
  • `obb.economy.port_volume` moved to `obb.economy.shipping.port_volume`
  • Deprecation warning for Python 3.9

New Features

  • New Fama-French provider and router extension
  • New shipping endpoints (chokepoint_info, port_info, etc.)
  • New derivatives options surface POST endpoint
  • Support for environment variables for API keys
  • openbb-nasdaq Workspace app for PDF filings

Full Release Notes

## Thank you and welcome to our new contributors 🔥
@MagnusS0

## Summary 🎉

The release of 4.4.5 includes new extensions, endpoints, and functionality; security and package updates; along with general bug fixes.

## 🚨 OpenBB Platform Breaking Changes

- This version introduces a deprecation warning for Python 3.9 - support for this version will be dropped later this year.
- File logging service is now disabled by default, the logging module is no longer initialized on startup.
  - Set `"logging_suppress": false`, in  `system_settings.json`, to enable.
- The endpoint, `obb.economy.port_volume`, is now deprecated and moved to: `obb.economy.shipping.port_volume`

## 🚨 Dependency Changes

- `openbb-charting` has been updated to use Plotly V6
- `pytest-recorder` now has a `record_curl` marker for capturing unit test cassettes for HTTP requests via [curl-adapter](https://pypi.org/project/curl-adapter/)
- Code for Posthog has been completely removed from `openbb-core`, dependency was removed.
- Requests library has been bumped to the latest, addressing security vulnerabilities.
- Ruff has been bumped to the latest.

## 🆕 New Extensions

- `openbb-famafrench` - Implementation of the [Ken French Data Library](https://mba.tuck.dartmouth.edu/pages/faculty/ken.french/data_library.html)
  - Combined Provider and Router extension
  - Adds route, `obb.famafrench`, with endpoints:
    -  breakpoints
     - country_portfolio_returns
     - factor_choices  <-- Utility function serving choices to the OpenBB Workspace widget
     - factors
     - international_index_returns
     - regional_portfolio_returns
     - us_portfolio_returns

- `openbb-mcp-server` - Implementation of [FastMCP](https://pypi.org/project/fastmcp/)
  - Wraps the OpenBB API endpoints as MCP tools.
  - Launch with the default config, `openbb-mcp`
  - See [README](https://pypi.org/project/openbb-mcp-server/) for details.

## 🆕 New Endpoints

`openbb-imf` has been expanded to include data from [Port Watch](https://portwatch.imf.org/pages/port-monitor)

- A `shipping` route to the `obb.economy` router, includes 4 endpoints:

  - obb.economy.shipping.chokepoint_info (chart)
  - obb.economy.shipping.chokepoint_volume
  - obb.economy.shipping.port_info (chart)
  - obb.economy.shipping.port_volume

- A POST endpoint has been added to the `obb.derivatives.options` router:
  - obb.derivatives.options.surface
    - POST the `chains` data response object to the endpoint and return a table suitable for constructing 3-D surface charts.
    - Optionally, return a chart (requires `openbb-charting`)
    - Import the chart function directly: `from openbb_charting.charts.generic_charts import surface3d`


## 🆕 New OpenBB Workspace App

- `openbb-nasdaq` now has a standalone application for OpenBB Workspace, with a focus on SEC filing documents - formatted as PDF.
  - Start with: `openbb-api --app openbb_nasdaq.app:main --factory`

## 🦋 OpenBB Platform Enhancements

- API keys and credentials can now be defined as environment variables.
  - Use the UPPER_CASE equivalent to the provider's credential.
- Enhancements to the `openbb-api` backend launcher. See the [README](https://pypi.org/project/openbb-platform-api/)

##  🚀 Pull Requests

* [Feature] IMF Port Watch in https://github.com/OpenBB-finance/OpenBB/pull/7134
* [Feature] Add Workspace App To openbb-nasdaq For Company Filings As PDFs in https://github.com/OpenBB-finance/OpenBB/pull/7135
* [BugFix] Fix TMX Request Timeout Configuration in https://github.com/OpenBB-finance/OpenBB/pull/7142
* [BugFix] Update `openbb-yfinance` tests to use new pytest curl adapter extension by @deeleeramone in https://github.com/OpenBB-finance/OpenBB/pull/7151
* [BugFix] `openbb-build` Catch CalledProcessError and improve error handling. by @deeleeramone in https://github.com/OpenBB-finance/OpenBB/pull/7150
* [Feature] Update FOMC Documents Workspace App by @deeleeramone in https://github.com/OpenBB-finance/OpenBB/pull/7153
* [BugFix] Fix Failing Yield Curve Chart by @deeleeramone in https://github.com/OpenBB-finance/OpenBB/pull/7154
* [Feature] Disable LoggingService by Default by @deeleeramone in https://github.com/OpenBB-finance/OpenBB/pull/7157
* [Feature] Add `mcp_server` to `openbb_core` api by @MagnusS0 in https://github.com/OpenBB-finance/OpenBB/pull/7094
* [Feature] Add Omni Widget Input and Response Models to `openbb-platform-api`. by @deeleeramone in https://github.com/OpenBB-finance/OpenBB/pull/7155
* [Feature] Add Credentials From Environment If Provided by @deeleeramone in https://github.com/OpenBB-finance/OpenBB/pull/7159
* [BugFix] Nasdaq Company Filings Workspace App: Fix Multi-File Viewer Deprecation Warning by @deeleeramone in https://github.com/OpenBB-finance/OpenBB/pull/7152
* [Feature] Future Warning For Discontinued Support For Python 3.9 by @deeleeramone in https://github.com/OpenBB-finance/OpenBB/pull/7158
* [BugFix] Fix `obb.quantitative.capm`: Name in `zipfile.open` is Case-Sensitive by @deeleeramone in https://github.com/OpenBB-finance/OpenBB/pull/7161
* [BugFix] Cleanup Test Imports by @deeleeramone in https://github.com/OpenBB-finance/OpenBB/pull/7162
* [BugFix] `openbb-charting`: Fix Margin In Serialized Chart Output by @deeleeramone in https://github.com/OpenBB-finance/OpenBB/pull/7164
* [Feature] Bump Ruff To 0.12 by @deeleeramone in https://github.com/OpenBB-finance/OpenBB/pull/7165
* [Feature] Add Volatility Surface POST processing and Chart by @deeleeramone in https://github.com/OpenBB-finance/OpenBB/pull/7143
* [BugFix] MCP - expose correct header for session id by @MagnusS0 in https://github.com/OpenBB-finance/OpenBB/pull/7160
* [Feature] Add Fama-French Data Library by @deeleeramone in https://github.com/OpenBB-finance/OpenBB/pull/7163
* [Feature] Add PLC0415 To Ruff Ignore by @deeleeramone in https://github.com/OpenBB-finance/OpenBB/pull/7166
* [BugFix] `obb.famafrench.breakpoints` - Fix Bad Widget Param Options by @deeleeramone in https://github.com/OpenBB-finance/OpenBB/pull/7168
* [BugFix] Fix`SecForm13FHRFetcher`: TypeError: Expected numeric dtype, got object instead. by @deeleeramone in https://github.com/OpenBB-finance/OpenBB/pull/7171

**Full Changelog**: https://github.com/OpenBB-finance/OpenBB/compare/4.4.4...4.4.5


We are proud of our community contributors and staunch supporters of open-source ecosystems.
Help us promote our community by tagging `@openbb_finance` on X with a link to your pull request,
and join our Discord server to chat about your contribution! We want to hear about your experience!

### Links 🦋
[Website](https://openbb.co/), [Twitter](https://twitter.com/openbb_finance), [Linkedin](https://www.linkedin.com/company/openbb-finance), [Instagram](https://www.instagram.com/openbb.finance/), [Reddit](https://www.reddit.com/r/openbb/), [Discord](https://discord.com/invite/xPHTuHCmuV)