Razyyn
DocumentationOdoo17

Odoo 17 · 2 / 7

Install the app

Download the Razyyn-AI-Odoo-v17 source, install it, and confirm Razyyn appears in your ERP.

These steps are checked against the current app source for this ERP version. Replace example paths, site names and database names with your own values.

Find your addons path

Open the Odoo configuration used by your running service and find addons_path. Choose an existing custom addons directory, or add a new one to that setting. Keep the Odoo built-in addons path as well.

# In odoo.conf (example paths)
addons_path = /path/to/odoo/addons,/path/to/odoo/custom_addons

Download the matching branch

Clone the 17 branch. The installable Odoo module is the razyyn_ai directory inside that checkout.

git clone --branch Razyyn-AI-Odoo-v17 --single-branch https://github.com/Marwan-badr543/Razyyn-AI-Odoo.git razyyn-odoo-17

Put the module on addons_path

Either add the checkout directory itself to addons_path or copy its razyyn_ai directory into a custom addons directory already listed there. Use the latter approach below if you manage modules by copying them.

cp -r razyyn-odoo-17/razyyn_ai /path/to/odoo/custom_addons/

Install the Odoo module

Use the Odoo executable and configuration file used by your deployment. Replace your_database and paths. The module's technical name is razyyn_ai. The account app is required and is resolved by Odoo.

/path/to/odoo-bin -c /path/to/odoo.conf -d your_database -i razyyn_ai --stop-after-init

Restart and verify

Start or restart the normal Odoo service. Open Apps and confirm Razyyn AI is installed, then open Razyyn AI → Agent Chat. The chat sign-in screen should appear. The module serves its chat assets directly; there is no separate front-end build.

# On later updates, after refreshing the source:
/path/to/odoo-bin -c /path/to/odoo.conf -d your_database -u razyyn_ai --stop-after-init
Before continuingThe module's optional scan-reading feature uses OCR dependencies and system packages. Text chat and ERP connection do not depend on having OCR configured. Follow the in-app Document Reading setup if you need photographed invoices.