A beanstalkd work queue client library.


beanstalkd.nim logo

This is a Nim client library to connect to and use beanstalkd.

Status: Beta, ready for experimental usage, may not be production ready.


Join the chat at

Install this library using the nimble package manager:

nimble install beanstalkd


beanstalkd.nim maps pretty closely to the beanstalkd protocol. For complete module documentation, see

import beanstalkd

let client ="")
discard client.put("hello world")

let job = client.reserve
echo job
 #==> (success: true, status: reserved, id: 42, job: hello world)

let result = client.delete(
echo result
 #==> (success: true, status: deleted)


This project uses vagrant to bootstrap the development environment. To get started:

$ git clone
$ cd beanstalkd.nim
$ vagrant up
$ vagrant ssh
$ cd /vagrant

Now to build and run all the examples, do:

$ ./test

Executables are located in /vagrant/build. To only compile the beanstalkd module, do:

$ ./compile

To re-generate module documentation, run:

$ ./gendoc

TODO: How to prepare new release...

Need help? Read Nimble
Available versions:
License: MIT

Project website Hosted docs