AiyoPerps logoOfficial WebsiteAiyoPerps
Install guide

How to install AiyoPerps on Linux x64

This page covers Linux x64 installation paths for AppImage, npm, and manual package download, depending on how you prefer to deploy desktop software.

Requirements

Requirements

  • Linux x64 desktop environment
  • Terminal access
  • Permission to change executable file permissions

1Install with AppImage

Open a terminal in a location with write and execute permissions, then download, mark the file executable, and launch it.

wget https://github.com/phidiassj/AiyoPerps/releases/latest/download/AiyoPerps-x86_64.AppImage
chmod +x AiyoPerps-x86_64.AppImage
./AiyoPerps-x86_64.AppImage
Linux terminal commands used to install AiyoPerps with AppImage
AiyoPerps Dashboard running on Linux after startup

2Install with npm

The npm package may lag slightly behind the latest GitHub release. After installation, the app is placed under the package directory and can be moved to another executable location if needed.

apt update apt install -y nodejs npm
npm install @phidiassj/aiyoperps-linux64
Linux terminal commands used to install AiyoPerps from npm
Files created by the AiyoPerps npm package on Linux

3Install from the manual package

wget https://github.com/phidiassj/AiyoPerps/releases/latest/download/linux-x64.zip
unzip linux-x64.zip
cd linux-x64
chmod +x AiyoPerps
./AiyoPerps
Manual download page for the AiyoPerps Linux x64 package
Linux terminal commands used to download and extract the AiyoPerps manual package
Verify

How to confirm the installation worked

  • No permission error is shown in the terminal.
  • The desktop window opens normally.
  • The app does not crash immediately after launch.

Continue to desktop workflows

After installation, the next step is account setup, Dashboard usage, and exchange tabs.

Open desktop workflow guide

Need API or MCP only?

If your goal is an automation node without the desktop UI, move to the Docker headless guide.

View Docker headless guide