Practical overview
When it fits
Use Amica when the conversational character and spoken interaction are central to the experience, or when building and configuring that kind of interface.
Who it is for
- People who want to interact with an AI through a customizable 3D character.
- Developers configuring a character interface with chat, speech or vision components.
Documented uses
- Hold spoken conversations with a 3D character.
- Customize a character by importing a VRM file and adjusting its voice.
- Connect the interface to a selected chat backend and configure text-to-speech options.
Requirements & limits
The README says Amica can be tried on mobile, tablet or desktop. Local development requires installing the project packages; using OpenRouter as the chat backend requires an API key.
- Amica is the character interface; chat, speech, voice activity detection and 3D rendering are supplied by configurable technologies.
- The README documents multiple chat and text-to-speech choices rather than requiring one named provider.
- Local web development uses npm scripts, while desktop application development uses Tauri.
- Most of the project is MIT-licensed, but 3D models and images follow their authors’ respective licenses.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Start Amica’s local development server
Set up the repository and start its documented web development server.
Before you start
- The Amica GitHub repository
- npm
Steps
Clone or download the repository.
Run the command below to install packages.
npm installRun the command below.
npm run devVisit
http://localhost:3000.
Expected outcome
The development server starts, and the repository directs users to localhost:3000 to check it.
Guide limitations
- This guide covers local development setup, not a production deployment.
- Additional configuration may be needed for the chosen chat or speech services.
Configure OpenRouter as the chat backend
Set the documented OpenRouter settings for Amica’s chat backend.
Before you start
- A local Amica checkout
- An OpenRouter API key
Steps
Create or edit
.env.localin the project.Set
NEXT_PUBLIC_OPENROUTER_APIKEYto the OpenRouter API key.Optionally set
NEXT_PUBLIC_OPENROUTER_URLandNEXT_PUBLIC_OPENROUTER_MODEL; the documented defaults arehttps://openrouter.ai/api/v1andopenai/gpt-3.5-turbo.
Expected outcome
The documented OpenRouter chat-backend settings are present in Amica’s local configuration.
Guide limitations
- The API key is required for this backend option.
- The instructions cover configuration only and do not verify a successful connection.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 11 October 2026
- Original website title
- semperai/amica · Official homepage title · retained in its source language

