by jamis

jamis /bucketwise

ATTENTION: This project is no longer being updated. If you're still interested, feel free to read on...

459 Stars 83 Forks Last release: Not found Other 257 Commits 0 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

= BucketWise

  • http://github.com/jamis/bucketwise


BucketWise is a web application (written in Ruby on Rails) for managing your personal finances. It features an emphasis on budgeting (using a version of the envelope system) and avoiding debt. BucketWise is highly opinionated: it was written for one man's specific needs, and as an experiment, and while it is working very well for that one man, there is no guarantee it will do what you want. (See FEATURES, below).


  • Multiple users
  • Track multiple accounts
  • Accounts may be partitioned into "buckets", as a means of budgeting and saving money
  • Earmark funds for each credit-card purchase to avoid overspending

Things it intentionally does not do:

  • It does NOT automatically pull your transactions from your bank account, and in all likelihood, never will.
  • It does NOT intelligently learn from your purchases and try to guess how to categorize them, and in all likelihood, never will.
  • It does NOT provide a social forum for you to share thoughts with other users, and DEFINITELY never will.


Essentially, all you need is Ruby, Rake, and version 2.3 of the Ruby on Rails framework. To run locally, it is recommended you also have sqlite3 installed, as well as the sqlite3-ruby bindings. It's also easiest if you have Capistrano 2.5.x installed.


Installation is about as convenient as it is for any other Ruby on Rails application. It goes something like this (and please excuse the gratuitous hand-waving):

  • Get a server on which to install it
  • Install all the software it needs
  • Configure the database
  • Deploy the application

To get started quickly, you can just run it locally. Setting that up goes something like this:

  • "cap local externals:setup" to load up the dependencies that BucketWise needs. (You'll need to have git installed for this to work.)
  • "rake db:schema:load" to prepare the database
  • "rake user:create" to create your first user, and note the user-id
  • "rake subscription:create USER_ID=" to create your first "subscription" (a container for your financial account data).
  • "script/server", and then go to http://localhost:3000/ to log in and get started!

If you want to use Capistrano to deploy BucketWise to a server of your own, you can simply create a file at ~/.bucketwise/Capfile, which should contain your custom deployment instructions. If that file exists, BucketWise's own config/deploy.rb will load it automatically.


This software is hereby placed in the public domain. - Jamis Buck (author), April 2009

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.