Skip to main content

Fast, simple Odoo RPC package with sync and async functions to pilot Odoo's jsonrpc API. Check aio-odoorpc for a higher-level, friendlier interface.

Project description

Base functions to pilot Odoo's jsonrpc API (aio-odoorpc-base)


A higher-level, friendlier interface is provided by aio-odoorpc, make sure to check that out as well.


This is a core/base package with lower-level functions used by other higher-level 'aio-odoorpc-*' packages that are used in production in at least one company.

All functions offered by this package are available in both async and sync versions. The sync version is automatically generated from the async one, so they are always in sync! ;)

While lacking some sort of facilitating helper class, the functions provided by this package are quite usable and may be a very good foundation for your own Odoo-interfacing code.

Do not at all expect to find functionality similar to erpeek or odoorpc, this package only offers facilitating functions that mirror the dispatching methods available on Odoo's jsonrpc endpoint (i.e. 'login', 'execute_kw', etc).

You will not find facilitating functions for methods such as 'search', 'read', 'search_read' which are actually executed through the 'execute_kw' dispatcher. If you want those higher-level functions you should probably look into 'aio-odoorpc'.

No dependencies:

No dependency is not a promise, just a preference. It may change in the future, but only if for very good reason.

This also means that you are free to use whatever HTTP Client library you like. This package only requires that:

  1. The http_client must support a '.post(url, json=a_dict)' method. All headers, etc must be managed by you. Alternatively, a callable can be passed on in place of the http client, in which case it will be called with a single argument: the json payload;
  2. The 'post' method mentioned above must return a response object that must have a '.json()' method. This method may be synchronous or asynchronous (when using the async functions). It must return a dict or dict-like object. This interface is supported by packages such as 'requests', 'httpx' and 'aiohttp'. If your favorite library does not offer such interface, it is easy to wrap the object yourself in order to provide it;

I am willing to make modifications in the code in order to support other http client solutions, just get in touch (use the project's github repository for that).

While it would be easier if this package shipped with a specific http client dependency, it should be noted that having the possibility to reuse HTTP sessions is a great opportunity to improve the speed of your running code. Also, it is possible that your project is already using some http client library and here you have the opportunity to use it.

Remember that you must use an async http client library if you are going to use the async functions, or use a synchronous http client library if you are going to use the sync function.

#####Python HTTP Client packages known to be compatible:

  • sync-only: 'requests'
  • async-only: 'aiohttp'
  • sync and async: 'httpx'


As I gained experience producing code to interface with Odoo's RPC API, I felt that it was better to control myself all the RPC invocations and hence I started to use only the lower level 'odoorpc' methods (execute_kw, read, search, search_read). The package 'odoorpc' is a great solution to pilot Odoo, it offers plenty of functionality, but it does get in the way when one needs to go fast, specially when you are making thousands of remote RPC calls. Also, if you want fast code you quickly start missing an async interface. So here it is, enjoy!


  • Add functions to help getting data into Odoo, right now the functions are mostly to get data out;

Other things to know about this module:

  • It ships will a good suite of tests that run against an OCA runbot instance;

  • Asyncio is a python3 thing, so no python2 support;

  • Type hints are used everywhere;

  • This package uses jsonrpc only (no xmlrpc). There is a lack of async xmlrpc tooling and jsonrpc is considered the best RPC protocol in Odoo (faster, more widely used);

  • The synchronous version of the code is generated automatically from the asynchronous code, so at least for now the effort to maintain both is minimal.

  • I am willing to take patches and to add other contributors to this project. Feel free to get in touch, the github page is the best place to interact with the project and the project's author;

  • I only develop and run code in Linux environments, if you find a bug under other OS I am happy to take patches but I will not myself spend time looking into these eventual bugs;

Things to know about Odoo RPC API:

  • The 'login' call is really only a lookup of the user_id (an int) of a user given a database, username and password. If you are using this RPC client over and over in your code, maybe even calling from a stateless cloud service, you should consider finding out the user id (uid) of the user and pass the uid instead of the username to the constructor of AsyncOdooRPC. This way, you do not need to call the login() RPC method to retrieve the uid, saving a RPC call;

  • The uid mentioned above is not a session-like id. It is really only the database id of the user and it never expires. There is really no 'login' step required to access the Odoo RPC API if you know the uid from the beginning;


Ok, so let's start with some examples. I will omit the event_loop logic, I assume that if you want to use an async module you already have that sorted out yourself or through a framework like FastAPI.

All examples below could also be called using the synchronous OdooRPC object, but without the 'await' syntax. Synchronous functions do not start with 'aio_', that is a marker of the async functions only.

I recommend that you check the tests folder for many more examples. Also, the codebase is very very short, do refer to it as well.

from aio_odoorpc_base import aio_login, aio_execute_kw, build_odoo_jsonrpc_endpoint_url
import httpx

url = build_odoo_jsonrpc_endpoint_url(host='')

async with httpx.AsyncHttpClient(url=url) as client:
    uid = await aio_login(client, database='acme', username='demo', password='demo')
    data = await aio_execute_kw(client,
                                method_kwargs = {'fields': ['} 

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for aio-odoorpc-base, version 2.0.3
Filename, size File type Python version Upload date Hashes
Filename, size aio_odoorpc_base-2.0.3-py3-none-any.whl (8.0 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size aio-odoorpc-base-2.0.3.tar.gz (7.1 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page