Overview

Expert AI Chatbot is a comprehensive AI assistant module for Odoo 18 that brings the power of modern AI to your business without expensive recurring subscriptions.

Unlike other AI modules that lock you into monthly fees and proprietary AI services, Expert AI Chatbot lets you:

• Use your own API keys from any provider (OpenAI, Anthropic Claude, Mistral, Google Gemini, Groq, or any OpenAI-compatible API)
• Pay directly to the provider at their standard rates - no markup, no intermediary
• Switch providers anytime without reconfiguring your agents
• Keep your data private with direct connections to AI providers

Key Features

Requirements

# Install litellm via pip
pip install litellm>=1.0.0

# Or if using a virtual environment:
source /path/to/venv/bin/activate
pip install litellm>=1.0.0

# For Docker installations:
docker-compose exec odoo18 pip install litellm>=1.0.0

Installation

# Install litellm first
pip install litellm>=1.0.0

# Install module on a database
odoo -d your_database -i expert_ai_chatbot

# Or with Docker
docker-compose exec odoo18 pip install litellm>=1.0.0
docker-compose exec odoo18 odoo -d your_database -i expert_ai_chatbot

Usage

Troubleshooting

# Standard installation
pip install litellm>=1.0.0

# Docker installation
docker-compose exec odoo18 pip install litellm>=1.0.0

# Then restart Odoo
sudo systemctl restart odoo
# or
docker-compose restart odoo18

Performance Optimization

Uninstallation

If you need to remove the module:

# Backup your database first!
odoo -d your_database -u expert_ai_chatbot --uninstall

Support and Contributing

License

This module is licensed under OPL-1 (Odoo Proprietary License).

See LICENSE file for full terms.

Credits

Author: PlantBasedStudio

Contributors:

• Damien Horvat - Initial development and architecture

Technologies:

• LiteLLM (MIT License) - https://github.com/BerriAI/litellm
• Odoo 18 - https://www.odoo.com/
• Font Awesome - Icon fonts

Changelog

FAQ

Q: Can I use my own self-hosted AI models?

A: Yes! If your model has an OpenAI-compatible API endpoint, you can use it by selecting "Mammouth" or creating a custom provider and entering your endpoint URL.

Q: Does the AI have access to my entire database?

A: No. The AI only has access to data you explicitly provide via Knowledge articles and conversation context. The blacklist system further restricts access to sensitive fields.

Q: What happens if my API key runs out of credits?

A: The AI will return an error message. Users will see a notice that the AI is temporarily unavailable. You should set up billing alerts with your AI provider to avoid this.

Q: Can I use multiple AI providers simultaneously?

A: Yes! Each agent can use a different provider. You can have one agent using OpenAI, another using Claude, etc.

Q: How much does it cost to run the AI?

A: The module itself is a one-time purchase. API costs vary by provider and usage:

Typical usage: 1000 conversations/month costs $10-30 depending on model.

Q: Is the conversation history stored permanently?

A: Yes, all conversations are stored in your Odoo database. You can't see history for privacy.

Q: Can the AI make changes to my database?

A: No. This version of the module is read-only. The AI can only retrieve information and respond to questions. It cannot create, update, or delete records.

Q: Does this work with Odoo Community Edition?

A: Yes! The module works with both Community and Enterprise editions of Odoo 18.

Q: What languages does the AI support?

A: The AI can communicate in any language supported by your chosen AI provider (100+ languages for most providers). The module interface and templates support French and English.

Q: Can I customize the website widget appearance?

A: Yes! You can customize colors, position, welcome message, and avatar image through the agent website configuration.

Q: Is this GDPR compliant?

A: The module provides tools for GDPR compliance (conversation isolation, data deletion), but compliance depends on how you configure it and which AI provider you use. Consult with legal counsel for your specific use case.

Glossary

Agent

An AI assistant with specific configuration, personality, and capabilities

Provider

An AI service provider (OpenAI, Anthropic, etc.) that powers the agent

System Prompt

Instructions that define the agent's behavior and personality

Token

Unit of text used by AI models (~4 characters per token)

Context Window

Maximum amount of text the AI can consider at once

Blacklist

List of database fields that AI is prohibited from accessing

Escalation

Process of transferring conversation from AI to human staff

Knowledge Base

Collection of articles that AI uses to answer questions

LiteLLM

Open-source library that provides unified interface to AI providers

API Key

Credential that authorizes access to AI provider's services

Embeddings

Vector representations of text used for semantic search (future feature)