Holocube Emotes

Turn a GeekMagic holocube into your AI's face. Generate holographic character sprites, upload them to the device, then swap expressions in real-time based on agent/session state.

First-Time Setup

0. Find the device

Auto-discover holocubes on your network:

CODEBLOCK0

Output: INLINECODE0

If discovery fails, find the IP on the device's screen or your router's client list.

1. Generate sprites

Create a full emote sprite kit (requires nano-banana-pro skill with GEMINI_API_KEY):

CODEBLOCK1

Custom character:
CODEBLOCK2

This generates 7 emotes (neutral, happy, thinking, surprised, concerned, laughing, sleeping) as both static JPG and animated GIF, sized for the 240x240 display.

2. Upload to device

CODEBLOCK3

Flags:

• - --clear removes existing images (recommended — device has ~3MB storage)
• INLINECODE3 saves existing files before clearing
• INLINECODE4 auto-discovers if not provided, or specify manually

3. Configure TOOLS.md

Add the holocube IP and emote mappings to your workspace TOOLS.md for reference. See references/tools-example.md.

Daily Usage

Set emote directly

CODEBLOCK4

Set by agent state

CODEBLOCK5

Auto-select by time of day

CODEBLOCK6

• - 11pm–7am → sleeping
• 7am–9am → happy
• Rest of day → neutral

Check status

CODEBLOCK7

Heartbeat Integration

Add to HEARTBEAT.md to auto-manage the emote:

CODEBLOCK8

When to Set Emotes

Use these during normal agent operations:

Custom Slot

A reserved file adam-custom.gif on the device can be overwritten at any time for on-demand or one-off animations. Generate a GIF, upload as adam-custom.gif, then python3 holocube.py custom. Switch back to a standard emote when done.

Device Notes

• - Model: GeekMagic HelloCubic-Lite (240x240px glass display)
• Format: GIF (animated) or JFIF JPEG. Use Pillow for JPEG (ffmpeg lacks JFIF headers).
• Storage: ~3MB total. 6 animated GIFs use ~1.5MB, leaving ~500KB for custom slot.
• Art style: Dark/black backgrounds make glass disappear. Use glowing, holographic, neon elements.
• ⚠️ NEVER send /set?reset=1 — that's factory reset, wipes WiFi config.

Requirements

• - GeekMagic HelloCubic-Lite (or compatible) on local network
• Python 3 with Pillow (pip install Pillow)
• nano-banana-pro skill with GEMINI_API_KEY (for sprite generation only)
• INLINECODE25 (brew install uv) (for sprite generation only)