setuptools-odoo

What it is and what it does

Setuptools-odoo is a setuptools plugin that bridges Odoo addon development and Python packaging infrastructure. It reads Odoo manifest files (__manifest__.py or __openerp__.py) and automatically populates setup.py keywords—name, version, description, dependencies, and more—eliminating manual boilerplate. This allows developers to package and distribute Odoo addons using standard Python tools (pip, wheel, PyPI) rather than Odoo's native mechanisms.

The package supports both single-addon and multi-addon project layouts across Odoo versions 8 through 16, with version-specific namespace handling (odoo.addons for Odoo 10+, odoo_addons for Odoo 8–9). It automatically resolves dependencies on Odoo itself and other addons, excluding official Community and Enterprise addons which are satisfied by the Odoo distribution. However, the project is now deprecated; maintainers recommend whool for individual addons and hatch-odoo for complete projects.

Use it for:

• Package a single Odoo addon for distribution on PyPI so other developers can install it via pip.
• Build wheels for Odoo addons to speed up deployment in production environments.
• Manage multi-addon projects for a specific customer where addons are not intended for external reuse.
• Automate dependency resolution between Odoo addons and external Python libraries during packaging.
• Integrate Odoo addon packaging into CI/CD pipelines using standard Python build tools.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Setuptools-odoo automates packaging of Odoo addons by extracting metadata from Odoo manifest files and populating standard setuptools keywords, enabling distribution via pip and PyPI.

Yes, if you are actively maintaining Odoo addons for versions 8–16 and need to package them for distribution. Install friction is low and maintenance is active. However, be aware the project is deprecated: for new projects, evaluate whool (single addons) or hatch-odoo (complete projects) first. The LGPLv3 copyleft license requires you to license derivative works the same way.

Install

setuptools-odoo on PyPI

pip install setuptools-odoo

uv add setuptools-odoo

poetry add setuptools-odoo

Installing setuptools-odoo

Before you install

Low install friction with just two runtime dependencies (setuptools and setuptools_scm). Active maintenance with a recent release; last commit was 2026-08-10. However, the project is progressively being deprecated in favor of whool and hatch-odoo.

License in practice

Licensed under LGPLv3 (copyleft). Derivative works and distributions must preserve the same license terms and provide source code access.

Quickstart

# In your Odoo addon's setup.py:
import setuptools
setuptools.setup(
    setup_requires=['setuptools-odoo'],
    odoo_addon=True,
)
# Then: pip install -e .

Requires Odoo 8–16 to be installed in your environment. For Odoo 8–10, odoo-autodiscover must also be installed. Project structure must follow Odoo conventions (odoo/addons/<addon_name>/__manifest__.py for Odoo ≥11, or odoo_addons/<addon_name>/__openerp__.py for Odoo 8–9).

Verify before relying

• Whether the deprecation in favor of whool and hatch-odoo affects ongoing support or bug fixes.
• Compatibility details with Odoo versions 8–16 and any known limitations per version.

Package facts

Evidence: setuptools_odoo-3.3.2-py2.py3-none-any.whl

Tags

More Build Tools packages