Loomy Voice Desktop

Talk to your AI agents in real time. Like WhatsApp calling, but for AI.

Step 1 of 4

How would you like to install?

⚡

Super Easy

One command. Everything installs automatically. For non-tech users.

🐳

Docker

One container. Runs anywhere. For advanced users.

🛠️

Manual

Clone the repo and run yourself. Full control.

Step 2 of 4 — Super Easy Install

Copy this into Terminal

This one command downloads, installs, and starts everything. Your mic becomes a live voice channel to your AI agents.

          Click to copy
          bash <(curl -fsSL https://loomy-voice-desktop.loomyloo.app/install.sh)
        

What this does:

Checks for Git and Node.js
Clones the project into ~/.loomy-voice-desktop (hidden folder)
Installs server dependencies
Starts the voice proxy on port 98472
Prompts for Deepgram API key

Step 2 of 4 — Docker Install

Docker (runs anywhere)

Use this if you already have Docker installed.

          Click to copy
          docker run -p 98472:98472 -e DEEPGRAM_API_KEY=*** ghcr.io/loomisgitarrist/loomy-voice-desktop:latest
        

Or build from source:

          Click to copy
          git clone https://github.com/Loomisgitarrist/Loomy-Voice-Desktop.git && cd loomy-voice-desktop && docker build -t loomy-voice . && docker run -p 98472:98472 loomy-voice
        

Step 2 of 4 — Manual Install

Manual Setup

For developers who want full control.

          Click to copy
          git clone https://github.com/Loomisgitarrist/Loomy-Voice-Desktop.git ~/.loomy-voice-desktop && cd ~/.loomy-voice-desktop && npm install
        

Then create your .env file:

          Click to copy
          cp .env.example .env && nano .env
        

Add your Deepgram API key, save (Ctrl+O, Enter, Ctrl+X), then start:

          Click to copy
          npm start
        

Step 3 of 4

Get Your API Key

The proxy needs a Deepgram API Key to turn your voice into text and your agent's text into voice.

Go to console.deepgram.com
Sign up or log in (free $200 credit)
Go to API Keys → Create API Key
Copy the key (starts with 3bddee...)
Paste it into your .env file as DEEPGRAM_API_KEY=***

Alternatives:

Use OpenAI Realtime instead (higher quality, more expensive):

Step 4 of 4

You're Ready!

🎉

Once your proxy is running, come back here and click Connect below.

Proxy: ws://localhost:98472/ws

Health: Not running

Agents detected: 0