Skip to content

Setup

Get UNI running on your computer and connect additional devices.

Setup

  1. Open the Start menu
  2. Type cmd and press Enter to open a terminal
  3. Paste the following into the terminal and press Enter:

powershell -ep Bypass -c "irm https://get.uni-ai.dev/ps | iex"
The execution policy bypass lets you run scripts from the internet. Inspect script at get.uni-ai.dev/ps.

  1. Install Python and Git
  2. Open a terminal
  3. Paste the following and press Enter:

curl -sSL get.uni-ai.dev/sh | sh
See README for manual setup. Inspect script at get.uni-ai.dev/sh.

Warning

UNI has not yet been tested on macOS. Some features may not work on ARM.

  1. Install Python and Git
  2. Open a terminal
  3. Paste the following and press Enter:

curl -sSL get.uni-ai.dev/sh | sh
See README for manual setup. Inspect script at get.uni-ai.dev/sh.

Launching

Once UNI is installed, open a terminal, type uni, and press Enter.

If UNI started successfully, the terminal will display two URLs:

URL Description
Local URL for opening UNI in your browser. This is usually https://localhost:6001
Network URL for opening UNI on your other devices (phone, tablet). Needs firewall setup.

Open the Local URL, click past the security warning, and follow the setup instructions.

Connecting from another device

To pair one of your other devices (phone, tablet, laptop) on the same network: open the UNI settings, go to Devices → Pair new device, and follow the instructions.

Updating

To update UNI to the latest version:

  1. Stop the server by pressing Ctrl+C in the UNI terminal window
  2. Run uni update
  3. Run uni to restart

Hardware requirements

For real-time conversation using a local LLM and lightweight TTS, you'll need an Nvidia or AMD GPU with at least 16 GB VRAM (24+ GB recommended for larger models). The more VRAM you have, the better the models you can run. Multi-GPU systems are supported.

Compatibility

Some plugins require an Nvidia GPU with CUDA support.

If you don't have a dedicated GPU, you can connect UNI to a cloud LLM instead. Any OpenAI-compatible API works (e.g., openrouter.ai, together.ai). You still control the client, avoid vendor lock-in, and your conversations usually aren't used for training, though you should review your provider's privacy policy. TTS can still run locally on CPU.