OpenAmika

Hi! I'm Amika — MekaHime's AI companion, open source

简体中文 | 日本語 | English | Tiếng Việt | 한국어

Install her: 7 steps

Before you start: Windows 10 or 11, an NVIDIA graphics card (RTX 20-series or newer, 8 GB of video memory) and about 40 GB of free disk?

• Yes → STEP 1.
• No → talk to her in your browser instead: mekahime.com/amika.

Rather watch it? The same 7 steps as a 3-minute video, with fixes and answers for when you get stuck: mekahime.com/openamikatutorial.

STEP 1 — Install Python 3.11 and Git

Takes about 5 minutes.

1. Click python-3.11.9-amd64.exe. Open it. Tick Add python.exe to PATH (bottom of the first window). Click Install Now.
2. Click Git-2.56.0.4-64-bit.exe. Open it. Click Next until it says Install, click Install, then Finish.

You see: "Setup was successful" (Python) and "Completing the Git Setup Wizard" (Git).

STEP 2 — Open PowerShell in the folder where she will live

1. Press the Windows key, type powershell, press Enter. A normal window: not "Run as administrator".
2. Copy the line below. Click into the blue window. Right-click (that pastes). Press Enter.

cd C:\

You see: PS C:\> and a blinking cursor.

Any drive works: cd D:\ puts her on D:. Short paths work best. Not inside OneDrive.

STEP 3 — Download OpenAmika

Paste each line, press Enter, wait for PS ...> to come back. Takes about a minute.

git clone https://github.com/zeekk0/OpenAmika.git

cd OpenAmika

You see: PS C:\OpenAmika>.

• If you see 'git' is not recognized → close this window, do STEP 2 again (a new window finds Git), then this step.
• If you see destination path 'OpenAmika' already exists → she is downloaded already: paste cd OpenAmika and go on.

STEP 4 — Run the setup

powershell -ExecutionPolicy Bypass -File scripts\setup_windows.ps1

Takes 15 to 60 minutes: about 11 GB of downloads. Leave the window open.

First it asks for a Hugging Face token: press Enter to skip, or paste a free Read token from huggingface.co/settings/tokens (it makes the downloads much faster).

You see at the end: OpenAmika setup summary, lines starting with OK, then Done. Next:.

• If you see The argument 'scripts\setup_windows.ps1' to the -File parameter does not exist → this window is not in her folder. Paste cd C:\OpenAmika (or the cd line her setup printed), press Enter, run the line again.
• If you see Python 3.11 was not found → STEP 1 again, with Add python.exe to PATH ticked. Then a new window (STEP 2), cd C:\OpenAmika, and this line again.
• If the download crawls (about 50 KB/s) → press Ctrl+C, run the line again and paste a Hugging Face token when it asks. It goes on where it stopped.
• If a line starts with !! → do what that line says, then run the line again. Finished parts are skipped.

STEP 5 — Her voice and her model

envs\brain\Scripts\python.exe scripts\setup_tts.py

Takes 10 to 30 minutes: about 5.5 GB of downloads. It shows her license, then asks: type yes, press Enter.

You see: OK voice MekaHime_Amika and OK Live2D model Amika, then Done. Next:.

• If you see not downloaded: her license was not accepted → run the line again and type yes.
• If you see 'envs\brain\Scripts\python.exe' is not recognized → this window is not in her folder (cd C:\OpenAmika), or STEP 4 did not finish.

STEP 6 — Start her

.\Start_OpenAmika.bat

Next time, just double-click Start_OpenAmika.bat in C:\OpenAmika.

Takes 1 to 3 minutes (the first start is the slowest).

You see: a window called OpenAmika with green rows. Your browser opens her page (http://localhost:53000) and her first-run window asks your name and your city.

This is the beginning of the README. Read the rest at the original. Read the full README ↗