OpenBB Extensions Cookiecutter

A Cookiecutter template that generates a new OpenBB Platform extension as an installable Python project.

Extension types

Choose one or more types, or all:

The generated project follows the same conventions as the extensions in this repository: hatchling packaging, entry points in [project.entry-points], a dev dependency group, ruff and ty configuration in pyproject.toml, and tests for every generated module.

Usage

Run it with uv without installing:

uvx openbb-cookiecutter

Or install it and run the command:

pip install openbb-cookiecutter
openbb-cookiecutter

Enter a value at each prompt or press enter to accept the default. Pass the types directly to skip that prompt:

openbb-cookiecutter -e router provider

Generate without prompts, into another directory:

openbb-cookiecutter --no-input -o ./extensions -e all

Override any template value with --extra-context KEY=VALUE, for example --extra-context provider_name=my_source.

The provider and the OBBject extension each register a credentials namespace under their name, so they need different names.

Working on the generated project

The generated README.md covers setup. In short, from the project directory:

uv sync
uv run openbb-build
uv run pytest

Developing the template

From this directory:

uv sync
uv run pytest

The tests generate a project for each extension type and check its files, its entry points, and that it passes ruff and ty.

Contacts

Questions about the template or OpenBB: support@openbb.co. Partnerships: hello@openbb.co. Social links: openbb.co/links.