RunningHam Palace - Online Hamsters




This is my hamster, Ham. He loves running around at his place, the RunningHam Palace.
Few months ago, while I was visiting the MIT Media Lab, a friend of mine told me about Sushi, the online hamster; a fun project by Gershon Dublon in which a RaspberryPi counted the spins of the wheel through a sensor and served a website with the "running stats".

I live by myself, so I though it would be good for me having a pet... and even better to do something fun with it, so I adopted Ham and started the RunningHam project (@RunnerHam on twitter because RunningHam was taken :( )

Do you have a Hamster? do you want to track his running stats? here is what you need to do:

Teacher Notes

Teachers! Did you use this instructable in your classroom?
Add a Teacher Note to share how you incorporated it into your lesson.

Step 1: Get the Obvious Stuff

  • A hamster. just fall in love with one and adopt it, they are all awesome!
  • A nice place for him or her with a spinning wheel.
  • An internet connection via WiFi close to your hamster.

Step 2: Make the Electronics

  • Build the circuit board: Here you have my own schematics, feel free to use them. I usually make my own boards, so if you need help with that, let me know and I'll try to make you one... I know this might get a little crazy, but I'd love to see more connected hamsters in the world!
  • Arduino: that board is for an Arduino Nano, I know it is a little too much, but they are cheap and I have a lot of them.
  • ESP8266-01: This is the wifi module that will help you connecting to your network. It is actually possible to make this whole thing without the Arduino and just writing the code on the ESP8266, but the SDK wasn't available when I made this project.
  • AMS1117: The 3.3V regulator to power the ESP8266. Do not try to use the 3.3V on the arduino, it will just die on you because it doesn't supply enough current.
  • A3144: A hall sensor that will help you counting complete spins on the wheel
  • Magnet: You will need to put the magnet on the wheel and place the hall sensor about 1cm away on the wall.
  • KF2510 (1x5p, 1x4p, 1x3p, 1x2p): Typical molex connectors.
  • 3 LEDs: Make them any color you like.
  • 10K and 220Ohm resistors.

Step 3: Get the Software

  • Create a ThingSpeak account and make a new channel with, at least three fields:
    • Current Speed
    • Total Distance
    • Maximum Speed
  • Download the ESP8266 Arduino library and place it in the Arduino folder on your computer
  • Open the Arduino sketch and edit the lines with the comment //EDIT...
  • Upload the code to your new board and just wait for your hamster to start running!

Step 4: Make One and Let's Race!

Let me know if you have any question or in case you want to compete on an virtual hamster race!

You can check Ham's latest workouts and news on his twitter account (@RunnerHam) and his full running stats on his ThingSpeak channel



1 Person Made This Project!


  • Instrument Contest

    Instrument Contest
  • Make it Glow Contest

    Make it Glow Contest
  • STEM Contest

    STEM Contest

15 Discussions


3 years ago


How can I open these brd and sch files?

Can I use this board with 12 V PSU only? Should I plug it to USB charger?


3 years ago

Me gustaria implementarlo en la rueda de mi "Chispa" que ahora está con un ordenador de bici el cual marca 10-12kms durante 3-4horas cada noche!!!.

Pero me surgen algunos problemas...

- Imposible abrir los archivos .BRD .SCH con Eagle 6.2 (una imagen .JPG podría ayudar)

- Revisar conexiones y resistencia 10K del sensor Hall A3144 segun datasheet e imagen adjunta.

- Seria interesante añadir en el codigo arduino el sensor DHT11 / DHT22 que se observa previsto en la placa.

Un saludo y MILGRACIES!!!

2 replies
Yo sebaPelaM

Reply 3 years ago

Estoy preparando una nueva versión con algunos cambios, en breve publicaré todo :)

GO chispa GOYo seba

Reply 3 years ago

OK... ya hay rival !!!!


4 years ago on Introduction

"I keep on running but I'm not getting anywhere, but why?"

hello and congratulations. "The internet of animals" is coming, thanks to you ;)

My daughter has the small hedgehog ( living in the luxurious big plastic box apartment, with gym. His spinning wheel was squeezing all nights long, so we were interested about his running distance. I installed the cheap bike computer with many functions. Fortunately this little device supports spinning wheel diameter (5 in).

Unbelievable , but he runs 8-10 km every night, with the average speed 4,5 km/h.

1 reply

Wow! That is a lot of exercise!
It would be awesome if you could upload that data so we could start building an actual Internet of Animals... I loved the name :)
Ham says hello to your Hedgeho!


4 years ago on Introduction

Congrats on your new pet! I'm a big supporter of adopting and so many people just dump little guys like this when they get bored of them. Very impressive to see such a small animal running over 5k!

1 reply

This is so cool! It's very surprising to know how many kilometers make a hamster. I had one hamster and he was always on his wheel I always wander how much he ran. Now I can make an estimated guess. I'll keep your tutorial at hand in case I get another hamster. Thanks for sharing this!

1 reply

4 years ago on Introduction

Does the code take the diameter of the wheel into account, or are there numbers you have to change yourself?

3 replies

Reply 4 years ago on Introduction

Yes, It does! mine is 43cm.

It is another line with the //Edit comment on it... it just didnt fit in the picture, I'll add it to the image in a moment.