Redis module for Guile
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


guile-redis is a Guile module for the Redis key-value data store. It provides all commands up to Redis 5.0 and supports multiple commands and pipelining.


Download the latest tarball and untar it:

If you are cloning the repository make sure you run this first:

$ autoreconf -vif

Then, run the typical sequence:

$ ./configure --prefix=<guile-prefix>
$ make
$ sudo make install

Where <guile-prefix> should preferably be the same as your system Guile installation directory (e.g. /usr).

If everything installed successfully you should be up and running:

$ guile
scheme@(guile-user)> (use-modules (redis))

It might be that you installed guile-redis somewhere differently than your system’s Guile. If so, you need to indicate Guile where to find guile-redis, for example:

$ GUILE_LOAD_PATH=/usr/local/share/guile/site guile



The main interface to the Redis server is really simply. It consists on three procedures, the most important one being redis-send which basically sends commands to the server.

  • (redis-connect #:key host port) : Establish a connection to the redis server at the given host and port and return a Redis connection.
    • host : it defaults to
    • port : it defaults to 6379.
  • (redis-close connection) : Close the connection to the Redis server.
  • (redis-send connection commands) : Send the given list of commands to the Redis connection. commands can be a single command or a list of commands. For a list of commands, a list of all the replies is returned.

    Returns : A reply or a list of replies if a list of commands was sent.


    • redis-error : if the Redis server returns an error. The exception has the error string as an argument.
    • redis-invalid : if the user arguments or server’s answer cannot be parsed (hopefully, this is unlikely to happen).

Redis commands

All commands in guile-redis are defined with lower-case and hyphenated in the case of commands that have two or more words. For example, the command ”CLIENT LIST” is defined as client-list.

The commands take exaclty the same arguments as defined in the Redis manual and all the arguments (if any) need to be passed as a single list. For example:

(bitfield '(mykey INCRBY i5 100 1 GET u4 0))

Note that, internally, guile-redis will automatically convert symbols and numbers to strings before sending the command to Redis.


  • Load the module:
    > (use-modules (redis))
  • Create a connection:
    > (define conn (redis-connect))
  • Send a single PING command:
    > (redis-send conn (ping))
  • Send a couple of PING commands:
    > (redis-send conn (list (ping) (ping '("hello from guile-redis"))))
    ("PONG" "hello from guile-redis")
  • Set a couple of keys:
    > (redis-send conn (mset '(hello "world" foo "bar")))
  • Retrieve the keys just set below:
    > (redis-send conn (mget '(hello foo)))
    ("world" "bar")
  • Finally, close the connection:
    > (redis-close conn)


Copyright (C) 2013-2018 Aleix Conchillo Flaque <>

This file is part of guile-redis.

guile-redis is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

guile-redis is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with guile-redis. If not, see