Getting Started With Peranima

This is the whole first run, start to finish: install the app, sign in, create the companion you write yourself, and have your first spoken conversation. No setup wizard to fight, no config files. Five steps, and the one part people always misread — the push-to-talk hotkey — is spelled out so you get it right the first time.

1. Get Peranima on your PC

Download Peranima for Windows 10/11 and run the installer. Because the app is new, Windows may show a blue “Windows protected your PC” screen — that's SmartScreen being cautious about anything it hasn't seen many times yet, not a problem with the file. Click More info → Run anyway. Once installed, Peranima lives as a tiny pill at the top edge of your screen — no big window fighting your game for space.

2. Sign in

Open Peranima and choose Google or Discord. Your browser opens and you approve once. A local localhost success page then confirms the sign-in; close that browser tab and return to Peranima. The app signs in automatically and remembers you after that.

3. Customize your companion

Peranima creates a starter companion so you can talk immediately. Open Settings from the tray icon to give it a name, pick one of 6 voices, and write its personality in plain words. Start from a template like The Gremlin or write your own: a calm tactician, a deadpan older sibling, an over-caffeinated hype machine. What you type is who shows up, and you can change it anytime.

4. Have your first conversation

After your first sign-in, the pill starts listening automatically. Say hello, then tap Ctrl Shift Space once to finish. For every later conversation, the hotkey is a toggle, not a walkie-talkie button:

• Tap Ctrl Shift Space once — the pill glows to show it's listening.
• Say whatever you want. Take your time; it's not racing you.
• Tap Ctrl Shift Space again to send. Don't hold the keys down — that's the part people miss.

A spoken reply comes back in a few seconds — about 3 on average from the end of your sentence. That pause is real and we won't pretend otherwise: it's a teammate thinking before they speak, not an instant assistant. Say hello, ask it something, tell it about your day. It listens, answers out loud, and quietly writes down what matters so it remembers next time.

5. Optional — bring it into Minecraft

If you're on the Pro plan, your companion can join your Minecraft world as a real second player — mining, building, and following you on voice command. The short version: pick Java Edition 1.21.x in the launcher (the bot engine doesn't support the new 26.x updates yet), press ESC → “Open to LAN” in your single-player world, and ask your companion to join. No mod, no server. The full walkthrough with every catch is on the Minecraft setup guide.

What to expect (the honest part)

• It's Windows-only today — Windows 10/11. No release date has been announced for Mac or Linux.
• ~3 seconds to first audio. Natural for conversation and handing off tasks; not built for twitch reactions.
• Voice time is metered. The free trial is a 4-hour starter credit, then 1 free hour every month; paid plans add more, and the Minecraft integration is part of Pro ($9.99/mo). What each plan includes is on the home page.