The Tarantool driver (a.k.a. connector) 🕷
Switch branches/tags
Nothing to show
Clone or download
vladfaust fix: sleep before read
Allows to actually catch errors
Latest commit 36d01e6 Oct 24, 2018


Built with Crystal Build status Docs Releases Awesome Patrons count

The Tarantool driver for Crystal.

Become Patron


Tarantool is a super-fast NoSQL* in-memory database. Crystal is a super-fast compiled language. Take both.

* It is planned to fully support SQL in version 2, which is currently in alpha


Recent benchmarking of 100k select requests on a single 0.90Ghz CPU core with Tarantool running on the same machine via Docker:

$ crystal bench/ --release
  1.530000   1.070000   2.600000 (  2.597737)

Resulting performance is 38.4k RPS, averaging in 26μs per request.

Projects using Tarantool


Add this to your application's shard.yml:

    github: vladfaust/
    version: ~> 0.1.0

This shard follows Semantic Versioning 2.0.0, so see releases and change the version accordingly.


After you installed and run Tarantool and setup your schema, do:

require "tarantool"

db ="localhost", 3301) # Initiate the connection
db.parse_schema # Save current box schema to db instance
db.insert(:examples, {1, "hello"}) # Insert "hello" tuple
db.update(:examples, :primary, {1}, {"=", 1, "hello world"}) # Replace "hello" with "hello world", :name, {"hello world"}) # => [[1, "hello world"]]

All Tarantool::Connection#* requests are synchronous, they will be waiting until the response is received. However, a single Tarantool instance itself is capable of handling lots of simultaneous connections, so for the best perfomance consider running requests in multiple fibers:

32.times do
  spawn do # All 32 pings are executed concurrently


  1. Run docker run --name mytarantool -d -p 3301:3301 -v /var/lib/docker/volumes/tarantool:/var/lib/tarantool tarantool/tarantool:1
  2. Connect to tarantool via console (docker exec -i -t mytarantool console) and apply schema found in /spec/helpers.lua
  3. crystal spec


  1. Fork it ( )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request