tarantool

This package is a pure-python client library for Tarantool.

Download and install

The recommended way to install the tarantool package is using pip.

$ pip3 install tarantool

You can install python3-tarantool RPM package if you use Fedora (34, 35, 36).

Add the repository

$ curl -L https://tarantool.io/OtKysgx/release/2/installer.sh | bash

and then install the package

$ dnf install -y python3-tarantool

You can install python3-tarantool deb package if you use Debian (10, 11) or Ubuntu (20.04, 22.04).

Add the repository

$ curl -L https://tarantool.io/OtKysgx/release/2/installer.sh | bash

and then install the package

$ apt install -y python3-tarantool

You can also download zip archive, unpack it and run:

$ make install

You can also install the development version of the package using pip.

$ pip3 install git+https://github.com/tarantool/tarantool-python.git@master

Tarantool is an in-memory computing platform originally designed by VK and released under the terms of BSD license.

ANSI SQL, including views, joins, referential and check constraints
Lua packages for non-blocking I/O, fibers, and HTTP
MessagePack data format and MessagePack-based client-server protocol
Two data engines:
- memtx – in-memory storage engine with optional persistence
- vinyl – on-disk storage engine to use with larger data sets
Secondary key and index iterator support (can be non-unique and composite)
Multiple index types: HASH, BITSET, TREE, RTREE
Asynchronous master-master replication
Authentication and access control

This driver is synchronous, so connection mustn’t be shared between threads/processes.

If you’re looking for an asynchronous Python driver based on asyncio, consider using asynctnt . See also the feature comparison table.

On Linux:

$ make test

On Windows:

Setup a Linux machine with Tarantool and tt installed. This machine will be referred to as remote in this instruction.
(On remote) Copy test/suites/lib/tarantool_python_ci.lua to /etc/tarantool/instances.available.
(On remote) Run tt start tarantool_python_ci.
Set the following environment variables: * REMOTE_TARANTOOL_HOST=..., * REMOTE_TARANTOOL_CONSOLE_PORT=3302.
Run make test.

To build documentation, first you must install its build requirements:

$ pip3 install -r docs/requirements.txt

Then run

$ make docs

You may host local documentation server with

$ python3 -m http.server --directory build/sphinx/html

Open localhost:8000 in your browser to read the docs.

BSD-2-Clause. See the LICENSE file.

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution for tarantool 1.3.0
File	Size	Uploaded
tarantool-1.3.0.tar.gz	291.9 kB	Aug 18, 2026	Details

Table of built distributions (wheels) for tarantool 1.3.0
File	Interpreter	ABI	Platform	Reset
tarantool-1.3.0-py3-none-any.whl 93.2 kB Aug 18, 2026	Python 3	none	any	Details

Total release size: 385.1 kB

Download URL	tarantool-1.3.0.tar.gz
Size	291.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`4cb989565cea8304f59116c28be5395537897a08fedfd6caa1fbd299b03f04bd`
BLAKE2b-256 checksum How to use checksums	`5b628e3b7fad26b6398147f656792a7fd04e2f5259433eef504cec08af77d5a5`
Upload date	Aug 18, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.11.15`

Download URL	tarantool-1.3.0-py3-none-any.whl
Size	93.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`8ec20dfa0176700ece16e8271d56a320e35e16622dec33099565b07092e4d836`
BLAKE2b-256 checksum How to use checksums	`e41c83f9f3769d0eae67d02eaf11f8895dfd18e22056868c155a824de5f62a43`
Upload date	Aug 18, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.11.15`