Odoo Module Automation

An AI-powered extension for the GSD (Get Shit Done) framework that automates Odoo 17.0 and 18.0 module development end-to-end. Describe a business need in natural language, and the system produces OCA-grade Odoo modules — complete with models, views, security, tests, and i18n.

How It Works

You: "I need a module to track employee training courses and sessions"
                    |
        +-----------v-----------+
        |  Semantic Search OCA  |  Search 200+ OCA repos for similar modules
        +-----------+-----------+
                    |
          Match found?  No match?
              |              |
     Fork & Extend     Build from Scratch
              |              |
        +-----v--------------v-----+
        |   8 Specialized Agents   |  Model, View, Security, Test, i18n...
        +-----+--------------------+
              |
        +-----v--------------------+
        |   Jinja2 Template Engine |  24 templates (17.0 / 18.0 / shared)
        +-----+--------------------+
              |
        +-----v--------------------+
        |   Validation Pipeline    |  pylint-odoo + Docker install + test
        +-----+--------------------+
              |
        +-----v--------------------+
        |   Auto-Fix Loops         |  Fix imports, add mail.thread, etc.
        +--------------------------+
              |
           Module

Features

Natural Language to Module — Describe what you need; the system asks follow-up questions, generates a structured spec, and produces a complete Odoo module
Semantic Search — ChromaDB-powered vector search across 200+ OCA repositories to find and fork existing modules
8 Specialized AI Agents — Model generation, view generation, security patterns, test generation, validation, search, scaffolding, fork-and-extend
24 Jinja2 Templates — Version-aware templates for Odoo 17.0 and 18.0 with shared fallback
Validation Pipeline — pylint-odoo linting + Docker-based Odoo installation + test execution
Auto-Fix — Automatically fixes pylint violations, missing mail.thread inheritance, unused imports (AST-based), XML parse errors, missing ACLs, manifest load order — with configurable 5-iteration caps
Knowledge Base — 13 domain files with 80+ WRONG/CORRECT example pairs preventing AI hallucinations
Context7 Integration — Live Odoo documentation queries via Context7 REST API with graceful fallback
Artifact State Tracking — Generation pipeline observability with JSON sidecar persistence and CLI display
MCP Server — 6 tools for live Odoo introspection (list_models, get_model_fields, check_module_dependency, etc.)
Human Review — 3 checkpoint-based review gates before code generation
Edition Support — Community and Enterprise, Odoo 17.0 (primary) and 18.0

Prerequisites

GSD installed at ~/.claude/get-shit-done/
uv — Python package manager
Python 3.12 (Odoo 17 requires 3.10-3.12; 3.13+ breaks validation)
Docker + Docker Compose v2 (for module validation and dev instance)
GitHub Token (optional, for OCA search: export GITHUB_TOKEN=...)
An AI coding assistant: Claude Code, Gemini, Codex, or OpenCode

Installation

# Clone the repository
git clone [email protected]:Inshal5Rauf1/Odoo-Development-Automation.git ~/.claude/odoo-gen

# Run the installer
cd ~/.claude/odoo-gen
bash install.sh

The installer:

Verifies GSD is installed and Python 3.12 is available
Creates a Python virtual environment with uv
Installs the odoo-gen-utils package (editable)
Registers 13 commands as /odoo-gen:* in your AI assistant
Symlinks 8 agent definitions
Installs the knowledge base
Writes an installation manifest at ~/.claude/odoo-gen-manifest.json

Quick Start

All commands are invoked through your AI coding assistant using the /odoo-gen: prefix.

Create a New Module

/odoo-gen:new
> "I need a module to manage employee training courses with sessions,
>  attendance tracking, and completion certificates"

The system will:

Ask Odoo-specific follow-up questions (dependencies, field types, etc.)
Parse your input into a structured JSON specification
Present the spec for your review (checkpoint 1)
Search OCA for similar modules
Generate the complete module (checkpoint 2)
Validate with pylint-odoo and Docker (checkpoint 3)

Validate an Existing Module

/odoo-gen:validate my_module --auto-fix

Runs the full validation pipeline:

pylint-odoo linting (with auto-fix for common violations)
Docker installation test (Odoo 17.0 + PostgreSQL 16)
Docker test execution
Auto-fix for structural issues (missing mail.thread, unused imports)

Search for Existing Modules

/odoo-gen:search "inventory barcode scanning"

Semantic search across 200+ OCA repositories using ChromaDB vector embeddings.

Fork and Extend a Module

/odoo-gen:extend OCA/stock-logistics-workflow

Clones an OCA module and sets up a companion _ext module for customization.

Commands

Command	Description
`/odoo-gen:new`	Scaffold a new module from natural language
`/odoo-gen:validate`	Run pylint-odoo + Docker validation
`/odoo-gen:search`	Semantic search OCA for similar modules
`/odoo-gen:extend`	Fork and extend an existing module
`/odoo-gen:plan`	Plan module architecture before generation
`/odoo-gen:research`	Research Odoo patterns and solutions
`/odoo-gen:index`	Build/update ChromaDB index of OCA modules
`/odoo-gen:phases`	Show generation phases and progress
`/odoo-gen:status`	Show current module generation status
`/odoo-gen:resume`	Resume interrupted module generation
`/odoo-gen:config`	View/edit Odoo-specific settings
`/odoo-gen:history`	Show generation history
`/odoo-gen:help`	Show available commands and usage

Observability Commands

Command	Description
`odoo-gen-utils show-state ./module`	Show artifact generation state with status icons
`odoo-gen-utils context7-status`	Check Context7 API configuration and Odoo library resolution

Architecture

Layer 1: GSD Orchestration (INHERITED)
  Context management, state persistence, hallucination prevention,
  phase/wave execution, checkpoint-based human review, Git integration

Layer 2: Odoo Extension (THIS PROJECT)
  8 specialized agents, 13 commands, Jinja2 templates,
  knowledge base, workflows

Layer 3: Python Utilities (odoo-gen-utils)
  Jinja2 rendering engine, pylint-odoo integration,
  Docker validation, ChromaDB search, auto-fix pipeline

Layer 4: AI Coding Assistant (USER'S ENVIRONMENT)
  Claude Code, Gemini, Codex, OpenCode — GSD + odoo-gen installed

Project Structure

odoo-gen/
├── install.sh              # 10-step installer
├── defaults.json           # Default config (Odoo 17.0, Community, LGPL-3)
├── agents/                 # 8 AI agent definitions
│   ├── odoo-scaffold.md
│   ├── odoo-model-gen.md
│   ├── odoo-view-gen.md
│   ├── odoo-test-gen.md
│   ├── odoo-security-gen.md
│   ├── odoo-validator.md
│   ├── odoo-search.md
│   └── odoo-extend.md
├── commands/               # 13 GSD command definitions
├── knowledge/              # Odoo domain knowledge base
│   ├── MASTER.md           # Integration guide
│   ├── models.md           # ORM models, fields, computed
│   ├── views.md            # Forms, trees, kanban, search
│   ├── security.md         # ACLs, record rules, groups
│   ├── manifest.md         # __manifest__.py structure
│   ├── inheritance.md      # Model/view inheritance
│   ├── testing.md          # Test structure, assertions
│   ├── i18n.md             # Translation strings
│   ├── wizards.md          # Transient models
│   ├── controllers.md      # HTTP controllers
│   ├── actions.md          # Action windows
│   ├── data.md             # XML/CSV data files
│   └── custom/             # User-extensible knowledge
├── templates/              # Jinja2 templates
│   ├── 17.0/               # Odoo 17 specific
│   ├── 18.0/               # Odoo 18 specific
│   └── shared/             # Common (fallback)
├── workflows/              # GSD workflow configs
├── docker/                 # Docker Compose (Odoo 17 + PostgreSQL 16)
│   └── docker-compose.yml
└── python/                 # Python package
    ├── pyproject.toml
    ├── src/odoo_gen_utils/
    │   ├── cli.py          # Click CLI entry point
    │   ├── renderer.py     # Jinja2 rendering engine
    │   ├── auto_fix.py     # pylint + Docker fix loops
    │   ├── i18n_extractor.py
    │   ├── edition.py
    │   ├── kb_validator.py
    │   ├── search/         # ChromaDB, GitHub, fork
    │   └── validation/     # Docker, pylint, reports
    └── tests/              # 444 tests (pytest)

Python Utilities (odoo-gen-utils)

The odoo-gen-utils CLI provides the underlying Python tooling:

# Render a single template
odoo-gen-utils render --template model.py.j2 --var name=hr_training

# List available templates
odoo-gen-utils list-templates --version 17.0

# Validate a module
odoo-gen-utils validate /path/to/module --auto-fix

# Build search index
odoo-gen-utils build-index

# Search modules
odoo-gen-utils search-modules "inventory management"

# Extract translations
odoo-gen-utils extract-i18n /path/to/module

Testing

cd python/

# Run all unit tests (494 tests, ~3s)
uv run pytest tests/ -v

# Skip Docker tests (when Docker unavailable)
uv run pytest tests/ -m "not docker" -v

# Skip E2E tests (require GitHub token)
uv run pytest tests/ -m "not e2e" -v

# Run with coverage
uv run pytest tests/ --cov=odoo_gen_utils --cov-report=html

# Run golden path E2E (render + Docker install + test)
uv run pytest tests/test_golden_path.py -v

Test markers:

@pytest.mark.e2e — Requires GITHUB_TOKEN environment variable
@pytest.mark.e2e_slow — Full OCA index build (200+ repos, 3-5 min)
@pytest.mark.docker — Requires Docker daemon running

Dev Instance

A persistent Odoo 17 CE development instance is available for local development and MCP server integration. It runs separately from the ephemeral validation Docker setup.

Prerequisites

Docker and Docker Compose v2 (docker compose subcommand, not standalone docker-compose) are required. See Docker installation docs.

Quick Start

# Start the Odoo 17 CE dev instance
scripts/odoo-dev.sh start

# Stop the instance (data is preserved)
scripts/odoo-dev.sh stop

# View logs
scripts/odoo-dev.sh logs

# Check status and XML-RPC connectivity
scripts/odoo-dev.sh status

# Reset (destroys all data)
scripts/odoo-dev.sh reset

Access

Property	Value
URL	`http://localhost:8069`
Database	`odoo_dev`
Username	`admin`
Password	`admin`

The port is configurable via the ODOO_DEV_PORT environment variable.

Verify Connectivity

Run the XML-RPC smoke test to verify the instance is running and accessible:

scripts/verify-odoo-dev.py

This performs XML-RPC authentication against the dev instance and checks that all required modules are installed.

Pre-installed Modules

The following modules are automatically installed on first start:

base -- Core framework
mail -- Messaging and activity tracking
sale -- Sales management
purchase -- Purchase management
hr -- Human resources
account -- Accounting and invoicing

Configuration

Default settings in defaults.json:

{
  "odoo": {
    "odoo_version": "17.0",
    "edition": "community",
    "license": "LGPL-3",
    "output_dir": "."
  }
}

Override via /odoo-gen:config or environment variables:

GITHUB_TOKEN — GitHub API access for OCA search
ODOO_VERSION — Target Odoo version (17.0 or 18.0)
CONTEXT7_API_KEY — Context7 API key for live Odoo documentation queries (optional)

Knowledge Base

The knowledge base contains 13 domain files covering Odoo development patterns. Each file uses WRONG/CORRECT example pairs to guide AI agents:

## WRONG
fields.Char('Name')  # Positional string deprecated in Odoo 17

## CORRECT
fields.Char(string='Name')  # Named parameter required

Extend the knowledge base by adding files to knowledge/custom/. These are automatically included in agent context.

Milestones

Version	Name	Phases	Status
v1.0	MVP	1-9	Shipped 2026-03-03
v1.1	Tech Debt Cleanup	10-11	Shipped 2026-03-03
v1.2	Template Quality	12-14	Shipped 2026-03-04
v2.0	Environment-Aware Generation	15-17	Shipped 2026-03-04
v2.1	Auto-Fix & Enhancements	18-19	Shipped 2026-03-04
v3.0	Bug Fixes & Tech Debt	20-25	Shipped 2026-03-05

Stats: 25 phases, 56 plans, 325+ commits, 18,400 LOC Python, 494 tests

License

LGPL-3.0

Contributing

See CONTRIBUTING.md for development setup, coding standards, and contribution guidelines.

Navigation Menu

Repository files navigation

Odoo Module Automation

How It Works

Features

Prerequisites

Installation

Quick Start

Create a New Module

Validate an Existing Module

Search for Existing Modules

Fork and Extend a Module

Commands

Observability Commands

Architecture

Project Structure

Python Utilities (odoo-gen-utils)

Testing

Dev Instance

Prerequisites

Quick Start

Access

Verify Connectivity

Pre-installed Modules

Configuration

Knowledge Base

Milestones

License

Contributing

About

Releases

Packages

Contributors

Languages

Name		Name	Last commit message	Last commit date
Latest commit History 431 Commits
agents		agents
commands		commands
docker		docker
knowledge		knowledge
python		python
scripts		scripts
workflows		workflows
.gitignore		.gitignore
CLAUDE.md		CLAUDE.md
CONTRIBUTING.md		CONTRIBUTING.md
README.md		README.md
VERSION		VERSION
agentic-odoo-CLAUDE.md		agentic-odoo-CLAUDE.md
defaults.json		defaults.json
install.sh		install.sh

Folders and files

Latest commit

History

Repository files navigation

Odoo Module Automation

How It Works

Features

Prerequisites

Installation

Quick Start

Create a New Module

Validate an Existing Module

Search for Existing Modules

Fork and Extend a Module

Commands

Observability Commands

Architecture

Project Structure

Python Utilities (odoo-gen-utils)

Testing

Dev Instance

Prerequisites

Quick Start

Access

Verify Connectivity

Pre-installed Modules

Configuration

Knowledge Base

Milestones

License

Contributing

About

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages