OpenBB/website/content/platform/development/developer-guidelines/build_openbb_extensions.md

title, sidebar_position, description, keywords

title	sidebar_position	description	keywords
Building Extensions for OpenBB Platform	2	This guide provides a comprehensive walkthrough on how to create custom extensions for the OpenBB Platform. It covers the process from generating the extension structure to sharing it with the community.	OpenBB Platform Custom extension Python development Data integration Community contribution

import HeadTitle from '@site/src/components/General/HeadTitle.tsx';

We have a Cookiecutter template that will help you get started. It serves as a jumpstart for your extension development, so you can focus on the data and not on the boilerplate.

Please refer to the Cookiecutter template and follow the instructions there.

This document will walk you through the steps of adding a new extension to the OpenBB Platform.

The high level steps are:

• Generate the extension structure
• Install your dependencies
• Install your new package
• Use your extension (either from Python or the API interface)
• QA your extension
• Share your extension with the community

Best Practices

1. Review Platform Dependencies: Before adding any dependency, ensure it aligns with the Platform's existing dependencies.
2. Use Loose Versioning: If possible, specify a range to maintain compatibility. E.g., >=1.4,<1.5.
3. Testing: Test your extension with the Platform's core to avoid conflicts. Both unit and integration tests are recommended.
4. Document Dependencies: Use pyproject.toml and poetry.lock for clear, up-to-date records.