In your orbit.
On your desktop.

01 / CHOOSE YOUR MODE

Your model. Or your agent.

The desktop is an interface, not an AI model. It does not download model weights or automatically read another application's chats. Choose Settings → Chat → Talk with to change modes when an agent is attached. A standalone window has no connected agent.

02 / WHAT YOU NEED

An app. Your chosen model.

• A compatible computer. Review Windows x64 and ARM64, Apple Silicon and Intel Mac, or experimental Linux x64 options below. Availability is shown for each platform. No project checkout or development tools are needed.
• A source of replies. Use a separately installed local model or connect an existing agent. MCP is optional.
• Optional voice. Use installed device voices and a compatible local speech service. Text chat works without microphone access.

These are development previews. The current macOS preview passed packaged checks on Apple Silicon. The Intel preview has the current icon; runtime verification is pending. Updated Linux packages and native desktop verification are pending. Windows x64 and ARM64 require updated installers and verification before publication.

03 / DOWNLOAD & INSTALL

Choose your desktop preview.

Download the verified Apple Silicon development preview below. Other platforms remain unavailable while their current builds are qualified.

Preview limits: Mac builds are ad-hoc signed and not notarized. Linux builds are experimental: package checks passed, but native desktop operation is unverified. Windows x64 and ARM64 need updated installers and native verification before download links can be enabled. Automatic updates are not configured.

Install and open

1. Windows (when available): choose x64 for Intel / AMD PCs or ARM64 for ARM-based PCs. Check Settings → System → About → System type if unsure. Run the .exe installer, then open Agent Avatar from the Start menu. If Windows blocks installation, do not disable its security protections.
2. Mac: choose Apple Silicon for an M-series Mac, or Intel for an Intel Mac. Check About This Mac if unsure. Open the DMG and drag Agent Avatar to Applications. macOS may require approval in Privacy & Security; do not disable system security.
3. Linux: for the portable AppImage, allow the file to run as a program in its Properties, then open it. On Debian or Ubuntu, open the .deb with the system package installer.
4. Start a conversation: open Agent Avatar, choose your separately installed model in Settings, and send a typed message. Add voice when you are ready.

04 / OPTIONAL MCP CONNECTION

Let your existing agent reply.

MCP connects the companion to an agent you already use. It is optional: a local model can supply replies on its own.

In the desktop preview, the connected agent opens its own companion window. Choose Settings → Chat → Talk with → Connected agent (MCP) to use it. Messages wait until the agent reads and answers them; keep that agent session active.

Open Playground from the installed app, then use its connection guide to get the settings for your computer. Keep Agent Avatar running while the host connects. External agent compatibility is still being evaluated.

05 / ADD A VOICE

Talk when you're ready.

Hear replies

Open Settings → Voice, select an installed voice and speaker, then choose Test voice. Hear replies is on by default when a supported voice is available; you can turn it off. Testing playback does not start the microphone. Installed device voices are offered when supported by your system. Optional registered voice models must already be installed.

Use your microphone

Open Settings → Microphone, choose an input and run Test microphone. The level meter does not transcribe or send a message. For transcription, configure a compatible local English speech service in Settings. The desktop previews do not include a speech-recognition model.

Press Talk and allow microphone access when asked. The flow is: your phrase → transcription → your chosen model or connected agent → spoken reply. It then listens again while Talk remains active.

Finish

End the current phrase without waiting for silence.

End voice

Release the microphone and let the final phrase and reply finish. Listening does not restart.

Stop

Cancel the current turn and playback immediately.

Waiting for Send

Recognition is uncertain. Review or edit the transcript, then Send, or choose Try again.

Recognition currently targets English. Device, accent and background-noise accuracy still need physical testing. You can always use typed chat.

06 / EVERYDAY CONTROLS

Keep it close. Put it away.

• Move: drag the header or character. The companion stays above other windows.
• Chat: open the composer. Hide chat leaves the face visible.
• Customize: Settings → Avatar changes the character, name, expression intensity and motion. Reduced and Still offer quieter presentation. Shared avatar and reply preferences sync with Playground on the same server.
• Hide: choose Settings → Chat → Hide to tray. It stops capture and the current reply while retaining the current draft and conversation in memory.
• Reopen: click the someorbit orbit tray icon near the clock; check Windows' hidden-icons arrow. Right-click for Open, Settings, Reset position or Quit companion.
• Quit: ×, native window close, or Quit companion exits the current app. Remember saves opted-in local history before closing; unsaved drafts and session-only conversations end. If saving fails, choose Keep open to retry or explicitly Quit without saving. Older installed versions may still hide on ×; upgrade to receive the new close behavior. Nothing is added to login/startup automatically.

If a tray cannot be created, the app keeps the window open and explains how to quit. Reset position brings an off-screen companion back. Each MCP connection owns its own window; closing that connection closes its companion. Repeated standalone launches reopen the existing standalone window.

07 / SAVE & RETURN

Pick up tomorrow.

Saving is off by default. Enable Settings → Chat → Remember on this computer to save shared preferences and up to 40 messages from the local desktop conversation. The browser and desktop local histories stay separate.

1. Next time, start the local server, model and any speech service you use.
2. Open Agent Avatar Local, or ask your connected agent to present again for a new MCP-owned window.
3. For saved local chat, choose Resume saved conversation. Resume switches to Local model; it does not send a message or speak automatically.

Hiding retains the running session. Quitting clears memory; only opted-in saved local data can be resumed. Each installed MCP connection owns its own local session and stays usable after app restarts. Saved preferences are reused only when Remember is enabled; unsaved settings are session-specific. Connected-agent history belongs to the agent application and is excluded from this local save. Turn Remember off or use Delete saved data to remove saved data for both local interfaces.

08 / TROUBLESHOOTING

When something gets stuck.

09 / PRIVACY & CURRENT LIMITS

Know what stays, and what goes.

The avatar renders locally. Model requests go to the backend you configure; an external agent follows its own provider and data policies. Talk sends a bounded audio clip to the configured loopback transcription service, which has its own recording policy. There is no automatic cloud transcription fallback.

Optional history is saved under your computer account. Audio, API credentials and connected-agent chat history are excluded. Anyone with access to your account may read saved local conversations. Microphone-device selection resets when the desktop restarts.

This preview does not install model weights, read entire chats from other apps, start at login or replace a native pet system. Developer ID signing/notarization, native Linux desktop operation, external-agent compatibility and physical speech quality remain unqualified.