AI Provider Pool: Claude, DeepSeek, Self-Hosted

Adds Anthropic Claude, DeepSeek, and any self-hosted OpenAI-compatible LLM as native AI providers in Odoo 19 Enterprise — with automatic embedding fallback and configurable AI automation model.

One install, three new providers

Odoo 19 Enterprise ships with OpenAI and Google Gemini as built-in AI providers. This module registers three additional providers into the same native framework, so they appear in the AI Agent model selector alongside the defaults — no patching, no wrapper, no separate configuration page.

Anthropic Claude

Full Messages API integration with tool calling. Supports Claude Opus, Sonnet, and Haiku models. API key configured per database in Settings → AI, or via the ODOO_AI_ANTHROPIC_TOKEN environment variable.

DeepSeek

Chat Completions API with function calling. Supports DeepSeek-Chat and DeepSeek-Reasoner models. API key configured per database or via ODOO_AI_DEEPSEEK_TOKEN.

Self-Hosted (OpenAI-compatible)

Any endpoint exposing /v1/chat/completions — Ollama, vLLM, LM Studio, HuggingFace TGI, or a custom deployment. Type host:port and the /v1 suffix is added automatically. API key is optional, suitable for local installs without authentication.

• Fetch Available Models — one-click discovery via /v1/models on the configured server.
• Test Connection — verifies reachability before going live.

Automatic Embedding Fallback

Anthropic, DeepSeek, and self-hosted models do not provide embedding APIs. Without this module, selecting one of these models on an AI Agent and uploading a Knowledge Source would fail with an error.

This module solves the problem transparently: when the agent's chat provider has no embedding capability, the module automatically falls back to any provider that has both an embedding model and a configured API key (OpenAI or Google).

How it works: Embedding is not "reading" — it is a one-time conversion of your documents into numeric vectors for similarity search. When a user asks a question, the system searches for relevant document passages using the embedding provider, then passes those passages as plain text to your chosen chat model (Claude, DeepSeek, etc.) for the actual answer. 99% of the cost is on the chat model; embedding costs are negligible.

AI Automation Model

Native Odoo 19 hardcodes OpenAI GPT-4.1 for all AI-powered server actions, regardless of which model you selected on your AI Agent.

This module adds a global AI Automation Model setting in Settings → AI. Once set, all AI-powered automations — document sorting, automated actions, workflow triggers — use your preferred model instead of the hardcoded default.

If left empty, the native GPT-4.1 default is preserved. You can switch at any time without restarting.

Configuration

All provider settings live in Settings → AI, in the same section as the native OpenAI and Gemini providers:

• AI Automation Model — choose which LLM powers AI-driven server actions and automations.
• API keys — per database, stored as system parameters. Also readable from environment variables for containerized deployments.
• Self-Hosted URL — auto-completed from host:port input.
• Custom model list — manually entered or fetched from the server's /v1/models endpoint.

Multi-company safe. Keys and URLs are stored as system parameters shared across companies.

AI Agents with new providers

After installation, Claude, DeepSeek, and your self-hosted models appear directly in the AI Agent model selector. No additional configuration is needed beyond providing the API key or server URL.

Knowledge Sources (PDFs, documents, URLs) work with any chat model — embedding is handled automatically via the fallback mechanism described above.

What works with the new providers

Requirements

• Odoo 19 Enterprise — depends on the ai_app module.
• At least one API key for any of the three providers, or a reachable self-hosted endpoint.
• For Knowledge Sources: an additional OpenAI or Google API key for embedding (only needed when using Claude, DeepSeek, or Self-Hosted as the chat model).
• Network egress from the Odoo server to api.anthropic.com, api.deepseek.com, or your self-hosted server.

License & support

Released under the GNU Lesser General Public License v3 (LGPL-3.0-or-later). The full license text is included in the LICENSE file shipped with the module.

Maintained by SuiteState. For questions, bug reports, or feature requests, visit suitestate.com or contact hello@suitestate.com.