Install Desktop App

The desktop app gives you native features that the web version can’t — GPU-accelerated TTS, system notifications, global shortcuts, and a dedicated window for your soul.

Windows

Portable (Recommended)

1. Download the Portable .exe from anysoul.ai
2. Double-click to run — no installation needed
3. Your data is stored in %APPDATA%/AnySoul

Tip

Portable mode is perfect for trying AnySoul without committing to a full install. You can move the .exe anywhere.

Installer (NSIS)

1. Download the Setup .exe from anysoul.ai
2. Run the installer and follow the wizard
3. AnySoul will be installed to Program Files with a Start Menu shortcut

Windows SmartScreen Warning

Since AnySoul is not yet code-signed with an EV certificate, Windows may show a SmartScreen warning:

1. Click More info
2. Click Run anyway

This is expected for new, unsigned applications and does not indicate malware.

macOS

Important: Bypass Gatekeeper

Apple requires all apps to be code-signed and notarized. We are actively working on enrolling in the Apple Developer Program for proper code signing.

Until then, macOS will block the app with this message:

“AnySoul.app” cannot be opened because the developer cannot be verified.

Fix — run this command in Terminal after installing:

sudo xattr -cr '/Applications/AnySoul.app'

Alternatively: Right-click the app → Open → click Open in the dialog.

Caution

Only bypass Gatekeeper for files downloaded directly from anysoul.ai. Do not run this command on apps from untrusted sources.

Installation Steps

1. Download the .dmg file from anysoul.ai
2. Open the .dmg and drag AnySoul to the Applications folder
3. Open Terminal and run the xattr command above
4. Launch AnySoul from Launchpad or Applications

”App Is Damaged” Error

If you see “AnySoul.app is damaged and can’t be opened”, this is the same Gatekeeper issue. The xattr command above will fix it:

sudo xattr -cr '/Applications/AnySoul.app'

Linux

AppImage

1. Download the .AppImage file from anysoul.ai
2. Make it executable:

chmod +x AnySoul-*.AppImage

3. Run it:

./AnySoul-*.AppImage

Desktop Integration

For automatic desktop integration (menu entry, file associations), install AppImageLauncher:

# Ubuntu/Debian
sudo apt install appimagelauncher

Then simply double-click the .AppImage file — AppImageLauncher will offer to integrate it.

Missing libfuse2

If you see a FUSE-related error, install libfuse2:

# Ubuntu 22.04+
sudo apt install libfuse2

Troubleshooting

Symptom	Platform	Solution
SmartScreen “unknown publisher”	Windows	Click “More info” → “Run anyway"
"Developer cannot be verified”	macOS	sudo xattr -cr '/Applications/AnySoul.app'
”App is damaged”	macOS	Same xattr command as above
AppImage won’t start	Linux	chmod +x the file, install libfuse2
App opens but shows blank screen	All	Check your internet connection — the app needs to reach api.anysoul.ai

What’s Next

Once installed, the desktop app connects to the same account as the web version:

• Quick Start — set up your first soul
• Core Concepts — understand how AnySoul works
• BYOK Setup — bring your own API key