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.
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.
  1. Sign in and open My Devices in your account.
  2. Click Add / Flash New Display.
  3. Plug your display into your computer with a USB-C data cable.
  4. Click Connect & Setup Display and approve the browser's serial port permission prompt.
  5. Choose your display model from the dropdown so the matching firmware is selected.
  6. Click Flash and watch the progress bar — don't unplug the device.
This uses the Web Serial API, so it only works in Chrome or Edge on desktop.
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.