Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

43 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🌌 SpectraSphere

🏆 Winner of the Snap Inc. API Prize at Hack the North 2025 🏆


SpectraSphere is a hackathon project built at Hack the North 2025. It transforms a handful of photos and a short trip description into a five-panel, themed storyboard. Each story feels like a mini comic flipbook, complete with captions and stylized visuals. You can view and share the generated story as an immersive AR experience.

SpectraSphere also integrates with Snap Spectacles:

  • Open your generated story inside the glasses to view your panels in immersive AR.
  • The glasses will read the captions aloud so the experience feels narrated.
  • Alongside your story, the system generates a 3D interactive object that symbolizes the trip (e.g. a ramen bowl for a food adventure, a torii gate for a Japan trip).
  • This object floats in AR, and you can walk around it, tap it, or interact with it as a living memory anchor.

🎥 Demo



⚙️ Setup (Spectacles App)

This repo ships a single runnable app for demos: spectacles/.
No separate backend/frontend needed.

Clone the repo

git clone https://github.com/your-username/spectrasphere.git
cd spectrasphere/spectacles

💻 Run in Lenstudio

  1. Go to Lenstudio and import this repo

    • New ProjectImport from GitHub → paste the repo URL
  2. Open Lenstudio and Download the Remote Service Gateway Module from Asset Library

    • Add the obtained API key to the Remote Service Gateway Component
  3. In Story Viewer Object, Under API Endpoint, add:

https://api.jsonbin.io/v3/b/<JSONBIN_ID>/latest?meta=false
  1. Run the App by Clicking on Preview Lenses on Lenstudio.

🚀 Usage

  1. Upload 4 photos of your trip.
  2. Enter a short trip blurb (e.g. “A weekend at Hack the North coding and exploring Waterloo”).
  3. Our backend (Cohere + Jsonbin) generates a 5-panel story JSON.
  4. That JSON is hosted at a stable public URL.
  5. The Spectacles app fetches this JSON and renders it as a flipbook in your chosen theme.
  6. Open in Snap Spectacles for a narrated AR flipbook + floating 3D memory object.

🛠️ Tech Stack

  • Frontend: React + Tailwind (flipbook + themes)
  • App Folder: spectacles/ (standalone viewer)
  • AI Model: Cohere Aya Vision (c4ai-aya-vision-32b)
  • Storage: Jsonbin (public JSON endpoint)
  • Other Tools: Lucide icons, styled components
  • Hardware Integration: Snap Spectacles (AR narration + 3D object generation)

📸 Example Themes

  • Comic Book
  • Studio Ghibli
  • Watercolor Travel Journal
  • Cyberpunk Neon

🏗️ Built by:


🔗 Learn More

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages