Installation

From PyPI (recommended)

pippipx (isolated CLI)uvx (run without installing)

pip install vodoo

pipx install vodoo

uvx vodoo helpdesk list

From Source

This project uses uv for dependency management.

# Clone the repository
git clone https://github.com/julian-r/vodoo.git
cd vodoo

# Install dependencies
uv sync

# Install in development mode with dev dependencies
uv sync --all-extras

# Install the CLI tool
uv pip install -e .

Verify Installation

vodoo --help

You should see the list of available subcommands: helpdesk, project-task, project, crm, knowledge, timer, model, security.

Requirements

• Python 3.12+
• Access to an Odoo instance (17–19) with JSON-RPC or JSON-2 API enabled
• Valid Odoo credentials (username/password or API key)

Optional Dependencies

Install extra dependency groups for development or documentation:

# Development tools (ruff, mypy, pytest)
pip install vodoo[dev]

# Documentation (mkdocs-material)
pip install vodoo[docs]