Skip to content
/ amica Public

Amica is an open source interface for interactive communication with 3D characters with voice synthesis and speech recognition.

License

Notifications You must be signed in to change notification settings

semperai/amica

Folders and files

NameName
Last commit message
Last commit date

Latest commit

870b3e2 Β· Feb 20, 2025
Dec 15, 2023
Nov 7, 2023
Nov 28, 2023
Nov 29, 2023
Feb 20, 2025
Feb 20, 2025
Nov 30, 2023
Oct 1, 2024
Feb 20, 2025
Nov 24, 2023
Dec 22, 2023
Feb 20, 2025
Oct 1, 2024
Nov 28, 2023
Oct 19, 2024
Oct 1, 2024
Oct 26, 2023
Dec 22, 2023
Nov 1, 2023
Dec 7, 2024
Dec 15, 2023
Dec 22, 2023
Dec 7, 2023
Dec 2, 2023
Nov 28, 2023
Nov 28, 2023
Oct 19, 2024
Feb 20, 2025
Feb 20, 2025
Apr 28, 2023
Oct 29, 2024
Oct 29, 2024
Oct 29, 2024
Nov 4, 2023
Nov 30, 2023
Apr 28, 2023

Repository files navigation

If you like our project, please give us a star ⭐ on GitHub.

twitter License Hits GitHub issues GitHub closed issues

Amica allows you to converse with highly customizable 3D characters that can communicate via natural voice chat and vision, with an emotion engine that allows Amica to express feelings and more. Customize her any way you want with any AI technology.

Try Amica here on mobile, tablet or desktop

For Windows Users: Please create a new folder for Amica during installation to prevent the unintentional deletion of other files during uninstallation.

We just released Amica 1.2 with lots of new features. Docs will be further updated soon, watch the video to learn about what Amica 1.2 offers:

Video Title

You can import VRM files, adjust the voice to fit the character, and generate response text that includes emotional expressions.

The various features of Amica mainly use and support the following technologies:

To see tutorials on configuring any of these with Amica please visit the official Amica documentation.

πŸ› οΈ Installation and running

To run this project locally, clone or download the repository.

git clone [email protected]:semperai/amica.git

Install the required packages.

npm install

After installing the packages, start the development web server using the following command:

npm run dev

Once started, please visit the following URL to confirm that it is working properly.

http://localhost:3000

πŸ“ Configuration

Most of the configuration is done in the .env.local file. Reference the config.ts file for the available options.

OpenRouter Configuration

To use OpenRouter as a chat backend, set the following environment variables in your .env.local file:

  • NEXT_PUBLIC_OPENROUTER_APIKEY: Your OpenRouter API key (required)
  • NEXT_PUBLIC_OPENROUTER_URL: Custom OpenRouter API URL (optional, defaults to https://openrouter.ai/api/v1)
  • NEXT_PUBLIC_OPENROUTER_MODEL: Default OpenRouter model (optional, defaults to openai/gpt-3.5-turbo)
amica
β”œβ”€β”€ .env.local
β”œβ”€β”€ src
β”‚   β”œβ”€β”€ utils
β”‚   β”‚   └── config.ts

πŸ“¦ Desktop Application

Amica uses Tauri to build the desktop application.

To develop the desktop application, use the following command:

npm run tauri dev

πŸ“– Documentation

View the documentation for more information on how to configure and use Amica.

πŸ“œ History

This project originated as a fork of ChatVRM by Pixiv:

https://pixiv.github.io/ChatVRM

πŸ”’ License

  • The majority of this project is released under the MIT license as found in the LICENSE file.
  • Assets such as 3D models and images are released under their authors respective licenses.

✨ Star History

Star History

πŸ€— Contributors