Pyechonest is moving to github. Come join us!

Everything will remain here for the short term, but all future updates will happen on github. At some point we will shutdown this project.

Tap into the Echo Nest's Musical Brain for the best music search, information, recommendations and remix tools on the web.

Pyechonest is an open source Python library for the Echo Nest API. With Pyechonest you have Python access to the entire set of API methods including:

• artist - search for artists by name, description, or attribute, and get back detailed information about any artist including audio, similar artists, blogs, familiarity, hotttnesss, news, reviews, urls and video.
• song - search songs by artist, title, description, or attribute (tempo, duration, etc) and get detailed information back about each song, such as hotttnesss, audio_summary, or tracks.
• track - upload a track to the Echo Nest and receive summary information about the track including key, duration, mode, tempo, time signature along with detailed track info including timbre, pitch, rhythm and loudness information.

Getting Started

1. Install Pyechonest
2. Get an API key - to use the Echo Nest API you need an Echo Nest API key. You can get one for free at developer.echonest.com
3. Set the API key - you can do this one of two ways:
• set an environment variable named ECHO_NEST_API_KEY to your API key
• Include this snippet of code at the beginning of your python scripts:

        from pyechonest import config
        config.ECHO_NEST_API_KEY="YOUR API KEY"

4. Check out the docs and examples in the README.

Install

There are a few different ways you can install pyechonest:

• run: "easy_install pyechonest"
• Download the zipfile from the downloads page and install it.
• Checkout the source: "svn checkout http://pyechonest.googlecode.com/svn/trunk/ pyechonest" and install it yourself.

Example

Here's a snippet of python that will show all of the artists that are similar to 'Bikini Kill'. (assuming you have already setup your api key!)

from pyechonest import artist
bk_results = artist.search(name='bikini kill')
if bk_results:
    bk = bk_results[0]
    print "Artists similar to: %s:" % (bk.name,)
    for similar_artist in bk.similar:
        print "\t%s" % (similar_artist.name,)
else:
    print "Uh oh, couldn't find bikini kill"