> Getting Started
Install Morpheus, pair your devices, and run your first command.
System Requirements
Morpheus requires a computer or server and a mobile device. The minimum supported platforms are:
| Platform | Minimum Version |
|---|---|
| macOS | 10.12 (Sierra) or later |
| Windows | Windows 10 or later |
| Linux | glibc 2.17+ (Ubuntu 18.04, Fedora 27, etc.) |
| iOS | iOS 13 or later |
| Android | Android 7.0 (Nougat) or later |
Installing the Morpheus Agent
Download the latest release from the GitHub releases page.
- macOS — Download the
.dmg, open it, and drag Morpheus into your Applications folder. - Windows — Run the
.exeinstaller and follow the prompts. - Linux — Use the
.AppImage(chmod +x and run) or install the.debpackage.
On first launch, the agent starts a local WebSocket server on port 3847 and displays a QR code for pairing.
Installing the Mobile App
The Morpheus mobile app is available on both major app stores:
- iOS — Search for "Morpheus AI" on the App Store or use the direct link from the download page.
- Android — Search for "Morpheus AI" on the Google Play Store or use the direct link from the download page.
Pairing via QR Code
Pairing establishes an end-to-end encrypted channel between your machine and mobile device using ECDH key exchange.
- Open the Morpheus Agent. It displays a QR code containing the WebSocket URL and the server's public key.
- On the mobile app, go to Devices → Add Device and scan the QR code.
- The mobile app generates its own keypair and sends its public key to the agent. Both sides derive a shared secret via
nacl.box.before(). - A challenge-response handshake confirms both devices hold the same secret. The pairing is now complete.
TIP — Both devices must be reachable over the network. For LAN pairing, ensure both are on the same WiFi network.
Your First Command
Once paired, the mobile app connects automatically. Open the terminal view and type a command:
$ echo hello
hello
The command is encrypted, sent to the Morpheus Agent over WebSocket, executed by the AI agent (Claude), and the output is streamed back to your phone. Try ls, pwd, or ask Claude a question to see it in action.