Skip to main content
You can visit your dashboard by going to app.openhome.com
The web dashboard allows you to:
  • View, create, and modify Agents and Capabilities associated with your account, as well as explore the public Marketplace.
  • Create and manage conversations and review conversational history with your installed Agents.
  • Configure system settings and manage provider keys for external services like Text-to-Speech, Large Language Models, and Speech-to-Text vendors.
Our dashboard is powered by the OpenHome SDK, allowing you to directly use the same functionality provided by the OpenHome SDK in your preferred application.

Access

To use the web dashboard, you’ll need to log in or create an account if you haven’t signed up yet.

Logging In

  1. Visit app.openhome.com.
  2. Enter your Email and Password.
  3. Select Log in to access your account.
  4. Alternatively, you can sign in using your Google account: Select Sign in with Google.
Login

New User Registration

If you’re new to OpenHome, follow these steps to create an account:
  1. Select Sign Up to create a new account.
  2. Fill out the required account information and select Sign up.
  3. Alternatively, you can sign up using your Google account by selecting Sign up with Google.
Signup
  • Capabilities: View your installed Capabilities that add new skills, tools, or abilities to your Agents. Capabilities enhance the functionality of your Agents, giving them specialized skills such as controlling smart home devices, fetching information from the web, or performing specific tasks. You can easily install these capabilities to your existing Agents or create new ones to suit your needs.
  • Agents: Manage your collection of Agents that are pre-installed within the platform. Each Agent has its own set of configurations, behaviors, and voice settings, designed to handle different use cases. From assistants for personal productivity to specialized agents for enterprise applications, you can modify, customize, or create new Agents to fit your unique preferences and requirements.
  • Marketplace: Explore a wide range of additional Agents and Capabilities developed by the OpenHome community. The Marketplace allows you to browse, install, and customize Agents and Capabilities that extend the platform’s versatility. Whether you’re looking for a ready-to-use solution or inspiration for your own projects, the Marketplace offers a constantly growing selection of community-created resources.

cap_per_mar_bar

Conversational Dashboard

The Conversational Dashboard is your central hub for interacting with the Agents you’ve installed. Here, you can engage in real-time conversations with your AI agents, testing their behavior and functionality. Whether you’re issuing commands, asking questions, reviewing conversational history or testing specific Capabilities, this screen lets you explore how your Agents respond and adapt. Here you can also test the functionality of different Capabilities integrated into your Agents, ensuring they work seamlessly and as expected. This is where you can refine and optimize the conversational experience for your specific use cases.

Start a Conversation

To begin interacting with an Agent, click the conversation button in the center. This will initiate a new conversation with the selected Agent, allowing you to test responses, behaviors, and capabilities.

Voice Response Indicator

At the top of the dashboard, there is a waveform indicator that lets you know your selected Agent is responding. The pulsing light reflects the voice output, visually confirming that the system is speaking back to you. If you don’t hear anything:
  • Check your device’s and/or browser volume settings to ensure it’s not muted.
  • Verify that Auto Responses are enabled in the settings, ensuring that the Agent is set to respond aloud (see Audio & Microphone Control settings below).

speaking_riv

Audio & Microphone Controls

  • Audio Button Toggles audio on or off. Use this if you don’t want to hear spoken responses.
  • Microphone Button Mutes or unmutes your microphone, depending on your interaction preference.

Manual Interrupt

enables interruption during a conversation, useful for situations where you want to stop an Agent mid-response. Adjust the Interrupt Sensitivity slider to control how easily the system accepts interruptions, giving you more flexibility during conversations.

Agent Settings

The Agent Settings panel is located on the right side of the conversation window. This panel allows you to modify and update agent-related settings dynamically during a conversation. The settings include Conversation Controls, Behavior Controls, and Identity Controls.

personality_settings

Conversation Settings

Control key aspects of the agent’s interaction during a conversation.
  • Auto Interrupt: Toggle this setting ON/OFF to allow or prevent the agent from automatically interrupting the conversation when required.
  • Alerts: Enable or disable alert notifications for the agent’s activities.
  • Interrupt Sensitivity: Adjust the sensitivity level of conversation interruptions using the slider bar. The sensitivity level determines how quickly interruptions occur based on conversational cues.

conversation_settings

Behavior Controls

Define the behavior and purpose of the agent by configuring its prompts and starting messages.
  • Starting Message: Customize the greeting or initial message that the agent uses to begin conversations.
  • Description Prompt: Provide a detailed description of the agent’s traits and behavior.
  • Purpose Prompt: Specify the purpose or role of the agent in the interaction.

behaviour_control

Identity Controls

Modify the voice and language of the agent for a more customized interaction.
  • Agent Voice: Select a voice for the agent from the dropdown menu.
  • Agent Language: Choose the language the agent uses for conversations.

identity_controls

Dynamic Agent Updates

These settings allow users to dynamically update the agent during a live conversation. Any changes made in the Behavior Controls or Identity Controls are reflected immediately, ensuring seamless adaptability during interactions.

OpenHome API Key

You can find your API key under Profile > Settings > API Keys.. This key is crucial for authenticating with the OpenHome platform and linking your activities with the system.

Conversation Modes: Voice & Text

  • The dashboard supports both voice and text-based conversations.
  • You can engage in voice-based conversations by starting a conversation, unmuting your device’s microphone, and speaking your commands directly into it.
  • You can use the text input box on the lower right to type out your messages, making it easier to test Agent responses in text form.
  • Type a text command and send it to your Agent in the text box at the bottom right of the page.

send_message

Agent Selection

  • Choose from your list of Agents to engage in a conversation. Each selected Agent will be ready for interaction within the dashboard.
  • Conversation Settings: Adjust settings such as Auto Interrupt and other Agent-specific toggles to fine-tune how the AI responds during conversations.

my_personalities_bar

Conversation History

  • Your conversation history is available on the center. This allows you to review previous interactions and see how an Agent has responded in past conversations, providing context for ongoing interactions.
  • Use the Trash can icon on the top right to delete your conversational history

history

Settings

In the lower left corner of the Conversational Dashboard you can configure your default dashboard settings, adjust your profile, and manage provider keys (for integrating external services like Text-to-Speech or Speech-to-Text).

Profile Settings

On your Conversational Dashboard, select Profile > Settings settings_button to manage your account settings.

profile_settings

Optionally, you can also Logout of your account from the Profile menu.

Model Configuration Settings

In this settings section, you can customize the providers powering your Agents and fine-tune their interactions. By adjusting these settings, you can optimize speech processing, response generation, and voice output to meet your specific needs. This gives you control over each component’s functionality, allowing you to tailor the interaction experience to your preferences.

Settings Overview

  • STT Model (Speech-to-Text Model): Select the model that will convert speech input into text.
  • STT Platform: Choose the platform that provides the Speech-to-Text service (e.g., Assembly).
  • TTT Model (Text-to-Text Model): This is the large language model that will process the transcribed text and generate a response (e.g., GPT-4).
  • TTT Platform: Choose the provider for the Text-to-Text processing (e.g., OpenAI).
  • TTS Model (Text-to-Speech Model): Select the model that converts text responses back into speech. The selected voice model will dictate how the Agent sounds (e.g., “eleven_turbo_v2”, “eleven_monolingual_v1”).
  • TTS Platform: Choose the platform providing the Text-to-Speech service (e.g., ElevenLabs).
  • Play Filler Audios: Toggle this setting to play short filler sounds while the system processes speech, indicating it’s working on generating a response.
  • Auto Sleep: Enable or disable automatic sleep mode, which will turn off the Agent after a period of inactivity.
  • FuzzyWuzzy Threshold: Adjust the sensitivity of the text-matching algorithm. A higher threshold makes the system stricter when matching text input, while a lower threshold makes it more flexible.
  • Auto Sleep Timeout One: Set the time (in seconds) before the Agent will confirm inactivity.
  • Auto Sleep Timeout Two: Set the time (in seconds) for the second stage of sleep, where the Agent will fully shut down if inactive.
  • OpenAI TTT Temperature: Controls the randomness of responses from the LLM. A lower temperature (closer to 0) will make responses more focused and deterministic, while a higher temperature (up to 1) makes responses more creative and varied (Wild Card).
  • OpenAI TTT Frequency Penalty: Adjusts how often words or phrases can repeat in responses. A higher value will reduce repetition.
  • OpenAI TTT Presence Penalty: Similar to the frequency penalty, but it discourages the model from introducing new, irrelevant topics. A higher value encourages the LLM to stick to the subject at hand.
  • Voice Similarity Boost: Adjusts how closely the chosen voice matches its intended sound. A higher boost makes the voice more consistent.
  • Voice Stability: Controls the stability of the voice output. A lower value makes the voice more varied, while a higher value increases consistency (makes the voice more monotone).

API Key Settings

OpenHome uses various providers to communicate with TTT (Text-to-Text), LLM (Large Language Models), TTS (Text-to-Speech), and STT (Speech-to-Text) vendors. You can set your provider keys to customize the services that power your Agents. These keys will be used to access the models that power all of your OpenHome Agents globally.
  • Select the Edit Button button to edit your desired API key field.
  • Select the Save Button button to finalize your changes.

API_keys_config

Note: When you update these API keys, your Agents may consume credits from the associated services linked to the keys, which could result in charges from the respective providers. OpenHome is not responsible for these charges.

Profile Settings

This screen allows you to manage and update your profile settings within OpenHome.
  • Click the Edit Button button to modify any of the information, including username, email, and other personal details.
  • Click the Save Button button to finalize any setting changes.

Profile Information Overview

  • User Name: This is the unique username associated with your OpenHome account.
  • First Name & Last Name: Displays the personal name details linked to your account. These can be edited to update your profile.
  • Email: The email address associated with your OpenHome account. This is where you’ll receive notifications and account-related updates.
  • Sync with Community: This indicates whether your account is synced with the OpenHome community.
  • About: A section where you can provide a brief description about yourself or your account for the OpenHome community.
  • API Key: Your unique private API key used for accessing OpenHome services.
  • Change Password: Update or change your current account password.
  • Joined: This shows the date and time when you initially created your OpenHome account.

Persistent Memory Files (Profile > User Info)

The Profile tab now includes editable persistent memory files used by the Agent memory system.
  • user_profile.md: durable user facts (name, role, location, preferences)
  • user_summary.md: rolling summary of recent conversation context
From User Info, select the file tab, then use View or Edit to inspect or update content. Important notes:
  • These files are persistent (in_ability_directory=False) and survive reconnects.
  • The memory background injects them into the Agent prompt.
  • Changes typically appear in behavior after the next background cycle (~60-90 seconds).