spiderlily - GitLite

KO | EN

gitlite — search

#git #ios #windows #dotnet #machine-learning #ai-agents #python #linux #docker #open-source

spiderlily

(★ 32)

No description available.

File Explorer

ZIP Download

- index.html
- README.md
- face_detector.tox
- face_filter_example.tox
- face_mapping_example.tox
- face_tracking.tox
- hand_tracking.tox
- image_classification.tox
- image_embeddings.tox
- object_tracking.tox
- pose_tracking.tox
.gitignore
InteractiveFlower.43.toe
README.md

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

Command Glossary

Commands referenced in this DOCs, explained below.

🔍

`git clone`

View Details ▼

Clone an existing repository.

git clone {{remote_repository_location}} {{path/to/directory}}

Clone an existing repository into a new directory (the default directory is the repository name):

git clone --recursive {{remote_repository_location}}

Clone an existing repository and its submodules:

git clone {{[-n|--no-checkout]}} {{remote_repository_location}}

Clone only the `.git` directory of an existing repository:

🔍

`https`

View Details ▼

This command is an alias of `http`.

tldr http

View documentation for the original command:

🔍

`python3`

View Details ▼

This command is an alias of `python`.

tldr python

View documentation for the original command:

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

An interactive spider lily that grows and blooms in response to your hands, using
MediaPipe hand tracking. It comes in two forms:

- **Web version** (`spiderlily-web/`) — a self-contained Three.js + MediaPipe
  visualiser that runs in the browser. This is the 3D visualiser.
- **TouchDesigner version** (`InteractiveFlower.43.toe`) — the original piece
  built in TouchDesigner.

Both react to the same gesture idea: one hand grows the plant, the other blooms
the flowers.

---

## Get the code

Clone the repo:

```bash
git clone https://github.com/cupidbity/spiderlily.git
cd spiderlily
```

That's all you need for the **web version**. For the **TouchDesigner version** you
also need to add the MediaPipe engine — see that section below.

---

## Web version (3D visualiser)

A single self-contained `spiderlily-web/index.html`. It pulls Three.js and
MediaPipe from a CDN, so there's no build step — but the webcam and hand tracking
require the page to be served over `http://localhost` or `https`, not opened as a
`file://` path.

### Open it

```bash
cd spiderlily-web
python3 -m http.server 8642
```

Then open **http://localhost:8642** in Chrome or Safari and **allow the camera**
when prompted. (Any static server works — `python3 -m http.server` is just the
simplest.)

### Use it

- **Left hand** — pinch out (spread thumb + index) to **grow** the plant
- **Right hand** — pinch out to **bloom** the flowers
- The webcam shows in the bottom-right corner with a live tracking overlay; the
  flowers render over the full screen.
- Press **`D`** to toggle a debug auto-bloom cycle (no hands needed), **`H`** to
  hide the HUD, and drag / scroll to orbit and zoom the camera.

Full interaction details, keys, and tweakable parameters are in
[`spiderlily-web/README.md`](spiderlily-web/README.md).

---

## TouchDesigner version

`InteractiveFlower.43.toe` is the TouchDesigner project file.

### Open it

1. Install **TouchDesigner** (free non-commercial license) from
   [derivative.ca](https://derivative.ca/download).
2. Get the **MediaPipe engine** (see below) into the `toxes/` folder.
3. Double-click **`InteractiveFlower.43.toe`**, or launch TouchDesigner and use
   **File → Open** to select it.
4. Press the play/perform controls to run it; a connected webcam drives the hand
   tracking.

### MediaPipe dependency

The TouchDesigner version needs **everything in the `toxes/` folder**. The tracking
toxes come with the repo; the one you have to add is the large **MediaPipe.tox**
engine:

Download **[MediaPipe.tox](https://github.com/cupidbity/spiderlily/releases/download/assets/MediaPipe.tox)**
and put it in the **`toxes/`** folder alongside the others. Once all the toxes are
in `toxes/`, the hand tracking will work.

`MediaPipe.tox` is the free **MediaPipe for TouchDesigner** plugin:
https://github.com/torinmb/mediapipe-touchdesigner

---

## Which one should I run?

- Want to try it instantly in a browser with just a webcam? → **Web version.**
- Want the full TouchDesigner piece to edit or perform? → **TouchDesigner version.**

---

## Reference

Tutorial used as reference while building this:
https://www.youtube.com/watch?v=KGALeCnTTbg&t=32s