Hardware + AI + Music

Miracle Ornament

AI-powered Christmas ornaments that write, sing, and perform personalized carols — right on the tree. Snap a photo, pick a vibe, and thirty seconds later your ornament is performing a one-of-a-kind carol that has never existed before.

View All Projects

What Is It

A hardware + software platform that generates personalized Christmas carols using Claude AI, performs them with ElevenLabs voice synthesis, and displays synchronized karaoke lyrics on a touchscreen ornament.

How Does It Work

Describe what you want or snap a photo — Claude writes a custom carol, ElevenLabs sings it with character-level timing, and the ornament performs it with synchronized lyrics and snow particles.

How Can It Help You

Create unforgettable holiday moments. Every carol is unique — about your family, your year, your inside jokes. Heartfelt, funny, or full roast mode.

Full-Stack Hardware Product

From Photo to Performance in 30 Seconds

What if your Christmas ornament could write a song about your family? About the year you had, the inside jokes, the chaos of holiday dinner — and then sing it back to you with a full instrumental? Miracle Ornament makes it real.

  • Claude AI writes custom verses and choruses from photos or text prompts
  • ElevenLabs sings with character-level timing for karaoke sync
  • AI-composed instrumentals in Classic, Jazz, Rock, Country, Lo-fi, or Children's
  • Motion-reactive snow particles respond to real accelerometer data
  • Generate shareable links — no app required for recipients

Onboard Hardware

  • ESP32-S3 dual-core MCU with WiFi + Bluetooth
  • 3.5" IPS Touchscreen 480x320 capacitive display for lyrics & UI
  • I2S Audio full-range speaker with Class-D amplifier
  • 6-Axis IMU accelerometer + gyro for motion-reactive interactions
  • Haptic Motor DRV2605L driver for tactile feedback synced to music
  • Camera Module for photo-inspired carol generation on-device
  • LiPo Battery USB-C charging — runs untethered on the tree

How It Works

Four steps from idea to a carol that's never existed before

1

Prompt It

Open the iOS app and describe what you want — or just take a photo and let Claude's vision model figure it out. Choose a vibe: Merry, Nostalgic, Loving, Funny, or Roast. Pick a music style.

2

Generate

Claude writes a custom verse and chorus. ElevenLabs sings it with character-level timing data. A matched instrumental is composed in your chosen genre. Everything syncs to the millisecond.

3

Perform

The ornament lights up. Lyrics scroll across the 3.5" IPS touchscreen in time with the music. Snow particles cascade down the display, responding to motion. Shake to pause. Shake again to resume.

4

Share

Generate a unique link and send your carol to anyone. They get the lyrics, the audio, and the full experience — no app required. Every carol is one-of-a-kind.

Ornament Shell Designs

AI-generated, 3D-printed decorative shells with precision-carved internal pockets for the electronics

🔥

Fireplace

Cozy hearth with stockings and warm glow. Landscape orientation with front-facing display window.

🍬

Candy House

Gingerbread fantasy in portrait orientation. Frosted details with candy cane accents.

🌳

Log Cabin

Rustic woodland with half-cylinder log exterior. Snow-dusted roof and chimney detail.

The Complete Platform

iOS app, cloud backend, and embedded firmware — a full-stack product from prompt to performance

iOS App

  • Claude Sonnet 4 with vision support and 10 holiday themes
  • Full ornament simulator with snow physics — no hardware required
  • BLE device manager for pairing, WiFi provisioning, and playlist sync
  • Song library with local and cloud storage
Built with: SwiftUI + CoreBluetooth + StoreKit 2

Cloud Backend

  • Async generation pipeline: Claude API + ElevenLabs TTS + music
  • Token-based device auth — no API keys on-device
  • Unique share tokens with public carol pages
  • Admin dashboard with real-time stats and revenue tracking
Built with: Netlify Edge + Neon Postgres

Embedded Firmware

  • Standalone mode — generates carols over WiFi without a phone
  • I2S audio with shared BCLK/WS clock architecture
  • BLE-connected operation for real-time streaming and control
  • Motion-reactive particles from live accelerometer data
Built with: Arduino/ESP-IDF + minimp3

Technical Highlights

Engineering decisions that make the magic possible

Hardware Engineering

Shared I2S Clocks

Mic + amp share BCLK/WS — saves 2 GPIOs

Custom PCB

2-layer 70x100mm designed in KiCad

Pocket Carving

Algorithmic mesh hollowing via pymeshlab

3D Printed Shells

PLA/PETG with M2/M2.5 assembly

Software Intelligence

Character-Level Sync

Per-character TTS timing for karaoke

📷

Vision-to-Carol

Claude Vision interprets photos into songs

Snow Physics

40+ particles with drift & accumulation

🔗

Standalone Mode

Generates carols over WiFi — no phone needed

The Stack

Swift SwiftUI CoreBluetooth StoreKit 2 Claude Sonnet 4 ElevenLabs TTS ESP32-S3 Arduino/ESP-IDF I2S Audio KiCad 9 JLCPCB OpenSCAD Meshy AI pymeshlab Netlify Edge Neon Postgres React TypeScript
8
Tech Layers
3
Shell Designs
6
Music Genres
5
Mood Modes

Full-Stack From Tree to Cloud

Production hardware fabricated. iOS app functional with full simulator mode. Cloud backend deployed with admin monitoring. Three ornament shell designs printed. A complete product spanning iOS, embedded systems, PCB design, 3D printing, AI integration, and cloud infrastructure.

Explore All Projects →