0.0.7 • Published 5 years ago

dwc-creature v0.0.7

Weekly downloads
3
License
ISC
Repository
github
Last release
5 years ago

creature

digital, peer-to-peer, creature

people help it move

design

the home

a place that others can be invited to

a raspberry pi 3 running scuttlebutt, which people can become friends with

the creature

a living thing that likes being shuttled from person to person

a raspberry pi zero running a custom scuttlebutt client, sharing its heartbeat and dna

a button to interact with the creature, changing its heartbeat and dna

their relationship

people interact with the creature by pressing the button

the button changes the creatures heartbeat

the heartbeat is shared with the home

anyone who is invited into the home sees the new heartbeat, and new dna

creating a home

Gather the following materials

  • computer with Docker installed
  • microSD card + microSD adapter
  • raspberry pi 3
  • copy of this repository

We use Docker to create and customize home.raspbian.img, which will be etched onto a microSD card for the Raspberry Pi. This lets us create and customize new homes from our computers instead of directly on the pi.

Start by installing docker for your platform.

Next, open up a terminal, and clone this repository somewhere

git clone https://github.com/jedahan/creature && cd creature

Now we are ready to create an home! It make take up to an hour to build everything.

make home.raspbian.img

Once the home image is built, we can etch it onto a microSD card.

Install etcher (or etcher-cli) and point it to the image:

sudo etcher home.raspbian.img

Put the microSD card into a raspberry pi, turn it on, and after a minute or two you should see a 'home' wifi network up.

creating a creature

Follow the same steps as above, but replace home with creature

making friends

The creature and home need to be 'friends' in scuttlebutt-speak for them to share information.

technical diagram

wireless diagram

  • creature => 'creature' wifi ssid <=> home <=> 'home' wifi <= people's cell phones

hardware diagram

  • button <= rpi zero <= wifi => rpi 3 <= ethernet => ubiquiti <= wifi => cellphones

software diagram

  • scuttlebutt-heartbeat => scuttlebot local => scuttlebutt network
  • scuttlebutt network => home webapp => cell phone browser

interaction diagram

nodes press button => heartbeat updates locally => scuttlebutt shares new heartbeat to network => scuttlebutt scuttles (shares with friends and friends of friends of home)