The source files for awkward has to be placed in a folder named awkward in your homefolder to be able to run awkward programs.
further you have to have ruby 1.9 installed.
To run an awkward program type the following command:
ruby ~/awkward/awkward.rb file_name.aww
given that you're currently in the same folder as your file, otherwise just type the path to it instead.