aasm/aasm

Health v2 · maintenance only

Flags: no_releases

Adoption not part of the score

5230 stars · 643 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

AASM is a Ruby library for adding finite state machines to Ruby classes, with adapters for ActiveRecord, Mongoid, NoBrainer, Dynamoid, Sequel, and Redis. It supports callbacks, guards, transitions, multiple state machines per class, transaction support, and testing helpers.

Use cases

• add a state machine to a Rails ActiveRecord model
• manage order lifecycle states with guarded transitions
• define state machines for plain Ruby classes
• persist state transitions with Mongoid or Dynamoid
• test state machine transitions with RSpec or Minitest
• log and inspect state changes on models

When to choose

• you need finite state machine semantics in Ruby with ORM persistence
• you want callbacks, guards, and transaction support around transitions
• you need multiple named state machines on a single class

When to avoid

• you need state machines in a non-Ruby language
• you only need a simple status enum without transition logic
• you need distributed workflow orchestration rather than in-model state

Facets

library · maturity stable

state-management orm developer-tools web-development backend developer-tools ruby jvm state-machine finite-state-machine activerecord mongoid rails transitions callbacks guards

Member repositories

For agents

markdown · JSON · MCP: product_card(name="aasm/aasm")