Skip to content

Fabri-D/descriptive_morphology

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 

Repository files navigation

3D Insect Narration Demo (Plotly + Piper TTS)

This repository contains a small demonstration app that combines:

  • Interactive 3D insect models rendered with Plotly
  • Offline text-to-speech narration generated with Piper
  • A lightweight Python application (app.py)
  • A short demo video showing the result

The goal of the project is to explore scientific-style audiovisual narration for 3D specimens, fully offline and reproducible.


🎥 Demo

A short video demonstration is included in this repository:

  • demo_video.mp4

The video shows:

  • 3D insect visualization
  • Camera interaction
  • Narration generated locally using Piper TTS

🐞 3D Models Attribution

The 3D insect models used in this demo were obtained from Adobe Stock via the following project page:

The Art of 3D Insects
https://www.behance.net/gallery/96254495/The-Art-Of-3D-Insects

According to the project description:

“It is a collaboration between Adobe and The Natural History Museum, London, led by Kimberly Potvin.
The project follows an initiative to digitize over 80 million specimens from the Museum's collection.
A pack of 3D insect models was released for free use via Adobe Stock.”

All .obj models were sourced from that collection.
The models themselves are NOT included in this repository and must be obtained from the original source.

This repository only contains:

  • Code
  • A demo video
  • Documentation

🗣️ Voice & Narration

All narration heard in the demo video was generated offline using Piper Text-to-Speech:

No cloud TTS services were used.
No voice data was uploaded or streamed externally.


🧠 Purpose of the Project

This demo is a technical and exploratory prototype, intended to show:

  • How 3D scientific assets can be narrated programmatically
  • How fully offline TTS pipelines can be integrated into visualization tools
  • A potential direction for museum, educational, or research-oriented interfaces

It is not a commercial product and not an official Adobe or museum project.


📦 Repository Contents

  • app.py — main application code
  • demo_video.mp4 — short demo video
  • README.md — this document

⚠️ Legal & Usage Notes

  • 3D models remain the property of their respective rights holders.
  • This repository does not redistribute any Adobe Stock assets.
  • Users are responsible for complying with the original licenses when downloading and using the models.
  • The demo video is provided for illustrative and educational purposes only.

✍️ Author

Developed by Fabricio Dante
Experimental visualization & offline narration prototype.


🔮 Future Work

  • Expanded narration logic per specimen
  • Metadata-driven scientific descriptions
  • Multi-language offline narration
  • Integration with larger interactive visualization systems

License

The source code is released under the MIT License.

3D models are provided by Adobe Stock in collaboration with the Natural History Museum, London, and are used here for demonstration and educational purposes. They are not covered by the MIT License.

About

Interactive 3D exploration of insect morphology using real specimen–based models, focused on descriptive structure rather than artistic stylization.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages