https://github.com/pbrisbin/bandit

Bandit helps you choose music
https://github.com/pbrisbin/bandit

Last synced: 10 days ago
JSON representation

Bandit helps you choose music

• Host: GitHub
• URL: https://github.com/pbrisbin/bandit
• Owner: pbrisbin
• Created: 2012-07-04T02:47:26.000Z (over 12 years ago)
• Default Branch: master
• Last Pushed: 2012-07-05T20:57:24.000Z (over 12 years ago)
• Last Synced: 2024-11-09T07:47:28.813Z (2 months ago)
• Language: Ruby
• Size: 117 KB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Bandit

Bandit is a simple tool inspired by the great [albumbler][] by Kyle 

Keen. Bandit uses a reward-maximizing strategy known as [multi-armed 

bandit][mab] to consistently find and play good music from your 

collection.

### How it works

Bandit does one thing when executed: choose and play an album.

*Some of the time*, Bandit will choose an album at random (exploration).

Depending on how long you let that album play before invoking Bandit 

again, that album's "worth" will be adjusted.

*Most of the time*, Bandit will choose the album which has the 

highest worth at this time (exploitation).

Obviously, this means Bandit needs to be used for a while before you see 

any sort of intelligence emerge.

### Getting started

~~~ 

$ git clone https://github.com/pbrisbin/bandit

$ cd bandit

$ bundle install

$ bundle exec bin/bandit  # to just try it out

$ rake install            # to install for reals

~~~

### Configuration

For now, Bandit's behavior/strategy can be configured only by editing 

`lib/bandit/config.rb` directly.

Player-interaction is accomplished by defining a `Player` subclass and 

assigning its instance in `config.rb`. You can see how the default 

`Players::Mpc` is written/used for guidance in writing others.

### Status

Bandit currently *functions*, that is, he chooses albums and makes 

adjustments according to his specs.

That said, I haven't used it long enough to know if the approach 

actually *works*.

[albumbler]: https://github.com/keenerd/albumbler

[mab]:       https://en.wikipedia.org/wiki/Multi-armed_bandit