---
id: setuptools-odoo
version: "3.3.2"
license: LGPLv3
license_treatment: copyleft
maintenance: active
---

# setuptools-odoo — A library to help package Odoo addons with setuptools

License: copyleft · Maintenance: active · Downloads: 131.1K/mo

## 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 above — 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

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

- License: LGPLv3 (copyleft)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 131.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

odoo addon packaging, setuptools odoo integration, odoo manifest to setup.py, package odoo addons pip, odoo addon distribution, setuptools odoo framework, odoo addon wheel build, odoo-framework, packaging-automation

[View on SkillFed](https://skillfed.io/packages/setuptools-odoo) · [View on PyPI](https://pypi.org/project/setuptools-odoo/)