Skip to content

Installation Guide

🎯 Prerequisites

Before installing AI Complete Suite, make sure you have the following:

Odoo System Requirements

  • Odoo Version: 17.0, 18.0, 19.0
  • Database: PostgreSQL 13 or higher
  • Access: Admin access to Odoo system

System Requirements

  • CPU: 4 cores or higher
  • RAM: Minimum 8GB, recommended 16GB
  • Storage: 2GB for modules and data
  • Operating System: Linux (Ubuntu/Debian recommended)

🔧 Environment Setup

Choose your installation environment:

Self-Hosted Environment

Python Dependencies

Install required Python packages using pip:

Core Dependencies (Required for all modules):

pip install mistune>=3.0.0 \
    markdownify>=0.11.0 \
    pyyaml>=6.0 \
    "pydantic>=2.0.0,<2.11.0" \
    docstring_parser>=0.15 \
    fastembed>=0.5.0,<=0.5.1

AI Provider Dependencies (Install based on your needs):

For ChatGPT Connector:

pip install openai>=1.0.0

For Claude Connector:

pip install anthropic>=0.80.0

For Gemini Connector:

pip install google-genai>=1.32.0

PostgreSQL Extension Setup

Install and enable pgvector extension:

# Install pgvector extension
sudo apt update
sudo apt install postgresql-17-pgvector

Note: Replace 17 with your PostgreSQL version. Check version with:

psql --version

Enable the extension:

-- Connect to your Odoo database
\c your_odoo_database_name

-- Enable the vector extension
CREATE EXTENSION IF NOT EXISTS vector;

Module Upload

Copy AI modules to your Odoo addons directory:

# Copy modules to addons directory
cp -r /path/to/ai_modules/* /path/to/odoo/addons/

# Restart Odoo service
sudo systemctl restart odoo

Odoo.sh Environment

PostgreSQL Extension Check

Odoo.sh typically comes with pgvector pre-installed on their databases, so you usually don't need to install it anymore. However, let's verify it's working properly:

# Connect to your Odoo.sh database
psql

# Check if pgvector extension exists
CREATE EXTENSION IF NOT EXISTS vector;

Expected Results:

  • ✅ "CREATE EXTENSION" - Extension installed successfully
  • ❌ "ERROR: extension 'vector' does not exist" - Contact Odoo.sh support

Note: If pgvector is not available, contact Odoo.sh support as you cannot install PostgreSQL extensions yourself.

Python Dependencies

Create requirements.txt in your repository root:

# Navigate to your Git repository root
cd /path/to/your/odoo-sh-repository

# Append Python dependencies to requirements.txt
echo "mistune>=3.0.0" >> requirements.txt
echo "markdownify>=0.11.0" >> requirements.txt
echo "pyyaml>=6.0" >> requirements.txt
echo "pydantic>=2.0.0,<2.11.0" >> requirements.txt
echo "docstring_parser>=0.15" >> requirements.txt
echo "fastembed>=0.5.0,<=0.5.1" >> requirements.txt
# For ChatGPT Connector
echo "openai>=1.0.0" >> requirements.txt
# For Claude Connector
echo "anthropic>=0.80.0" >> requirements.txt
# For Gemini Connector
echo "google-genai>=1.32.0" >> requirements.txt

Note: Odoo.sh automatically installs dependencies from requirements.txt on each deployment.

Module Upload

Copy the AI modules source code into your Git repository, commit then push to your Odoo.sh branch.

⚙️ Module Installation

Update Module List

  1. Log into your Odoo system as an administrator
  2. Go to Apps → Update Apps List
  3. Click Update to refresh the module list

Install Core Module

  1. Go to Apps → Search for "AI"
  2. Find "AI Integration Base"
  3. Click Install

Install Additional Modules (Optional)

Depending on your needs, install these modules:

For Discuss Integration:

  • Search for "AI Assistant for Discuss"
  • Click Install

For Livechat Integration:

  • Search for "AI Chatbot for Livechat"
  • Click Install

For AI Providers:

  • ChatGPT: Search for "AI ChatGPT Connector"
  • Claude: Search for "AI Claude Connector"
  • Gemini: Search for "AI Gemini Connector"

🔑 Configuration

Create AI Configuration

  1. Go to Settings → Technical → AI → Configurations
  2. Click Create

  3. Fill in the details:

    • Name: "My AI Configuration"
    • Type: Choose your AI provider (ChatGPT, Claude, or Gemini)
    • API Key: Enter your API key from the provider
    • Model: Leave default or specify your preferred model
    • Temperature: 0.7 (recommended for balanced responses)
    • Max Tokens: 2048 (or as needed)

Get API Keys

For ChatGPT (OpenAI):

  1. Go to OpenAI Platform
  2. Create an account or sign in
  3. Go to API Keys section
  4. Create a new API key
  5. Copy the key and save it securely

For Claude (Anthropic):

  1. Go to Anthropic Console
  2. Create an account or sign in
  3. Go to API Keys section
  4. Create a new API key
  5. Copy the key and save it securely

For Gemini (Google):

  1. Go to Google AI Studio
  2. Create an account or sign in
  3. Go to API Keys section
  4. Create a new API key
  5. Copy the key and save it securely

🧪 Testing & Next Steps

Verify Installation

  1. Go to Settings → Technical → AI

  2. You should see these menu items:

    • Configurations
    • Data Sources
    • Contexts
    • Assistants
    • Prompt Templates
    • Threads

Next Steps

After successful installation:

  1. Set up data sources: Data Sources Guide
  2. Configure contexts: Contexts Guide
  3. Create your first AI assistant: AI Assistants Guide
  4. Test with Discuss: Quick Start Guide

Need help? Contact support or check the documentation for your specific issue.