Skip to main content

Attach Your Computer to Hyko 🖥️

Attach your computer to Hyko and use it to run your blueprints securely. All models and data will be ran and saved fully on this computer.

What is a Computer in Hyko's Terminology Anyway?​

In our context, a 'Computer' refers to a Docker container hosted on your machine. Acting as an intermediary, this container bridges the communication between the Docker engine and the various containers housing blueprint functions and models. Additionally, all of blueprint's data, including uploaded images, PDFs, text files, and more, will be securely stored within the computer container.

Preliminary Step: Create a New Computer and Obtain Your Secret Token🛠️​

Before launching your computer, you need to create one from Hyko's dashboard. Once created, you'll have an IDLE machine ready to go. Hyko provides custom scripts tailored for your platform of choice (Windows or Linux), including the machine's JWT token, allowing you to seamlessly start running your tasks.

Connecting Your Computer 🌐​

Run Script

  1. Get the Script:

    • After creating the machine, simply click on the copy icon 📋 located in your IDLE computer card. A dialog will appear with scripts tailored for both Windows and Linux. Be sure to copy the script specific to your operating system.

    • It should resemble the following for Windows:

      Invoke-WebRequest -Uri https://api.hyko.ai/assets/scripts/run-cm-windows.ps1 -OutFile run_cm.ps1; Set-ExecutionPolicy
      -Scope Process -ExecutionPolicy Bypass; .\run_cm.ps1 hyko.ai machine_jwt

    • And it should resemble this for Linux:

      curl -fsSL --insecure https://api.hyko.ai/assets/scripts/run-cm-linux.sh -o run_cm.sh && chmod +x run_cm.sh
      && ./run_cm.sh hyko.ai machine_jwt

  2. Open PowerShell/Terminal:

    • If you are on Windows, open up PowerShell as administrator.

    • If you are on Linux, open up the Terminal

    • Paste the script and hit the Enter key.

  3. Confirm Execution:

    • Type Y and press Enter again when prompted to allow the script execution.

What the Script Will Do When You Run It 🤖​

  1. Check if Docker is Installed on Your System:

    • The script will check if you have Docker Engine installed on your system.
    • If it's not, the script will download it and start the installation wizard for you to complete the installation process.
    • Otherwise, it will proceed to the next step.

  2. Check if Your Computer Has Any NVIDIA GPUs:

    • If yes, the script will install the NVIDIA Container Toolkit CLI for you auomatically.
    • Otherwise, the script will move to the next step.

  3. Pull the Computer Docker Image from Hyko's Registry:

    • In this step, the script will execute a Docker command to pull a special Docker image from Hyko's registry.

  4. Start the Container (In Other Words, Connect Your Computer to Hyko):

    • After pulling the image, the script will run a Docker command to start a Docker container representing the computer.

Exciting news! Your computer is now linked to Hyko, allowing you to witness the transformation of the previously dormant IDLE computer. It has sprung to life, adorned with an icon, displaying vital system information. You're now empowered to create and execute blueprints seamlessly on this machine.

Create Machine

Some errors You May Encounter in Your Way​

  • Execution Policy Error on Windows: If you encounter an error related to execution policies, ensure you run PowerShell as an Administrator and confirm the execution policy change when prompted.
  • Docker Installation Issues: Ensure your computer meets Docker's system requirements. Visit Docker's official documentation for troubleshooting installation issues.
  • Connection Errors: Verify your internet connection and ensure that your firewall or antivirus does not block the connection to Hyko's servers.

By following these detailed instructions, you should be able to connect your Windows or Linux computer to Hyko, enabling you to build and execute blueprints on your machine.