a ruby workflow engine (dead)
Ruby Shell
Latest commit 30a6bb8 Dec 12, 2016 @jmettraux Link ruote to flor
Failed to load latest commit information.
examples modernize barley infrastructure Jun 13, 2013
lib Fixed issue in ProcessObserver when handling error_intercepted messag… Jan 22, 2014
quickstart Fix link to quickstart.rb file Jul 12, 2013
snips remove "require 'pp'" in issue template Jun 24, 2013
test fail to address gh-93 Mar 1, 2014
CHANGELOG.txt let radial accept \r\n strings May 5, 2013
CREDITS.txt Merge branch 'master' of github.com:jmettraux/ruote Oct 28, 2013
LICENSE.txt 2013 Dec 24, 2012
README.md Link ruote to flor Dec 12, 2016
Rakefile bring back rdoc generation Mar 31, 2013
TODO.txt use Struct in lieu of OpenStruct Aug 3, 2013
ruote.gemspec upgrade to rufus-scheduler >= 3.0.0 Oct 14, 2013


Important Note

Active development on ruote ceased.

See scaling down ruote.

Do not involve ruote in your new project.

** 2016-12-12 Update **

Ruote development moved to a new Ruby workflow engine named flor.

The team is named floraison and there is also a "flor behind Rack" project named flack.


Ruote is a Ruby workflow engine. It's thus a workflow definition interpreter. If you're enterprisey, you might say business process definition.

Instances of these definitions are meant to run for a long time, so Ruote is oriented towards persistency / modifiability instead of transience / performance like a regular interpreter is. A Ruote engine may run multiple instances of workflow definitions.

Persistent mostly means that you can stop Ruote and later restart it without losing processes. Modifiability means that you can modify a workflow instance on the fly.

Process definitions are mainly describing how workitems are routed to participants. These participants may represent worklists for users or group of users, pieces of code, ...


grab ruote

gem install yajl-ruby
gem install rufus-scheduler -v 2.0.24
gem install ruote

or better, use a Gemfile like this one: https://gist.github.com/jmettraux/22f24fca70c5a116b01c


require 'rubygems'
require 'ruote'
require 'ruote/storage/fs_storage'

# preparing the engine

engine = Ruote::Engine.new(

# registering participants

engine.register_participant :alpha do |workitem|
  workitem.fields['message'] = { 'text' => 'hello !', 'author' => 'Alice' }

engine.register_participant :bravo do |workitem|
  puts "I received a message from #{workitem.fields['message']['author']}"

# defining a process

pdef = Ruote.process_definition :name => 'test' do
  sequence do
    participant :alpha
    participant :bravo

# launching, creating a process instance

wfid = engine.launch(pdef)

  # blocks current thread until our process instance terminates

# => 'I received a message from Alice'

test suite

see http://github.com/jmettraux/ruote/tree/master/test