| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Inventory (stock) • Sales (sale_management) • eCommerce (website_sale) • Invoicing (account) • Website (website) |
| Lines of code | 436 |
| Technical Name |
bt_product_recommender |
| License | OPL-1 |
| Website | https://bt-group.com |
| Versions | 14.0 15.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Inventory (stock) • Sales (sale_management) • eCommerce (website_sale) • Invoicing (account) • Website (website) |
| Lines of code | 436 |
| Technical Name |
bt_product_recommender |
| License | OPL-1 |
| Website | https://bt-group.com |
| Versions | 14.0 15.0 |
BT-ML: Product Recommender
A product recommender based on artificial intelligence
This app is an artificial intelligence-powered product recommender for Odoo. It learns how different products are combined together from past sales and automatically fills in the convenient fields Odoo already provides in an automatic and unattended way. It offers certain configuration options suitable for both basic and advanced users.
This app was presented in the Odoo Experience 2021. It is a good idea to start watching the video of the presentation, ideally completely, but if you are in a hurry you can start at 13:08 where the app is shown running.
Notice that this app has slightly changed with respect to the version shown in the Odoo Experience 2021: the advanced configuration options mentioned in the Q&A (starting at 20:13 are now not hidden as system parameters but also available from the Sales configuration settings in the case you want to fine-tune them in an easy way.
Installation
- Install the Python dependencies, listed in the file requirements.txt
- sudo pip3 install pandas==1.2.4
- sudo pip3 install mlxtend==0.18.0
- sudo pip3 install numpy==1.21.3
- Go to the Apps, search for either BT-ML: Product Recommender or bt_product_recommender, and install it.
Configuration
For a fast configuration, it may be enough to just see the video from the Odoo Experience 2021, where at 13:08 we start using the app and show an example of a simple configuration. For a more detailed explanation of the parameters you can configure, keep reading this section.
Settings
After you install the app, you can go to the Settings for Sales and activate the checkbox **Activate AI-powered Product Recommender**. This allows you to indicate certain business rules to be taken into account by the product recommender:
- Number of Recommendations.
- Sales Order Exclude Domain: Sales orders matching this domain won't be taken into account when computing the recommendations.
- Products Exclude Domain: Products matching this domain won't be taken into account when computing the recommendations.
The advanced configuration settings can be changed if the flag Show Advanced Configuration Settings is checked, including the metric used to compute the recommendations:
Scheduler
Once the product recommender is activated, the scheduler BT-ML: Product Recommender will be able to run. It is configured to run once a day, but you can change this period at your convenience. The scheduler won't run if the flag on the settings, Activate AI-powered Product Recommender, is not checked.
Developers
This section is targeted to developers wishing to extend this app, not for the end users that will use it.
This app is intended to work in a way that no intervention is needed other than a small configuration made at the beginning. However, this app is developer-friendly in the case you need to extend it following its license OPL-1:
- Since OPL-1 allows you to use this app as a library, but not copying its code, every step in the process has been placed in its own method, so that you can easily extend it using the usual method inheritance provided by Odoo.
- The app is well covered by automated unit tests that rely on the Odoo testing framework.
- The code is formatted using black, following the current trends of code-layout for Odoo apps.
Licenses
- This app is published under the Odoo Proprietary License v1.0 (OPL-1)
- This app uses pandas, mlxtend and numpy, licensed under the BSD-3 license.
- For questions related to this application, please use the following email.
BT-ML: Product Recommender
This app is an artificial intelligence-powered product recommender for Odoo. It learns how different products are combined together from past sales and automatically fills in the convenient fields Odoo already provides in an automatic and unattended way. It offers certain configuration options suitable for both basic and advanced users.
This app was presented in the Odoo Experience 2021. It is a good idea to start watching the video of the presentation, ideally completely, but if you are in a hurry you can start at 13:08 where the app is shown running.
Notice that this app has slightly changed with respect to the version shown in the Odoo Experience 2021: the advanced configuration options mentioned in the Q&A (starting at 20:13) are now not hidden as system parameters but also available from the Sales configuration settings in the case you want to fine-tune them in an easy way.
Installation
Install the Python dependencies, listed in the file requirements.txt:
sudo pip3 install pandas==1.2.4 sudo pip3 install mlxtend==0.18.0 sudo pip3 install numpy==1.21.3
Go to the Apps, search for either "BT-ML: Product Recommender" or "bt_product_recommender", and install it.
Configuration
For a fast configuration, it may be enough to just see the video from the Odoo Experience 2021, where at 13:08 we start using the app and show an example of a simple configuration. For a more detailed explanation of the parameters you can configure, keep reading this section.
Settings
After you install the app, you can go to the Settings for Sales and activate the checkbox Activate AI-powered Product Recommender. This allows you to indicate certain business rules to be taken into account by the product recommender:
- Number of Recommendations.
- Sales Order Exclude Domain: Sales orders matching this domain won't be taken into account when computing the recommendations.
- Products Exclude Domain: Products matching this domain won't be taken into account when computing the recommendations.
The advanced configuration settings can be changed if the flag Show Advanced Configuration Settings is checked, including the metric used to compute the recommendations.
Scheduler
Once the product recommender is activated, the scheduler BT-ML: Product Recommender will be able to run. It is configured to run once a day, but you can change this period at your convenience. The scheduler won't run if the flag on the settings, Activate AI-powered Product Recommender, is not checked.
Developers
This section is targeted to developers wishing to extend this app, not for the end users that will use it.
This app is intended to work in a way that no intervention is needed other than a small configuration made at the beginning. However, this app is developer-friendly in the case you need to extend it following its license OPL-1:
- Since OPL-1 allows you to use this app as a library, but not copying its code, every step in the process has been placed in its own method, so that you can easily extend it using the usual method inheritance provided by Odoo.
- The app is well covered by automated unit tests that rely on the Odoo testing framework.
- The code is formatted using black, following the current trends of code-layout for Odoo apps.
Licenses
- This app is published under the Odoo Proprietary License v1.0 (OPL-1).
- This app uses pandas, mlxtend and numpy, licensed under the BSD-3 license.
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