DeRunner Overview

Derunner consists on a python scrip running as service to:

• Serve as main client for DeSOTA API Models Request, for example DeSOTA Tools (eg. DeUrlCruncher) and DeSOTA AI Models (eg. DeScraper, NeuralQA);
• Automatically Upgrade DeSOTA Tools and DeSOTA AI Models;
• Automatically Re-Install DeSOTA Tools and DeSOTA AI Models on critical errors.

Instalation

Use DeSOTA official Manager & Tools

1. Download Installer for your Platform

2. Open Models Instalation tab

3. Select the Available Tool desotaai/derunner

4. Press Start Instalation

Manual Windows Instalation

• Go to CMD (command prompt):
  • ⊞ Win + R
  • Enter: cmd
  • ↵ Enter

Download:

1. Create Model Folder:

rmdir /S /Q %UserProfile%\Desota\DeRunner
mkdir %UserProfile%\Desota\DeRunner

2. Download Last Release:

powershell -command "Invoke-WebRequest -Uri https://github.com/desotaai/derunner/archive/refs/tags/v0.0.0.zip -OutFile %UserProfile%\DeRunner_release.zip" 

3. Uncompress Release:

tar -xzvf %UserProfile%\DeRunner_release.zip -C %UserProfile%\Desota\DeRunner --strip-components 1 

4. Delete Compressed Release:

del %UserProfile%\DeRunner_release.zip

Setup:

5. Setup:

%UserProfile%\Desota\DeRunner\executables\Windows\derunner.setup.bat

• Optional Arguments:

  arg	Description	Example
  /debug	Log everything (useful for debug)	%UserProfile%\Desota\DeRunner\executables\Windows\derunner.setup.bat /debug
  /manualstart	Don't start at end of setup	%UserProfile%\Desota\DeRunner\executables\Windows\derunner.setup.bat /manualstart

Manual Linux Instalation

• Go to Terminal:
  • Ctrl + Alt + T

Download:

1. Create Model Folder:

rm -rf ~/Desota/DeRunner
mkdir -p ~/Desota/DeRunner

2. Download Last Release:

wget https://github.com/franciscomvargas/descraper/archive/refs/tags/v0.0.0.zip -O ~/DeRunner_release.zip

3. Uncompress Release:

sudo apt install libarchive-tools -y && bsdtar -xzvf ~/DeRunner_release.zip -C ~/Desota/DeRunner --strip-components=1

4. Delete Compressed Release:

rm -rf ~/DeRunner_release.zip

Setup:

5. Setup:

sudo bash ~/Desota/DeRunner/executables/Linux/derunner.setup.bash

• Optional Arguments:

  arg	Description	Example
  -d	Setup with debug Echo ON	sudo bash ~/Desota/DeRunner/executables/Linux/derunner.setup.bash -d
  -m	Don't start service at end of setup	sudo bash ~/Desota/DeRunner/executables/Linux/derunner.setup.bash -m

Service Operations

Windows

• Go to CMD as Administrator (command prompt):
  • ⊞ Win + R
  • Enter: cmd
  • Ctrl + ⇧ Shift + ↵ Enter

Start Service

%UserProfile%\Desota\DeRunner\executables\Windows\derunner.start.bat

Stop Service

%UserProfile%\Desota\DeRunner\executables\Windows\derunner.stop.bat

Status Service

%UserProfile%\Desota\DeRunner\executables\Windows\derunner.status.bat

Linux

• Go to Terminal:
  • Ctrl + Alt + T

Start Service

sudo bash ~/Desota/DeRunner/executables/Linux/derunner.start.bash

Stop Service

sudo bash ~/Desota/DeRunner/executables/Linux/derunner.stop.bash

Status Service

bash ~/Desota/DeRunner/executables/Linux/derunner.status.bash

Uninstalation

Use DeSOTA official Manager & Tools

1. Open Models Dashboard tab

2. Select the model franciscomvargas/descraper

3. Press Uninstall

Manual Windows Uninstalation

• Go to CMD as Administrator (command prompt):
  • ⊞ Win + R
  • Enter: cmd
  • Ctrl + ⇧ Shift + ↵ Enter

%UserProfile%\Desota\DeRunner\executables\Windows\derunner.uninstall.bat

• Optional Arguments

  arg	Description	Example
  /Q	Uninstall without requiring user interaction	%UserProfile%\Desota\DeRunner\executables\Windows\derunner.uninstall.bat /Q

Manual Linux Uninstalation

• Go to Terminal:
  • Ctrl + Alt + T

sudo bash ~/Desota/DeRunner/executables/Linux/derunner.uninstall.bash

• Optional Arguments

  arg	Description	Example
  -q	Uninstall without requiring user interaction	sudo bash ~/Desota/DeRunner/executables/Linux/derunner.uninstall.bash -q

Credits / Lincense

DeSOTA

@credit{
  ai2023desota,
  title = "DeRunner: Main Runner for Desota Servers",
  authors = ["Kristian Atanasov", "Francisco Vargas"],
  url = "https://desota.net/",
  year = 2023
}