Client SDKs

Python Client

Client Library for Nuxeo API

|Build Status| |Coverage| |Lines of code|

The Nuxeo Python Client is a Python client library for the Nuxeo Automation and REST API. It works with both Python 2 and 3.

This is an ongoing project, supported by Nuxeo.

Getting Started

The installation is as simple as:

: :
$ pip install --upgrade nuxeo
Then, use the following import statement to have access to the Nuxeo API:

from nuxeo.client import Nuxeo


Check out the API documentation <>__.


The Nuxeo Python client works only with:

  • the Nuxeo Platform >= LTS 2015
  • requests >= 2.12.2 (for unicode authentication)
  • setuptools >= 30.3.0

Quick Start

This quick start guide will show how to do basics operations using the client.

Connect to the Nuxeo Platform

The easiest way to connect to the Nuxeo Platform with a basic authentication is passing a tuple containing the username and the password to the client, like so:

from nuxeo.client import Nuxeo

from nuxeo.client import Nuxeo

nuxeo = Nuxeo(auth=('Administrator', 'Administrator'))

You can then use the nuxeo object to interact with the Platform. If you want to use a specific instance, you can specify the base_url like so:

nuxeo = Nuxeo(

nuxeo = Nuxeo(


auth=('Administrator', 'Administrator')


Download/Upload Configuration

In the nuxeo/ file, you have several constants that are used throughout the client that you can change to fit your needs:

  • CHUNK_SIZE (8 Kio by default), the size of the chunks when downloading,
  • UPLOAD_CHUNK_SIZE (256 Kio by default), the size of the chunks when uploading,
  • CHUNK_LIMIT (10 Mio by default), the size above which the upload will automatically be chunked,
  • MAX_RETRY (3 by default), the number of retries for the upload of a given blob/chunk.

Run NXQL Queries

With nuxeo.request(...) you can run queries in NXQL (NXQL is a subset of SQL, you can check how to use it in the documentation <>). Here, we are first fetching a workspace <documents.rst>, and then using its uid to build a query which will find all its children that have a File or Picture type, and are not deleted.

# Fetch a workspace

# Fetch a workspace

ws = nuxeo.documents.get(path='/default-domain/workspaces/ws')

# Build a query using its uid

query = "SELECT * FROM Document WHERE ecm:ancestorId = '" + ws.uid + "'"

query += " AND ecm:primaryType IN ('File', 'Picture')"

query += " AND ecm:currentLifeCycleState != 'deleted'"

request = 'query?query=' + urllib.quote(query, safe='!=:')

search = nuxeo.request('GET', request)

entries = search.get('entries')

entries will be a list containing a dict for each element returned by the query.


Now that your client is set up, here are pages to help you with the main functions available:

  • Manage users and groups <examples/users_and_groups.rst>__
  • Work with documents <examples/documents.rst>__
  • Work with directories <examples/directories.rst>__
  • Work with blobs <examples/blobs.rst>__
  • Run requests <examples/requests.rst>__
  • Helpers <examples/helpers.rst>__
  • Useful snippets <examples/snippets.rst>__
  • Script: Find duplicates <examples/>__
  • Script: Create a live proxy <examples/>__

You can also check the API documentation <>__ of this Python client for further options.


See our contribution documentation <>__.


: :

$ git clone

$ cd nuxeo-python-client

$ python develop


  1. Nuxeo Platform instance needs to be running on http://localhost:8080/nuxeo for the tests to be run, and then:

: :
$ python test
Tests can be launched without a server with Maven and pytest:

: :
$ mvn -f ftest/pom.xml clean verify

Reporting Issues

You can follow the developments in the Nuxeo Python Client project of our JIRA bug tracker:

You can report issues on <>__.


Apache License 2.0 <>__ Copyright (c) Nuxeo

About Nuxeo

Nuxeo dramatically improves how content-based applications are built, managed and deployed, making customers more agile, innovative and

  1. Nuxeo provides a next generation, enterprise ready platform for building traditional and cutting-edge content oriented applications. Combining a powerful application development environment with SaaS-based tools and a modular architecture, the Nuxeo Platform and Products provide clear business value to some of the most recognizable brands including Verizon, Electronic Arts, Sharp, FICO, the U.S. Navy, and
  2. Nuxeo is headquartered in New York and Paris. More information is available at <>__.




" target="_blank

2 months ago manonlumeau NXDOC-1393: Review Python client
3 months ago Manon Lumeau Add tags for doc days
3 months ago Andrew Goodricke Changed repo url for nuxeo-python-client Readme.
3 months ago manonlumeau Added content-review-lts2017 label
4 months ago manonlumeau NXDOC-1346-FT review screenshot
2 years ago Anne Jubert 16
4 years ago Solen Guitter 15 | fixed broken links to blog posts
4 years ago Solen Guitter 14
4 years ago Alain Escaffre 12
4 years ago Alain Escaffre 13
4 years ago Solen Guitter 11
4 years ago Solen Guitter 10
4 years ago Solen Guitter 9
6 years ago Olivier Grisel 7
6 years ago Olivier Grisel 8 | Migrated to Confluence 4.0
8 years ago Stéfane Fermigier 6
8 years ago Stéfane Fermigier 5
8 years ago Stéfane Fermigier 4
8 years ago Stéfane Fermigier 3
8 years ago Stéfane Fermigier 1
8 years ago Stéfane Fermigier 2
History: Created by Stéfane Fermigier