Tutorials

Installation Guide: Setting Up AutoByteus

Follow these steps to install and configure AutoByteus for your development environment. You only need to perform these steps once during initial setup.

1 Download AutoByteus Client

First, download the AutoByteus client for your operating system:

  1. Select the appropriate version for your operating system:

    🪟Windows: Click the Windows download button
    🍎macOS (Intel): For Macs with Intel processors
    🍎macOS (Apple Silicon): For Macs with M1/M2/M3 processors
    🐧Linux: For Linux-based operating systems
  2. Click the Download button to start the download
Download Section

2 Install AutoByteus Client

Windows Installation

  1. Locate the downloaded .exe installer file
  2. Right-click and select "Run as administrator"
  3. Follow the installation wizard instructions
  4. Choose your installation location when prompted
  5. Complete the installation and launch AutoByteus

macOS Installation

  1. Locate the downloaded .dmg file
  2. Double-click to open the disk image
  3. Drag the AutoByteus application to your Applications folder
  4. Before the first launch, it's recommended to remove the quarantine attribute to prevent security warnings. Open the Terminal app and run:
    xattr -d com.apple.quarantine /Applications/AutoByteus.app
  5. Launch AutoByteus from your Terminal by running the following command. This is the recommended way to start the application.
    open /Applications/AutoByteus.app

Important Note:

Launching from the Terminal ensures that AutoByteus inherits your full shell environment variables. This is crucial for features like MCP server discovery and other command-line tool integrations to work correctly.

Linux Installation

  1. Open a terminal in the download location
  2. Make the installer executable: chmod +x ./autobyteus-installer.AppImage
  3. Run the installer: ./autobyteus-installer.AppImage
  4. Follow the installation prompts
  5. Launch AutoByteus from your applications menu or terminal

3 First Launch

Launch AutoByteus

  1. Launch the AutoByteus client using the method described for your OS
  2. The first launch may take some time as it initializes. Please be patient.
  3. Once loaded, you will see the welcome screen

Check Application Status

  1. In the Settings menu, click "Server Status"
  2. Verify that the server shows as "Running"
  3. The internal Python server should automatically start with AutoByteus
Server Status

✅ Installation complete! Now proceed to the User Guide to learn how to use AutoByteus.