Skip to main content
This guide will help you get started using the OpenHome web dashboard. You can access your dashboard at app.openhome.com. OpenHome web dashboard OpenHome web dashboard From the dashboard, you can:
  • Create and manage your Agents, Abilities, and Voices, and install more from the Marketplace.
  • Talk to your Agents and review past conversations.
  • Build a voice-powered AI Twin of yourself.
  • Pair and manage an OpenHome DevKit.
  • Configure your account settings and the provider keys for Text-to-Speech, Large Language Model, and Speech-to-Text services.
This page documents every screen in depth. For a fast path to a working Agent, see Quickstart.

Access

Log in

Go to app.openhome.com, enter your email and password, and click Log in. You can also continue with Apple or Google. OpenHome login screen OpenHome login screen

Sign up

Click Sign up on the login screen to create a new account. The form asks for:
  • Username: a unique handle for your account.
  • Email: used to log in and receive notifications.
  • First name / Last name.
  • Password / Confirm password.
Check I have read and agree to the Terms & Conditions and Privacy Policy, complete the reCAPTCHA, then click Sign up. You can also sign up with Apple or Google, or click Continue as guest to try OpenHome without an account. OpenHome sign-up screen OpenHome sign-up screen The sidebar is the main way to move around the dashboard. Click the collapse arrow at the top to toggle it between icon-only and expanded. OpenHome dashboard sidebar expanded OpenHome dashboard sidebar expanded
  • Dashboard: your home screen, with the Quick-start Guide, Insights, and recommendations.
  • Agents: view, manage, and create your Agents.
  • Abilities: view, manage, and create your Abilities.
  • Voices: browse, preview, and create Voices.
  • AI Twin: create a voice-powered version of yourself.
  • OpenHome DevKit: manage a connected DevKit, or apply for one.
  • Create: Create New opens the unified Agent/Ability/Voice creation screen, My Creations lists what you’ve built.
  • Discover: Marketplace, browse and install Agents, Abilities, and Voices published by the community.
  • Activity: your recent conversations by Agent name, each with a Clear Conversation option.
The bottom of the sidebar shows your connected DevKit status (with a reconnect control), and your account name, which opens the profile menu (Settings, Help & Support, Report a problem, Logout). The top bar carries the sidebar collapse control, a theme toggle for switching between dark and light, and a Notifications bell. On the list pages, Agents, Abilities, and Marketplace, it also carries a Search box.

Dashboard home

The Dashboard is your home screen after logging in.
  • Quick-start Guide: three steps for a new account, Connect device, Create an agent, Add ability. Once you’ve made progress it gives way to Insights, showing your published Agent count and active Ability count.
  • Continue where you left off: Your recent drafts, each showing its type and state with a Resume button to pick it back up.
  • Developer tools: links to About OpenHome DevKit, SDK Docs, and Join Community.
  • Below that, tabs for Agents / Abilities / Voices and a For You row of recommended cards to install or try.
Dashboard showing Insights, Continue where you left off, and Developer tools Dashboard showing Insights, Continue where you left off, and Developer tools

Create New and My Creations

Create → Create New in the sidebar opens a single screen for building anything: describe what you want in the prompt box, then pick Agent, Ability, or Voice to set what gets built. The template grid below changes to match your choice, so selecting Ability shows Ability templates and Agent shows Agent templates. Create New page with Agent selected Create New page with Agent selected Below the templates, Discover what are people creating shows community creations you can install, with a Go to Marketplace shortcut. Create → My Creations lists everything you’ve built in one place.

Agents

The Agents page lists every Agent you can access. Agents page Agents page
  • Tabs: All, My agents, Installed agents, Default agents.
  • History: opens a Shared Agents dialog with a search box for finding Agents that have been shared with you.
  • Explore more: opens the Marketplace.
  • Filters: narrow the list. Grid / List view: switch the layout.
  • Each Agent card shows its avatar, name, tagline, author, chat count, and tags, with a Chat button and a More actions menu for editing or deleting it.

Create an Agent

Click Create Agent (or Create on a Dashboard card) to open the creation dialog:
  • Design Agent with AI: describe the Agent you want in your own words, and it’s built for you.
  • Pick from a Template: start from a pre-configured personality (grouped by theme, for example Hearth for a smart home assistant or Kindred for a companion) and customize it.
Create Agent dialog Create Agent dialog Choose a template for your Agent Choose a template for your Agent Either path opens the Agent workspace: an AI chat pane on the left for describing changes in plain language, and an editable form on the right. A red dot marks a section with required fields still outstanding. The section heading gets a checkmark once it’s complete. Agent Information section Agent Information section Agent Information:
  • Avatar: upload an image (PNG/JPG, 500KB max) or click Generate to create one with AI.
  • Agent name: a unique, identifiable name shown in the dashboard and Marketplace. Has its own Generate button.
  • Visibility & Sharing: Private (only visible to you) or Submit to Marketplace (submits for admin review, then appears in the Marketplace once approved).
  • Marketplace description: a short summary, only shown if published to the Marketplace.
  • Category: pick one, Companion, Education, Famous People, Games, Home, or Role Play.
  • Key tags: add tags to help others find your Agent in the Marketplace.
Behavior and Identity section Behavior and Identity section Behavior & Identity:
  • Starting message: the greeting spoken or shown at the start of a conversation.
  • Language: the language the Agent communicates in.
  • Description: the foundation prompt defining behavior, traits, and interaction style. Has an AI Rewrite button.
  • Prompt Modification: toggle whether OpenHome can adapt your prompt for the user-interaction flow.
Voice and Speech section Voice and Speech section Voice & Speech:
  • Voice: search or pick from Suggested for you, with a play button to preview each one, or click Create Voice.
  • Gender: the gender identity that shapes the Agent’s interaction style.
Model section Model section Model:
  • Base Ability: an Ability that auto-triggers when a call starts.
  • Text-to-Text Platform / Text-to-Text Model: the LLM provider and model.
  • Randomness (Temperature): slide right for more creative, less deterministic responses.
At minimum, fill in name, description, and category, then click Save Agent. Saving opens the Agent’s conversation view, see Conversations and Agent Settings.

AI Twin

Click AI Twin in the sidebar to open the Create Your AI Twin dialog:
  • Personality Image: use Gallery, Camera, or Generate with AI.
  • Personality Name.
  • Language.
  • Gender: Male, Female, or Other.
Create Your AI Twin dialog Create Your AI Twin dialog Name, Language, and Gender are required. The image is optional. Click Next and the Twin runs a short conversation, asking about your life, character, the topics it should cover, and the greeting it should use. Answer by voice, or click Toggle Chat to type your answers instead. It then clones your voice from your spoken answers and drafts the Twin’s starting message and personality prompt, which you can edit on a review screen before saving. For the full walkthrough, see AI Twin. Once saved, the Twin appears alongside your other Agents and opens the same conversation view, with the same Agent Settings described in Conversations and Agent Settings: A built AI Twin's conversation view with Agent Settings A built AI Twin's conversation view with Agent Settings
  • Conversation Setting: the same Interactive Interruption, Auto Interruption, and Interruption Sensitivity controls as any Agent.
  • Behavior Controls: Starting Message and Description prompt, generated from your spoken answers and editable here afterward.
  • Identity Controls: Agent Voice (a voice generated for the Twin during setup) and Agent Language.
AI Twin's Behavior Controls expanded, showing its generated Starting Message and Description prompt AI Twin's Behavior Controls expanded, showing its generated Starting Message and Description prompt There’s also a dedicated mobile app for building an AI Twin on your phone. See AI Twin for that guided setup.

Abilities

The Abilities page lists every Ability you can access. Abilities page Abilities page
  • Tabs: All Abilities, My Abilities, Installed Abilities, Marketplace Abilities.
  • Explore more: opens the Marketplace.
  • Each Ability card shows its icon, name, category (Skill, Agent Controlled, Background Daemon, or Local), description, an Enabled toggle, and its trigger word count, plus Share, Open code editor, and a More actions menu.

Create an Ability

Click Create Ability to choose how to build it:
  • Design Ability with AI: describe what you want in your own words.
  • Jumpstart with template: start from a ready-made Ability. Templates map directly to the ones in the OpenHome Abilities repository, Music Player, Wikipedia, OpenClaw, Smart Home, Hermes, and more.
Create Ability dialog Create Ability dialog Jumpstart with an Ability template Jumpstart with an Ability template Picking a template prompts for:
  • Ability name.
  • Trigger Words: the spoken phrases that activate it. Templates pre-fill a starting set, remove any with its x or add more.
Naming an Ability and reviewing its trigger words Naming an Ability and reviewing its trigger words Confirming opens the Live Editor: Live Editor for a newly created Ability Live Editor for a newly created Ability
  • Files: the Ability’s source files (for example main.py, README.md). New File and Upload File add to them, each file has a Delete file control, and Information and Documentation link out to reference material.
  • Code editor: edit the selected file directly. Its toolbar has Save, Download, Discard Changes, New Commit, and Commit History.
  • Settings, Triggers, and Local Abilities: panels for the Ability’s configuration.
  • Start Live Test: try the Ability immediately by voice, with Turn off speaker and Turn off mic beside it.
  • Logs: a console with LOGS, DEBUG, INFO, CRITICAL, ERROR, and WARNING views, plus Open AI Agent (an in-editor AI assistant), clear, minimize, and close controls.

Voices

The Voices page lists every voice you can use for an Agent. Voices page Voices page
  • Tabs: All, My voices, OpenHome voices, Public voices, Bookmarked.
  • Explore more: opens the Marketplace.
  • Each voice card shows a preview play button, its traits (for example young, confident), tone (for example calm - male), and language, with a bookmark toggle.
Create Voice offers two paths:
  • Design your voice with AI: describe the sound you want in your own words to create a brand-new voice.
  • Create voice with audio: upload audio files to build a voice, or clone your own.
Create Voice dialog Create Voice dialog

OpenHome DevKit

OpenHome DevKit in the sidebar is where a DevKit is paired and managed. Without one connected, the page offers Reserve your DevKit (apply for hardware) and Connect DevKit (pair one you already have). OpenHome DevKit page OpenHome DevKit page Once a DevKit is connected, its day-to-day controls live under Settings → DevKit. For hardware setup, onboarding, and troubleshooting, see What is OpenHome DevKit.

Marketplace

The Marketplace is where the community shares Agents, Abilities, and Voices. Open it from Discover → Marketplace in the sidebar. Marketplace page Marketplace page
  • Tabs: All, Agents, Voices, Abilities, Templates.
  • For You: a row of recommended cards based on your activity, each with author, chat count, tags, and a Chat button.
  • Browse by Category: category rows (Companion, Education, Famous People, Games, and more) to explore by theme.
  • Create: opens Create New.

Conversations and Agent Settings

Clicking Chat on an Agent, or saving a new one, opens its conversation view: a chat pane on the left (type a message, or use voice) and Agent Settings on the right. Agent conversation view with Agent Settings Agent conversation view with Agent Settings Agent Settings is organized into collapsible groups:
  • Conversation Setting: Interactive Interruption (interrupt the Agent while it’s speaking), Auto Interruption (handles interruptions automatically based on interaction cues), and an Interruption Sensitivity slider.
  • Behavior Controls: Starting Message and Description prompt, editable here directly, the same values set under Behavior & Identity when creating the Agent.
  • Identity Controls: Agent Voice and Agent Language.
Changes here apply to the live conversation. The header also has controls to share or delete the Agent.

Settings

Open Settings from the profile menu at the bottom of the sidebar. It has five tabs.

Profile

Settings: Profile tab Settings: Profile tab
  • Edit Profile, Change Password, Copy Clone Account Link (share a link that lets someone else create an account with the same Abilities and data), and Delete Account.
  • Email, Joined date, and your API Key (show, copy, or rotate it).
  • Appearance: toggle Dark Mode.
  • Community Sync: when enabled, your Agents stay synced with community updates.
  • Two-Factor Authentication: enable 2FA for an extra layer of account security.
  • User Info: view or edit your persistent memory files, user_profile.md (durable facts: name, role, location, preferences) and user_summary.md (a rolling summary of recent conversation context). These are injected into the Agent prompt by the memory background. Changes typically take effect on the next background cycle.

Configuration

Settings: Configuration tab Settings: Configuration tab
  • STT Platform & Model, TTT Platform & Model, TTS Platform & Model: the Speech-to-Text, Text-to-Text, and Text-to-Speech providers and models powering your Agents. Speech-to-Text offers Deepgram and ElevenLabs, Text-to-Text offers OpenAI, OpenRouter, and Venice, and Text-to-Speech uses ElevenLabs. See Voice and Model Configuration for every model each one offers.
  • Auto Sleep / Sleep Timeout: put the Agent to sleep after a period of silence.
  • Wake Word Mode / Wake Word: require a spoken wake word before the Agent responds. See Wake Word & Sleep Interaction for the full behavior.
  • Sleep Word: the phrase that puts the Agent to sleep on command.
  • OpenAI TTT Temperature, Frequency Penalty, Presence Penalty: tune response randomness, repetition, and topic focus.
  • Voice Stability / Voice Similarity Boost: how consistent the synthesized voice is, and how closely it matches the reference voice.
  • Utterance Threshold: the threshold, in milliseconds, for treating captured audio as a complete user utterance.

API Keys

Settings: API Keys tab Settings: API Keys tab
  • Default provider keys, in the order they appear: OpenHome, OpenAI, ElevenLabs, Assembly, OpenRouter, DeepGram, Scribe V2, and Venice. Use Edit to change one, or Restore to default.
Updating these keys means your Agents draw on the associated provider accounts and may incur charges. OpenHome is not responsible for costs from your own keys.
  • Third Party Keys: custom keys your Abilities depend on (for example a soundcloud_client_id). Click + Add to create one, or use the edit and delete icons on an existing key. See Custom API Keys for how Abilities read these at runtime.

Linked Accounts

Settings: Linked Accounts tab Settings: Linked Accounts tab Connect third-party services via OAuth so Abilities can act on your behalf without you pasting API keys individually.
  • Supported providers: Google, Slack, Discord, Tesla, Microsoft.
  • Under development: Reddit, Spotify, GitHub.
Abilities read the stored token through the SDK’s get_token() method. See Reading Linked Account Tokens with get_token() for the SDK-side reference.

DevKit

Settings: DevKit tab Settings: DevKit tab Manage a paired DevKit here. It is also listed in the sidebar with its name, local IP, and active Agent.
  • Power: whether the DevKit is connected, and a control to reconnect it. While it is disconnected, the rest of the tab stays empty.
  • Restart DevKit: reboot the device. The hardware revision is shown under the device name.
  • Abilities: how many are enabled on the DevKit, with Sync to push local Ability changes to it. See Syncing Local Abilities with the DevKit.
  • Agent: the Agent running on the device, with Auto start to launch it on power-on, Change agent to switch it, and Stop and Restart to control it.
  • Firmware: the running version, and a selector for switching to another available image.
  • MQTT: enable or disable the MQTT client. See Controlling MQTT Devices.
  • Home Assistant: connected device and area counts with Installed and Running status, plus Manage devices and Update. See Home Assistant on the DevKit.
  • Matter: connected device count with Installed, Running, and Server status, plus Add device.
  • Device IP: the DevKit’s address on your local network.
  • Device Usage: CPU, DISK, and RAM for the device, each as a percentage, an absolute value, and a recent trend.
The buttons below the card open the remaining settings: Microphone & devices, WiFi networks, MQTT config, Matter devices, Home Assistant, Refresh, Update API Key, and Factory reset. Matter devices pairs new hardware by QR code or pairing code, and maintains the Matter server with Clean duplicates and Restart server.
Factory reset erases all settings and restores the DevKit to its original state. Update API Key re-links the device: setting a different account’s API key moves the DevKit to that account.

See also