Help Center
Everything you need to sign up, set up your device, and get the most out of your Smart 8-Ball.
Getting Started & Signup
Click Sign Up Free from any page and enter your email and a password.
Every new account automatically starts on the 7-Day Trial plan, which unlocks
full voice AI features immediately — no credit card required to try it.
The trial gives you complete access to Voice AI Assistant mode — conversational Q&A, live
web search, follow-up memory, and the email/PDF tools — on every device linked to your
account, for 7 full days from signup. Classic 8-Ball mode is always free and
is never affected by the trial ending.
At the end of Day 7, your account moves to a
LOCKED state for AI features only.
Your 8-Ball will display a short on-screen message letting you know to pick a plan from your
account page. Shake-to-answer classic mode keeps working the entire time, with no interruption.
Free plan: unlimited classic 8-Ball mode, forever, on any number of your devices.
Paid AI plans: add the voice assistant — conversational AI, live search, memory, and email/PDF delivery. Pricing and plan options are shown on your account's Billing page once signup is live.
Paid AI plans: add the voice assistant — conversational AI, live search, memory, and email/PDF delivery. Pricing and plan options are shown on your account's Billing page once signup is live.
No. Signup and the 7-day trial don't require payment details. You'll only need to add a
payment method (via PayPal) if you choose to continue on a paid AI plan after the trial.
Setting Up Your Device
Our firmware currently targets the Waveshare ESP32-S3-Touch-AMOLED-1.75" round
display (466×466, dual mics, speaker, 6-axis IMU). More affordable AMOLED boards will be added
over time — anything we support will appear in the device picker during flashing.
- Sign in and open My Devices in your account.
- Click Add / Flash New Display.
- Plug your display into your computer with a USB-C data cable.
- Click Connect & Setup Display and approve the browser's serial port permission prompt.
- Choose your display model from the dropdown so the matching firmware is selected.
- Click Flash and watch the progress bar — don't unplug the device.
During the browser flashing handshake, your device's unique hardware MAC address is read
directly from the chip and automatically registered to your logged-in account — no manual
entry needed. That MAC address is what we use for OTA updates, plan checks, and any messages
sent to that specific display.
Right after flashing completes, the setup tool prompts you for your Wi-Fi network name and
password and sends them to the device over the same USB connection. Your 8-Ball reboots and
connects straight to your account — no extra app or hotspot step required.
Yes — click Add / Flash New Display again for each device. Give each one a
nickname (like "Living Room" or "Office Assistant") so they're easy to tell apart on your
My Devices dashboard.
Yes, from My Devices you can rename a device's nickname at any time or remove it from your
account. Removing a device unlinks its MAC address but doesn't erase the firmware already
on it — classic mode keeps working.
Using Your 8-Ball
Just shake or tap the device and ask your question out loud (or silently) — the screen
animates and reveals a classic randomized answer. No account, Wi-Fi, or active plan is
required for this mode.
With an active plan, trigger listening mode on the device and just speak your question
naturally. The holographic core turns bright cyan while listening, amber while thinking, and
reacts to the audio while speaking the answer back to you. It's voice-only — there's no
on-screen text chat.
Yes. The assistant keeps short-term memory for your device during a session, so you can ask
something like "What are good restaurants in Zanesville, OH?" and then follow up with
"Can you email those to me?" without repeating yourself.
Yes — just ask. If you request a list, guide, or recipe be sent to you, the assistant emails
it to the address on your account. If you ask for it as a document, it's generated as a clean
PDF attachment automatically.
No — image generation is intentionally disabled on this platform. If you ask the assistant to
draw or create an image, it will let you know that feature is restricted on this device.
Classic shake-to-answer mode works fully offline. Voice AI mode needs an internet connection
since it relies on cloud speech, language, and search services.
Yes — this is the Bring Your Own Key (BYOK) option. Add your own API key under
Account Settings and the assistant will route requests through your key instead of our
system default.
Billing & Plans
Paid AI plans are billed as recurring subscriptions through PayPal. You can
view, change, or cancel your plan anytime from your account's Billing page.
If a subscription payment fails, is suspended, or is canceled, AI access is automatically
locked across all of your devices until the payment issue is resolved or a new plan is
selected. Classic 8-Ball mode is never affected.
From your Billing page, choose a different plan or cancel your subscription. Changes to your
PayPal subscription are reflected on your account automatically once PayPal confirms the
update.
Troubleshooting
- Make sure you're using Chrome or Edge on a desktop computer (Web Serial isn't supported on mobile or in Firefox/Safari).
- Use a USB-C data cable, not a charge-only cable.
- Try a different USB port, and check Windows Device Manager / your OS's port list for the device.
- Close any other program (like a serial monitor) that might already be holding the port open.
This means AI features need a plan selected on your account — sign in and visit Billing to
choose one. Classic 8-Ball mode keeps working the whole time this message is shown.
Devices periodically check in with our servers using their MAC address and receive an
Over-The-Air (OTA) update automatically when one is available for their exact hardware model —
no need to re-flash over USB for routine updates.
Double-check your Wi-Fi password was entered correctly during setup, and confirm you're on a
2.4GHz network (most ESP32-S3 boards don't support 5GHz-only networks). You can re-run the
setup tool from My Devices to re-enter Wi-Fi credentials without reflashing firmware.
Privacy & Data
Your spoken question is streamed to our cloud for speech-to-text and response generation, then
the reply is streamed back as audio to your device. Classic 8-Ball mode doesn't send any audio
anywhere.
Yes — reach out through our support form and we'll process account
and data deletion for you.