System Requirements
- Control4 OS 3.0.0 or later
- Windows PC on the same LAN (or VLAN trunk) as the Controller to host the Ophira Voice Service
- Communication Agent added in Composer Pro
- Identity Agent user created for Ophira
Voice Service (.exe) Install Instructions
- Download Voice.AI Bridge and Voice.AI Button from DriverCentral and add them to Composer.
- From DriverCentral, click the Ophira_Voice_Service.exe link. Installer hosting site direct link:
www.origami-intelligence.com/download
- Click Download — the download starts automatically. The installer is self-signed; the download may need to be allowed (“Keep”).
- Run the installer. After install completes, a web browser opens the Ophira WebUI (
host_IP:8080 or localhost:8080). Startup time reflects system hardware.
- Sign in / create an account.
Composer Pro Setup
Add the Communication Agent
Add the Communication Agent inside Composer Pro if it is not already present in the project.
Identity Agent — Create New User
- Inside Control4 Composer Pro, select Agents.
- Select Add, double-click Identity.
- Select Add User.
- Enter a username.
- Enter a password.
- Confirm the password.
- Select Create.
VoiceAI Bridge Driver
- Download and install Ophira_VoiceAI_Bridge.c4z and load it in Composer.
- In System Design, select the driver and go to Properties.
- Enter the Ophira (Host PC) IP address.
- Enter the Control4 Director IP address.
- Enter the Identity Agent Username and Password created above.
- Optional: set Persona to change the name of Ophira.
- Under Actions, select Idle State.
Verify voice connection status
Go to the Ophira WebUI at localhost:8080 or Host_IP_Address:8080 and confirm the connection status shows online and connected.
Properties
Version (read-only)
Current driver version.
Cloud Status (read-only)
DriverCentral cloud license status.
Automatic Updates [ Off | On ]
Standard DriverCentral automatic update toggle.
Persona
The assistant’s name. Change it to rename Ophira for this project.
Debug Mode [ Off | Print | Log | Print and Log ]
Enable diagnostic output in the Lua Output tab and/or the Director log.
Ophira (Host PC) IP
IP address of the Windows machine running the Ophira Voice Service. Must be reachable from the Controller.
Ophira (Host PC) HTTP Port [ default: 8080 ]
HTTP port for the Ophira service API and WebUI.
Control4 Director IP
IP address of the Control4 Controller (Director). Pushed to the Ophira service so a fresh install connects without touching the WebUI.
Identity Agent Username / Password
Credentials of the Identity Agent user created for Ophira. Pushed to the Ophira service for Director authentication.
Pairing Status (read-only)
Shows whether the driver has successfully pushed its configuration to the Ophira service.
Troubleshooting
| Status | Check |
|---|
| Online and connected | Perform a test call. |
| Offline / not connected | Check the LAN connection — the host PC must be on the same LAN or VLAN trunk as the Controller. Check the Control4 Identity Agent username and password. Check the driver properties for Director IP and Ophira Host IP. Restart the Ophira Voice Service — select Restart on the WebUI. |
Support
- DriverCentral — 1.720.504.9021 — Submit Ticket — Live Chat
www.origami-intelligence.comsupport@origami-intelligence.com
Changelog
Version 11
- Documentation tab rebuilt as native HTML (previous PDF export rendered blank in Composer)
Version 10
Version 9
- Driver pushes Director and voice credentials to the Ophira service — single configuration surface