Fixed some Markdown formatting and moved the Buzz README to the correct location.
This commit is contained in:
parent
589d3e8ccb
commit
8068cd1900
|
@ -1,4 +1,4 @@
|
||||||
# Buzz Ruby Sample #
|
# Buzz Ruby Sample
|
||||||
This is a simple starter project written in Ruby which provides a minimal
|
This is a simple starter project written in Ruby which provides a minimal
|
||||||
example of Buzz integration within a Sinatra web application.
|
example of Buzz integration within a Sinatra web application.
|
||||||
|
|
||||||
|
@ -6,7 +6,7 @@ Once you've run the starter project and played with the features it provides,
|
||||||
this starter project provides a great place to start your experimentation into
|
this starter project provides a great place to start your experimentation into
|
||||||
the API.
|
the API.
|
||||||
|
|
||||||
## Prerequisites ##
|
## Prerequisites
|
||||||
Please make sure that all of these are installed before you try to run the
|
Please make sure that all of these are installed before you try to run the
|
||||||
sample.
|
sample.
|
||||||
|
|
||||||
|
@ -20,7 +20,7 @@ sample.
|
||||||
-- dm-sqlite-adapter
|
-- dm-sqlite-adapter
|
||||||
-- google-api-ruby-client
|
-- google-api-ruby-client
|
||||||
|
|
||||||
## Setup Authentication ##
|
## Setup Authentication
|
||||||
|
|
||||||
This API uses OAuth 2.0. Learn more about Google APIs and OAuth 2.0 here:
|
This API uses OAuth 2.0. Learn more about Google APIs and OAuth 2.0 here:
|
||||||
http://code.google.com/apis/accounts/docs/OAuth2.html
|
http://code.google.com/apis/accounts/docs/OAuth2.html
|
||||||
|
@ -32,27 +32,27 @@ Or, if you'd like to dive right in, follow these steps.
|
||||||
- Click the button labeled "Create an OAuth2 client ID"
|
- Click the button labeled "Create an OAuth2 client ID"
|
||||||
- Give your application a name and click "Next"
|
- Give your application a name and click "Next"
|
||||||
- Select "Web Application" as the "Application type"
|
- Select "Web Application" as the "Application type"
|
||||||
- Under "Your Site or Hostname" select http:// as the protocol and enter
|
- Under "Your Site or Hostname" select "http://" as the protocol and enter
|
||||||
"localhost" for the domain name
|
"localhost" for the domain name
|
||||||
- click "Create client ID"
|
- click "Create client ID"
|
||||||
|
|
||||||
Edit the buzz.rb file and enter the values for the following properties that
|
Edit the buzz.rb file and enter the values for the following properties that
|
||||||
you retrieved from the API Console:
|
you retrieved from the API Console:
|
||||||
|
|
||||||
- oauth_client_id
|
- `oauth_client_id`
|
||||||
- oauth_client_secret
|
- `oauth_client_secret`
|
||||||
|
|
||||||
Or, include them in the command line as the first two arguments.
|
Or, include them in the command line as the first two arguments.
|
||||||
|
|
||||||
## Running the Sample ##
|
## Running the Sample
|
||||||
|
|
||||||
I'm assuming you've checked out the code and are reading this from a local
|
I'm assuming you've checked out the code and are reading this from a local
|
||||||
directory. If not check out the code to a local directory.
|
directory. If not check out the code to a local directory.
|
||||||
|
|
||||||
1. Start up the embedded Sinatra web server
|
1. Start up the embedded Sinatra web server
|
||||||
|
|
||||||
$ ruby buzz.rb
|
$ ruby buzz.rb
|
||||||
|
|
||||||
2. Open your web browser and see your activities! Go to http://localhost:4567/
|
2. Open your web browser and see your activities! Go to `http://localhost:4567/`
|
||||||
|
|
||||||
3. Be inspired and start hacking an amazing new web app!
|
3. Be inspired and start hacking an amazing new web app!
|
|
@ -15,7 +15,8 @@ formatted data into Google Storage.
|
||||||
1 - You must first create the bucket you want to use. This can be done
|
1 - You must first create the bucket you want to use. This can be done
|
||||||
with the gsutil function or via the web UI (Storage Access) in the Google
|
with the gsutil function or via the web UI (Storage Access) in the Google
|
||||||
APIs Console. i.e.
|
APIs Console. i.e.
|
||||||
`$ gsutil mb gs://BUCKET`
|
|
||||||
|
$ gsutil mb gs://BUCKET
|
||||||
|
|
||||||
OR
|
OR
|
||||||
|
|
||||||
|
@ -25,12 +26,13 @@ and create your bucket there.
|
||||||
2 - We now load the data you want to use to Google Storage. We have supplied a
|
2 - We now load the data you want to use to Google Storage. We have supplied a
|
||||||
basic language identification dataset in the sample for testing.
|
basic language identification dataset in the sample for testing.
|
||||||
|
|
||||||
`$ chmod 744 setup.sh`
|
$ chmod 744 setup.sh
|
||||||
`$ ./setup.sh BUCKET/OBJECT`
|
$ ./setup.sh BUCKET/OBJECT
|
||||||
Note you need gsutil in your path for this to work.
|
Note you need gsutil in your path for this to work.
|
||||||
|
|
||||||
If you have your own dataset, you can do this manually as well.
|
If you have your own dataset, you can do this manually as well.
|
||||||
`$ gsutil cp your_dataset.csv gs://BUCKET/your_dataset.csv`
|
|
||||||
|
$ gsutil cp your_dataset.csv gs://BUCKET/your_dataset.csv
|
||||||
|
|
||||||
|
|
||||||
In the script, you must then modify the datafile string. This must correspond with the
|
In the script, you must then modify the datafile string. This must correspond with the
|
||||||
|
@ -51,8 +53,8 @@ API. You can also set it up so the user can grant access.
|
||||||
|
|
||||||
First, run the google-api script to generate access and refresh tokens. Ex.
|
First, run the google-api script to generate access and refresh tokens. Ex.
|
||||||
|
|
||||||
`$ cd google-api-ruby-client`
|
$ cd google-api-ruby-client
|
||||||
`$ ruby bin/google-api oauth-2-login --scope=https://www.googleapis.com/auth/prediction --client-id=NUMBER.apps.googleusercontent.com --client-secret=CLIENT_SECRET`
|
$ ruby bin/google-api oauth-2-login --scope=https://www.googleapis.com/auth/prediction --client-id=NUMBER.apps.googleusercontent.com --client-secret=CLIENT_SECRET
|
||||||
|
|
||||||
Fill in your client-id and client-secret from the API Access page. You will
|
Fill in your client-id and client-secret from the API Access page. You will
|
||||||
probably have to set a redirect URI in your client ID
|
probably have to set a redirect URI in your client ID
|
||||||
|
@ -81,7 +83,8 @@ At this, point, you should have
|
||||||
loading the generated .yaml file
|
loading the generated .yaml file
|
||||||
|
|
||||||
We can now run the service!
|
We can now run the service!
|
||||||
`$ ruby prediction.rb`
|
|
||||||
|
$ ruby prediction.rb
|
||||||
|
|
||||||
This should start a service on `http://localhost:4567`. When you hit the service,
|
This should start a service on `http://localhost:4567`. When you hit the service,
|
||||||
your ruby logs should show the Prediction API calls, and print the prediction
|
your ruby logs should show the Prediction API calls, and print the prediction
|
||||||
|
@ -91,4 +94,3 @@ This sample currently does not cover some newer features of Prediction API such
|
||||||
as streaming training, hosted models or class weights. If there are any
|
as streaming training, hosted models or class weights. If there are any
|
||||||
questions or suggestions to improve the script please email us at
|
questions or suggestions to improve the script please email us at
|
||||||
prediction-api-discuss@googlegroups.com.
|
prediction-api-discuss@googlegroups.com.
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue