Get Started

Begin hacking in minutes

  1. Pick up a Particle Photon (with headers!)
  2. Configure your Photon using Particle’s Setup guide, then swap your own Photon for the one that’s in your Hub. Note: only Hubs with serial numbers that start with an ‘H’ have a Photon in them.
  3. Sign in on the Particle website, go to the Particle build platform and load up the CleverPet library. Click on an example, hit the lightning bolt, and BOOM! You’ve now got a customized CleverPet Hub!

Setting up reporting

  1. Go to and copy the provided spreadsheet. Then click the share button on the top right. In the share window enter the email address of the hackerpet report server:, and click OK.
  2. Go to the integrations page on the Console of your Particle account.
    Click on New Integration.
    Then pick a Webhook.
    Choose Custom Template.
    Copy the following code block into the textbox and don’t forget to replace <ADD_YOUR_SHEET_ID_HERE> with your sheet id.

         "event": "hckrpt",
         "responseTopic": "hook-response/{{{PARTICLE_EVENT_NAME}}}/{{{PARTICLE_DEVICE_ID}}}",
         "errorResponseTopic": "hook-error/{{{PARTICLE_EVENT_NAME}}}/{{{PARTICLE_DEVICE_ID}}}",
         "url": "<ADD_YOUR_SHEET_ID_HERE>",
         "requestType": "POST",
         "noDefaults": true,
         "rejectUnauthorized": true,
         "responseTemplate": "",
         "json": {
             "event": "{{{PARTICLE_EVENT_NAME}}}",
             "data": "{{{PARTICLE_EVENT_VALUE}}}",
             "coreid": "{{{PARTICLE_DEVICE_ID}}}",
             "published_at": "{{{PARTICLE_PUBLISHED_AT}}}"

    Click Create Webhook.

Advanced methode: You can also configure the webhook with the particle-cli and the following command, after adding your sheet id to the particle_webhook.json config file:

$ particle webhook create docs/particle_webhook.json

What now?

The fun stuff is all in the examples folder – if your dog or cat already understands how the lights and touchpads work, and you’re immediately interested in a new game for your pup to try, try the WhackAMole game: by playing with the speed that the lights change you can make the game easier or harder!

We’re still in beta

Hackerpet is still new and should still be considered as being in “beta”. If you find bugs or have ideas for improvement, please let us know but creating a new issue or pull request, or by sending us an email.