A model-level interface for kicking off background jobs using ActiveJob.


Add this line to your application's Gemfile:

gem 'active_model-jobs'

And then execute:

$ bundle


Given we already have a model called Track, generate a job called UploadTrackJob:

require 'aws/s3'

class UploadTrackJob < ActiveRecord::Base
  queue_as :default

  def perform(track)
    s3.put_object(, track.file.attributes)


  def s3

Now, you can kick off that job by calling its "action method" on your model:

class Track < ActiveRecord::Base
  include ActiveModel::Jobs

  after_commit :upload!, on: :create

Since this is just an instance method, you can call track.upload! to kick off the job at any time outside of the callback lifecycle.

Global Inclusion

You can include this module in every ActiveRecord model by inserting the following code into an initializer at config/initializers/active_model_jobs.rb:

ActiveRecord::Base.send :include, ActiveModel::Jobs


After checking out the repo, run bin/setup to install dependencies. Then, run bin/console for an interactive prompt that will allow you to experiment.


  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

All contributions must be made in a pull request and include accompanying tests. Pull requests will not be merged until they pass the CI build for all supported Ruby and Rails versions. To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release to create a git tag for the version, push git commits and tags, and push the .gem file to

Also see our Code of Conduct.