Skip to main content

Quick Start: Installation

Start with Get the app to find downloads and access instructions for your platform. Anyone can create an account and subscribe through Stripe. App availability depends on the platform and release channel; a subscription does not mean every store or package format is available. Check your platform's availability before purchasing a plan.

1. Choose Your Platform​

Meta Quest​

Follow the Quest access instructions in Get the app. If your release channel requires an invitation, accept it with the Meta account used on the headset, then install Telemus AI from My Preview Apps in the headset's Store or Library. You can accept an invitation on a phone, but the app installs and runs on Quest.

Windows​

Use the Windows installer listed in your account portal's Downloads section and follow its setup prompts. If no installer is listed, contact support for availability. Managed installations may use a package supplied by their administrator. A package prepared for Microsoft Store validation is not confirmation of Store availability.

For supported PCVR sessions, connect the headset to the Windows PC and select the appropriate OpenXR runtime before launching Telemus AI. Supported launch options include --vr, --pcvr, --quest-link, --air-link, --steamvr, --valve-index and --steam-frame. A launch option alone does not prove that the headset connected successfully; confirm the in-app session status.

The standalone Quest app and Windows PCVR app are separate installations. Steam Frame references describe supported Windows-hosted SteamVR use after validation, not standalone Steam Frame support.

macOS​

Use a Mac App Store link or signed, notarized direct-download package only when it is published for your release channel in Downloads. For a DMG, open it and drag Telemus AI into Applications. Unsigned or unnotarized packages are for local testing, not a recommended public install. macOS supports flat sessions; it does not support XR.

Linux​

Use the Linux package published for your distribution and release channel in Downloads; package formats vary by release. Follow its installation prompts and review requested access to networking, graphics, audio and files. Linux supports flat sessions, not XR.

Mobile and Web​

Use the Android or iOS store link or build listed for your release channel in Downloads. If none is listed, contact support for availability. iOS is flat-only. The Web workspace is experimental and browser capabilities vary. Use the hosted address supplied for your workspace, and do not add credentials to served files or build configuration. Web does not support XR.

WSL2 is intended for headless and terminal workflows. Use the native Windows app for desktop graphics or PCVR.

2. Configure Your Account​

  1. Create your account, verify your email, and sign in. Then launch Telemus AI and follow account linking in the first-run checklist. See Accounts, Plans and Licensing.
  2. Choose your comfort preferences and grant microphone access if you want voice.
  3. Connect a supported AI provider, or choose demo mode and connect later.
  4. Review optional channel connections before allowing messages from other people.

OpenAI is the default provider; other hosted and local options depend on your build. Provider subscriptions, API permissions and usage charges are separate from Telemus account access. See Configuration and Credentials.

3. Launch and Verify​

  • Confirm that the assistant and workspace are visible.
  • Ask a short question by text or voice. On desktop, use V for the supported voice input path; headset controls depend on your selected input mode.
  • Create a note, save the workspace, close the app and reopen it. Confirm the note remains present before relying on persistence for important work.
  • Check the connection and account status if AI or sync is unavailable.

On desktop systems with tray or menu-bar support, closing the main window can leave Telemus AI running. Use its tray/menu-bar item to restore the window or choose Quit Telemus AI to stop it. Where tray support is unavailable, closing the window exits the app.

Continue with First Run, Platform Support and Troubleshooting.