RPM-Avatar

An interactive 3D AI companion with customizable personality and voice.

Features

• 3D Avatar: Create and customize avatars using Ready Player Me
• AI Chat: Real-time conversations with personality-driven responses
• Personality System: Adjust Big Five personality traits (openness, conscientiousness, extraversion, agreeableness, emotional sensitivity)
• Voice Configuration: Multilingual TTS with customizable voice parameters
• Multilingual: English and Spanish support

Quick Start

git clone https://github.com/FeliGR/RPM-Avatar.git
cd RPM-Avatar
npm install
npm start

Required backend services

This UI depends on three backend services. Make sure they’re running (locally or via Docker) before using the app:

• Audio Engine (TTS/STT): https://github.com/FeliGR/Audio-Engine
• Dialog Orchestrator (chat flow): https://github.com/FeliGR/Dialog-Orchestrator
• Persona Engine (personality/profile): https://github.com/FeliGR/Persona-Engine

Configure their URLs via the .env variables below.

Configuration

Create a .env file:

REACT_APP_PERSONA_ENGINE_URL=http://localhost:5001
REACT_APP_DIALOG_ORCHESTRATOR_URL=http://localhost:5002
REACT_APP_AUDIO_ENGINE_URL=http://localhost:5003
REACT_APP_RPM_CLIENT_ID=your_rpm_client_id

Ready Player Me Setup

1. Get your App ID from Ready Player Me Developers
2. Add it to your .env file as REACT_APP_RPM_CLIENT_ID

Docker

docker-compose up -d

Tech Stack

• React 19.1.0
• Babylon.js 8.x
• Ready Player Me
• Socket.io
• i18next

Screenshots