Skip to Content

Foundation

by ,
Odoo
v 19.0 Third Party 12
Download for v 19.0 Deploy on Odoo.sh
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies Discuss (mail)
Community Apps Dependencies
Lines of code 3809
Technical Name foundation
LicenseOPL-1
Websitehttps://praetorx.net
You bought this module and need support? Click here!
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies Discuss (mail)
Community Apps Dependencies
Lines of code 3809
Technical Name foundation
LicenseOPL-1
Websitehttps://praetorx.net

Foundation

AI Provider Hub — OpenAI, Claude, Azure with Encryption & Health Monitoring for Odoo 19

v19.0.1.4.0 Community Enterprise Odoo.sh Multi-Provider AI Free

Central AI provider management for Odoo. Configure OpenAI, Anthropic Claude, Azure, or local models in one place. Encrypted API keys, health monitoring, rate limiting, cost tracking, GDPR compliance flags, and automatic fallback — used by Invoice Pro, Vault, and other PraetorX modules.

praetorx.net | Syntax & Sabotage

AI Provider Management

4 Provider Types

OpenAI (GPT-4o, GPT-4o Mini), Anthropic (Claude Sonnet, Opus, Haiku), Azure OpenAI, and local models (Ollama, Llama, Mistral). 12 pre-configured model options.

Encrypted API Keys

API keys are encrypted at rest using Fernet + PBKDF2 (via Python cryptography). Keys are never stored in plain text. Only system administrators can view key fields.

Health Monitoring

Per-provider health status (healthy / degraded / unhealthy), connection testing, response time tracking, and last-error logging. One-click health check button.

Default + Fallback

Designate a default provider and a fallback. get_best_provider() selects by capabilities, health, and GDPR requirements. Automatic failover when the primary is down.

Rate Limiting & Cost Tracking

Per-provider rate limits (req/min), daily quotas, and usage counters. Cost per 1K tokens and total cost tracking. Usage resets automatically.

GDPR Compliance Flags

Data region selection (US / EU / Local), zero-retention confirmation toggle. GDPR compliance auto-computed from region + retention settings. get_gdpr_compliant_provider() shortcut.

Developer Patterns

AI Provider Mixin

Inherit foundation.ai.provider.mixin in your model to add an ai_provider_id field and _get_ai_service() method. One line to connect any model to AI.

Failure Activity Mixin

Inherit foundation.failure.activity.mixin to surface errors as mail.activity records. Auto-deduplication: identical failures don’t create duplicate activities. _resolve_failure_activity() clears on success.

Wizard Framework

Inherit foundation.wizard.base for multi-step wizards with progress indicators, step validation hooks, back/next navigation, and Foundation-branded SCSS styling (light + dark mode).

Capability Detection

Per-provider capability flags: OCR, vision, structured output, function calling. Auto-set when selecting a model. get_best_provider() filters by required capabilities.

Technical Reference

ComponentDetails
foundation.ai.provider47 fields — provider config, auth (encrypted), model params, capabilities (4), rate limits, cost tracking, health monitoring, GDPR compliance, statistics. 24 methods.
foundation.ai.provider.mixinAbstract — adds ai_provider_id M2O + _get_ai_service() to any model.
foundation.failure.activity.mixinAbstract — _create_failure_activity() with deduplication, _resolve_failure_activity() for auto-resolution. Works on any mail.thread model.
foundation.wizard.baseAbstract — multi-step wizard with progress, navigation, validation hooks, completion logic. 2-step and 3-step QWeb templates included.
EncryptionFernet + PBKDF2 via Python cryptography. Keys encrypted on create/write, decrypted only when used.
Demo Data3 inactive provider records (OpenAI GPT-4o Mini, Anthropic Claude Sonnet, Local Ollama) for quick setup.

Use Cases

Invoice Processing

Invoice Pro uses Foundation to route OCR requests to the best available vision-capable provider. If OpenAI is down, it falls back to Claude automatically.

Document Classification

Vault uses Foundation to classify incoming documents. GDPR mode ensures EU documents are processed by EU-region or local providers only.

Self-Hosted AI

Run Ollama locally and configure it as a Foundation provider. No API keys needed, no data leaves your network. Full air-gap support.

Cost Control

Track cost per 1K tokens and total spend per provider. Set daily quotas to prevent runaway API costs. Usage counters reset automatically.

Screenshots

AI Provider Dashboard

All configured providers at a glance — type, model, data region, connection status, health, request counts, success rate, and fallback chain.

PraetorX Foundation — AI Provider List
Capability Auto-Detection

Capabilities are automatically detected from the selected model — OCR processing, vision analysis, structured output, and function calling. Manual override available.

PraetorX Foundation — Capability Detection
Provider Configuration

Each provider has its own authentication and model parameter settings — API key, endpoint, temperature, top-p, and token limits.

PraetorX Foundation — OpenAI Provider Configuration
GDPR Compliance

Data residency and compliance tab per provider — configure EU region, data retention, and get step-by-step setup instructions for compliant deployments.

PraetorX Foundation — GDPR Data Compliance

Setup Guide

  • Odoo 19.0 (Community or Enterprise)
  • Python 3.10+
  • Python packages: pip install cryptography requests
  • Odoo modules: base, mail

No Enterprise dependency. Works on Community, Enterprise, and Odoo.sh.

  1. Install Python packages: pip install cryptography requests
  2. Install from the Odoo Apps menu — search for “Foundation”

Foundation is typically installed automatically as a dependency of Invoice Pro, Vault, or other PraetorX AI modules.

  1. Navigate to Foundation → Configuration → AI Providers
  2. Click New or activate one of the 3 demo providers (OpenAI, Claude, Ollama)
  3. Enter your API key — it will be encrypted automatically
  4. Select the model and adjust parameters (temperature, max tokens, timeout)
  5. Click Test Connection to verify
  6. Mark as Default (and optionally set a fallback provider)

Navigate to Settings → Foundation:

  • AI Features: Global enable/disable toggle
  • Default AI Provider: Select from configured providers
  • Automatic Fallback: Enable and select a fallback provider

Add foundation to your module’s depends, then inherit:

class MyModel(models.Model):
    _name = "my.model"
    _inherit = ["mail.thread", "foundation.ai.provider.mixin",
                "foundation.failure.activity.mixin"]

Call self._get_ai_service() to get the provider for AI requests. Call self._create_failure_activity(summary) on errors.

FAQ

No. Depends on base and mail only. Works on Community, Enterprise, and Odoo.sh.
No. Foundation installs without any API keys. You can configure providers later, or use a local Ollama instance with no API key at all. The 3 demo providers ship inactive.
API keys are encrypted at rest using Fernet symmetric encryption with PBKDF2 key derivation (via the Python cryptography library). Keys are encrypted on create and write, decrypted only when needed for API calls. The key field is restricted to base.group_system.
Yes. Select provider type “Local” and set the API endpoint (e.g., http://localhost:11434 for Ollama). No API key required. Local providers are automatically flagged as GDPR-compliant.
If automatic fallback is enabled in Settings, Foundation switches to the designated fallback provider. The get_best_provider() method checks health status and capability requirements before selecting. Failed requests are logged with error details.
Foundation is a developer library and provider hub. It provides AI provider management, encryption, health monitoring, and reusable mixins. By itself it doesn’t add end-user features — those come from modules that depend on it (Invoice Pro, Vault, etc.).
Yes — cryptography (for API key encryption) and requests (for HTTP calls to local providers). Both are widely used, stable Python packages. Install via pip install cryptography requests.

Release History

v19.0.1.4.0 — March 2026

Current Release

  • Failure Activity Mixin — _create_failure_activity() with deduplication, _resolve_failure_activity() auto-resolution
  • 16 automated tests for failure activity mixin

v19.0.1.0.0 — Initial Release

Initial Release

  • AI Provider Hub — OpenAI, Anthropic Claude, Azure, Local (Ollama)
  • Encrypted API keys (Fernet + PBKDF2)
  • Health monitoring, connection testing, response time tracking
  • Default + fallback provider selection with capability matching
  • Rate limiting, daily quotas, cost tracking
  • GDPR compliance flags (data region, zero retention)
  • AI Provider Mixin for consuming modules
  • Multi-step Wizard Framework (2-step and 3-step templates)
  • 3 demo providers (inactive)
  • German and French translations (de.po, fr.po)

Modules That Depend on Foundation

Invoice Pro

AI-powered invoice processing with multi-provider OCR extraction.

49 EUR
Vault

Intelligent document management with AI classification, routing, and retention.

199 EUR
Nextcloud Sync

Bidirectional sync between Odoo Documents and Nextcloud/WebDAV.

99 EUR
SharePoint Sync

Enterprise-grade bidirectional sync between Odoo Documents and SharePoint Online.

99 EUR

Made with ♥ by Syntax & Sabotage

© 2026 Syntax & Sabotage, Lars Weiler. All rights reserved. OPL-1.

Impressum · support@syntaxandsabotage.io

Odoo Proprietary License v1.0

This software and associated files (the "Software") may only be used (executed,
modified, executed after modifications) if you have purchased a valid license
from the authors, typically via Odoo Apps, or if you have received a written
agreement from the authors of the Software (see the COPYRIGHT file).

You may develop Odoo modules that use the Software as a library (typically
by depending on it, importing it and using its resources), but without copying
any source code or material from the Software. You may distribute those
modules under the license of your choice, provided that this license is
compatible with the terms of the Odoo Proprietary License (For example:
LGPL, MIT, or proprietary licenses similar to this one).

It is forbidden to publish, distribute, sublicense, or sell copies of the Software
or modified copies of the Software.

The above copyright notice and this permission notice must be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.

Please log in to comment on this module

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author, please use the developer contact information. They can usually be found in the description.
Please choose a rating from 1 to 5 for this module.
Solid backbone for anything AI in Odoo.
by
COO
on 3/22/26, 1:59 PM

What stands out: it actually takes security seriously. No plain text nonsense, no “hope this is fine”. And the config lives where it should — in settings, not scattered across modules.

It’s not flashy. You don’t “see” it much. But once it’s there, everything AI-related just feels… structured.

There are no comments yet!