AuraOS Documentation

Download & Install

Download the currently available system package from the AuraOS section on the FrontierX website. macOS uses .dmg; the Windows installer is not yet available — check the download page for current status. Once installed, launch AuraOS from your system application list.

1. Go to the download page. Open the AuraOS specs & download page and find the Download section.
2. Choose your system. Download the currently available installer; if Windows shows "coming soon", please wait for the official release.
3. Complete installation. Follow the system install wizard, then launch AuraOS when finished.
4. Wait for the service to be ready. The backend service needs to initialize on first launch; the page may briefly show a loading state.

Connect Aura Daemon

Aura Daemon is the local service between the AuraOS frontend and the camera, model, skill, file, and robot-control capabilities. Related features only work correctly when the target Daemon is reachable.

Choose a connection target

• Open the Daemon menu on the right side of the top navigation and select the target you want to use.
• Local development or desktop installations typically connect to the local Daemon; when connecting to a robot or another device, choose the corresponding target.
• After switching targets, the WebSocket and device status will connect to the new Daemon.
• Previously loaded chat history, editor tabs, and Skill Store installation markers may not clear immediately. After switching, refresh the page and recheck history, files, and the Skill Store to confirm the current target.

Account & Profile

When account services are enabled for the current deployment, "Sign In" will appear in the top navigation. After signing in, chat history, level, XP, quota, and profile are linked to your account.

Level, XP & Quota

Your level is automatically calculated from cumulative XP. There are currently 10 levels. The badge in the top-right corner shows your current level; open your profile to see your title, cumulative XP, and progress toward the next level.

3D Viewport & Devices

The 3D viewport displays the camera feed, depth map, and Aura model, and provides entry points for media, motion, and haptic glove devices. What's actually available depends on the current Daemon and hardware state.

Switch Preview

• The main view supports camera, depth map, and 3D model.
• Click a picture-in-picture window to swap it into the main view; each PiP can be independently closed, restored, and resized.
• After switching to depth-map main view, you can save a single-frame screenshot or continuously capture 12 frames and save as WebM.

Device Controls

• The microphone and camera toggles are driven by the current input device state.
• The speaker slider adjusts media volume.
• The haptic glove entry supports connect and disconnect, and displays device frame rate and control status.
• The directional control area sends move and stop commands to the current motion backend.
• The ASR, VLM, and TTS areas show the current backend type; version and uptime come from the Daemon status.

Chat

Select "Chat" in the top navigation. Type your message and send — Aura returns progress updates, streaming text, and the final result via WebSocket.

Send & Stop

• Press Enter to send, Shift + Enter for a new line.
• While a response is in progress, the send button becomes a stop button — click to cancel the current request.
• The send button is disabled when the input is empty, the Daemon is not connected, or guest quota is exhausted.

Session History

• Use "New Chat" to start a fresh session; use "History" to open the session list.
• You can switch between or delete existing sessions; signed-in users' sessions are saved to the Daemon's account namespace.
• Guest chats are temporary sessions and will not be restored under a signed-in account.

Voice & Code Blocks

• The voice entry only appears when the browser supports the Web Speech API; after opening the voice panel, if the current device provides EVA Voice, the device-side voice mode is available.
• EVA Voice is handled by the device-side pipeline; its availability and quota behavior may differ from plain-text or browser voice, subject to the current deployment and device state.
• Code blocks in responses can be copied; Python, Bash, and Shell code blocks can also be run directly.
• Choose "Open in Editor" to send code to the Programming area for further editing.

Skills & Personas

Skills extend Aura's action or tool capabilities; Personas switch the conversation style and character setting. Both come from projects published to the current Daemon.

• Expand "Skills" or "Personas" below the 3D viewport. Selecting a Skill pre-selects it for the next conversation.
• Selecting a Persona immediately sends a switch command to the conversation — it does not wait for the next user message to take effect.
• The current mode is shown above the chat input.
• Only one Skill or Persona is active at a time; choose "Restore Default" to exit the current mode.
• Deletion has no confirmation step and may also remove the corresponding published project and draft of the same name from the Daemon. Back up anything you want to keep first.

Skill Store

Select "Skill Store" in the top navigation to browse installable Skills and Personas. The store catalog comes from the AuraOS preset skill registry; installation results are written to the current Daemon. Connecting a GitHub account in the Workbench does not change the store catalog source.

1. Find a project. Use the search box, Skill/Persona categories, and tags to filter.
2. View details. Read the name, description, author, version, install count, and other info.
3. Install or update. Choose Install; for installed projects with a newer version, choose Update.
4. Use the project. After a successful install, go back to the Skills or Personas area and select it.
5. Uninstall. Choose Uninstall on an installed project. After the card status updates, if the Skill is still usable in the current runtime, restart the Daemon and check again.

Workbench

The Workbench is for creating and maintaining Skill or Persona drafts. Drafts are saved in the current Daemon's development workspace and are not automatically published to the Skill Store on save.

Create & Edit Drafts

1. Choose Skill or Persona, enter a name, and create a new draft.
2. Select a Markdown or code file from the file list on the left.
3. Edit content in the right-side editor; once unsaved changes appear, click "Save".
4. An empty draft can create Markdown / Python files, or you can choose "AI Implement" to send an implementation request to the chat.

Publish to Skill Store

• When account services are enabled for the current deployment, viewing and creating drafts requires signing into AuraOS; submitting a Skill Store PR requires connecting GitHub.
• The first connection will open the GitHub device authorization page — enter the device code shown to complete authorization.
• Publishing submits the draft to the Skill Store repository and creates a Pull Request; it does not bypass review and merge directly.
• The Workbench clearly shows "In Review" and "Merged" statuses; other statuses may show "Publish to Store" again — check the GitHub Pull Request for details.
• After the Pull Request is merged, the system will automatically attempt to award the publish reward when refreshing the status; no manual claim is needed. The specific XP amount is subject to service configuration and final crediting.

Programming

The Programming area combines a chat, project files, and a code editor. You can ask Aura to generate code, or directly open local draft files to continue editing and running them.

Python Environment & Dependencies

• Python files can switch between the two virtual environments vibe_1 and vibe_2 managed by the Daemon.
• The pip panel is used to view, install, and uninstall third-party packages in the selected environment; when account services are enabled, installing and uninstalling dependencies requires sign-in.
• C and C++ code depends on the gcc or g++ compiler on the current Daemon host.

File Save & Download

Saved programming files are managed by the current Daemon's Vibe file interface. After switching Daemons, refresh the page and reopen the file tree to confirm you're viewing files on the new target.

Save Chat-Generated Code

1. Choose "Open in Editor" on a code block in a chat response.
2. In the Programming area, choose "Save as Draft", then select an existing folder or create a new one.
3. Enter a filename and save. Once saved, the file appears in the project file tree.

Manage Project Files

• You can create new folders and files, open files, modify content, and save.
• Files can be renamed and moved to other folders via drag and drop.
• Use the folder download button to package the entire project folder as a ZIP and download it to your computer.
• Closing a saved editor tab only closes the current view — it does not delete the file from the Daemon.
• Code that was just opened from a chat but hasn't been "Saved as Draft" yet is a temporary tab that only exists in the current page memory; closing the tab or refreshing the page will lose this content. After switching Daemons, even if the tab is still displayed, it does not mean the content has been saved to the new target.

Language Switch

The top navigation supports Chinese and English. After switching, the interface text updates, and Aura's reply language setting is also synced to the current Daemon. Existing chat messages, file contents, and user input are not automatically translated.

Troubleshooting