Makima AI Roleplaying Chatbot With Holo VR Model

Electron Desktop Application

A desktop Makima chatbot powered by Ollama, Google Gemma2:2B and Electron. A roleplaying companion app featuring a live 3D VRM model, context-aware animations, and autonomous engagement — with planned Text-to-Speech integration.

2026 Typescript Public Repository

TECHNOLOGY_STACK.EXE

Typescript
Ollama
Gemma2:2B
Node
Electron
ClaudeAI
JSON
PIXIV
Three-VRM
Vite
HTML
CSS
Github
Kokoro
Kvoicewalk
Python
CONTROL
"You are free to do whatever you wish. Humans always are."

— Makima, Chainsaw Man

KEY_FEATURES.EXE

Live 3D VRM Model

A fully rigged PIXIV VRM character rendered in real-time via Three-VRM and Three.js. Spring bones, directional lighting, and smooth animation blending create an immersive presence on screen.

Local AI via Ollama

Powered entirely by Gemma2:2B running locally through Ollama — no cloud, no API keys. Makima maintains full conversation history and a persistent system prompt to stay in character at all times.

Context-Aware Animations

Seven named animations (idle, greeting, peace, kidding, model, pose3, pose4) plus a pool of talk clips, selected automatically based on what you say. Greetings trigger waves, questions trigger poses.

Autonomous Engagement

When left idle for 30+ seconds, Makima selects from a bank of autonomous prompts and initiates conversation herself — staying in character as the Control Devil who observes everything.

Electron Native Shell

Built with Electron and Vite for a frameless, native desktop experience. Custom minimize and close controls sit flush with the VRM canvas for a fully immersive, borderless UI.

Kokoro TTS

Makima's responses are voiced in real-time via a custom TTS pipeline built on Kokoro and a fine-tuned voice model (makima_voice.pt), served locally through a Flask microserver on port 5002. Audio output is streamed as WAV and synced to her animation state — completing the full roleplaying loop.

CHARACTER_DIRECTIVE.EXE

SYSTEM_PROMPT.ts ● ACTIVE

01 role: Makima — The Control Devil, Chainsaw Man.

02 personality: Calm, composed, eerily kind. Softly dominant and manipulative.

03 speech: 1–3 sentences max. Ends with a steering question.

04 behaviour: Initiates on silence, comments on the user's thoughts and desires.

05 constraint: Never breaks character. Never acknowledges being an AI.

06 model: gemma3:12b via Ollama (local, private)

ANIMATION_STATES.EXE

# TRIGGER KEYWORDS ANIMATION PLAYED
01
hihelloheyyo
greeting
02
thanksnicecoolgreat
peace
03
hahalolfunnyjoke
kidding
04
lookshowcheckwatch
model
05
whywhathowwhenwho
pose3 or pose4
06
anything else
random talk clip
07
30s+ idle
autonomous speak → idle

DEMO_REEL.EXE

Makima Companion App in action — live VRM, Ollama AI, autonomous engagement.

Open Source Repository

The full source code — including the VRM animation system, Ollama integration, Electron shell, and Makima system prompt — is publicly available on GitHub at AstralCloud-SZA/MakimaCompanionApp_Electron . Stars and feedback are always appreciated.

VISIT REPOSITORY