Get Started

Prerequisites

View as Markdown

Verify the requirements for the workflow you plan to run before installing NeMo Voice Agent.

Hardware Requirements

Verify that your machine and interactive audio setup meet these hardware requirements:

RequirementDetail
GPUAn NVIDIA GPU and driver compatible with the CUDA wheel selected in pyproject.toml. The default is CUDA 13.0.
Model supportThe default NVFP4 language model requires hardware with FP4 support. Speech and text-to-speech models also use CUDA by default.
Audio devicesA microphone and speaker available to the browser for an interactive voice session.

Software Requirements

Install or make available the software required by the workflow you plan to run:

RequirementDetail
Operating systemLinux. install.sh installs system packages with apt-get. With another package manager, install the equivalent packages yourself.
PythonPython 3.12 or 3.13. The project configures uv to download and manage a compatible interpreter.
Node.js and npmRequired for the browser client. install.sh installs both on systems that provide apt-get.

Pre-Installation Checklist

Run these commands to confirm that the GPU and optional browser tools are available:

$nvidia-smi
$node --version
$npm --version

Troubleshoot Prerequisites

Do not run the installer inside a non-base conda environment. Run conda deactivate first. This prevents the conda compiler and Python headers from interfering with packages that build native extensions.

Next Steps

After the prerequisite checks pass, install the project or review the complete first-run workflow:

  • Installation creates the virtual environment and installs dependencies.
  • Quickstart starts the model server, voice-agent server, and browser client.