Sahara Documentation
User Guide: Data Services Platform
User Guide: Data Services Platform
  • Data Services Platform
    • Quick Start Guide
    • Token Gate Verification
  • MyShell Task Instructions
    • Video Guide
  • Sahara Points & Ranking
    • Task-Specific Sahara Points (SP)
    • Tracking Your Progress
    • User Tiers
    • Achievements
  • Sign In & Onboarding
  • Platform Navigation
    • Profile
    • Main Menu
    • Dashboard
  • Data Services Page
    • Annotator Guidelines
    • Reviewer Guidelines
    • Task Overview & Pre-Exam
    • Task List
    • Task Categories
    • Task Cards
    • Task Page
  • Achievements Page
    • My Level
    • In Progress Achievements
    • Closed Achievements
  • FAQs
  • Glossary
  • Troubleshooting
  • Terms of Use
Powered by GitBook
On this page
  • For Windows Software
  • Important Note
  • Source of Files
  • System Requirements
  • Run the Recording App
  • Recording Length Requirement
  • Recording Content Requirements
  • Data Quality Criteria
  • Run the Select & Export App
  • Deleting Track Data
  • Export Track Data (Download ZIP File for Task Completion)
  • Submission
  • For Ubuntu Virtual Machine
  • Quick Guide to Setting Up Ubuntu 22.04 VM for Beginner
  • Important Note
  • Source of Files
  • System Requirements
  • Run the Recording App
  • Recording Length Requirement
  • Recording Content Requirements
  • Data Quality Criteria
  • Run the Select & Export App
  • Deleting Track Data
  • Export Track Data (Download ZIP File for Task Completion)
  • Frequently Asked Questions

MyShell Task Instructions

PreviousToken Gate VerificationNextVideo Guide

Last updated 19 days ago

Welcome to the MyShell annotation tasks on Sahara’s Data Services Platform!

We’re excited to have you join our community of contributors helping shape the future of AI development. These tasks involve capturing user interactions across different software environments, including Ubuntu, Windows, and macOS. In the name of transparency, the related software package is open source on .

Your contributions not only enhance AI capabilities but also earn you valuable Sahara Points and exclusive rewards. Let’s get started!

For Windows Software

Important Note

  • This task is open to Windows users only.

  • This time, only recording on one designated software is required in this task, please read recording content requirements carefully.

  • If you have previously applied for a similar assignment, please ensure you remove any older software installations and download the updated versions specified below. Recording with an outdated version of "ScreenTracker" will be rejected.

  • If you have two screens, make sure your work happens on the main screen to produce valid results.

  • Ensure your recordings are varied—repetitive workflows may lead to disapproval due to low data quality.

  • Resubmitting the same ZIP file (even across tasks) will not be approved!

Source of Files

  • For Windows Users, Obtain the application package using [].

  • Download and Unzip the “client_v5” File.

System Requirements

Confirm that your computer has a minimum of 5GB disk space, as the application stores track data in “trackDB” and screenshots in the “_cache” directory.

Run the Recording App

  • Double-click on “ScreenTracker_v5” to open the recording program. Please disregard the pop-up and select (“More Info”, "Run Anyway")

  • Click the “Start Recording” button to begin. Follow the Data Content and Quality Requirements while recording.

  • Press End Recording” to close the program when you’re finished.

Recording Length Requirement

You can record for as long as you like. The recording will be automatically split by 5‑minute, with each 5‑minute counting as a valid datapoint. Remember that mouse clicks, keyboard typing, and mouse movements around the screen all produce screenshots. A 5-minute period of real working scenarios will definitely generate enough screenshots to support your submission.

Recording Content Requirements

  • Record your work flow using software such as Microsoft Word, PPT or Excel.

Example Recording Content (but not limited to those operations):

  • "Make the line spacing of first two paragraph into double line spacing"

  • "Change the 2 in \"H2O\" to a subscript."

  • "Change the font to \"Times New Roman\" throughout the text."

  • “Center align the heading”

Data Quality Criteria

Maintain high accuracy in your recordings. Specifically, ensure that no more than 10% of the recorded interactions or steps contain errors.

Examples of errors include unintended mouse clicks, accidental keyboard inputs, incorrect selections, repetitive meaningless actions. Aim to clearly capture intended and purposeful actions to produce reliable data. Recording activities in unrelated software applications will result in your submission being disapproved.

Run the Select & Export App

  • Double-click on “TrackManager_v5” to start the export program when you finish recording.

  • Enter your whitelisted wallet address in both the “Username” and “Password” fields.

  • Click the “Login” button to access the main page. If the same wallet address is already logged in, click the “Logout” button first to avoid an error message. If the issue persists, close the software, log out, and then try logging in again.

  • Check if you have the “Export select track” button.(If you cannot find this button, simply drag and zoom the main interface and it should appear at left bottom corner)

  • Click the “Load exist track:” button. Your recordings are automatically segmented into 5‑minute tracks. Each batch is marked with a timestamp on the right-hand side of the application. For example, a timestamp like “2025-03-07-15-45-00-000” indicates that the first batch started on March 7th at 15:45.

  • From the list, select a specific 5‑minute track. Click the entry to view detailed track data, including a preview of the corresponding event screenshot.

Deleting Track Data

  • If you wish to remove data, select the corresponding 5‑minute track from the list.

  • Click the “Delete select track” button to remove both the cursor and screenshot data for that period.

  • (Optional) Restart “TrackManager_v5” to confirm the data deletion.

  • (Optional) Note that the “Delete select track” button does not physically remove the recorded data from your device; it only prevents the “TrackManager_v5” from accessing the data for your privacy. To completely delete recorded data, you must manually remove the files from the “_cache” folder.

Export Track Data (Download ZIP File for Task Completion)

  • Click the “Export select track” button.

  • Choose the 5-minute trajectory data. (Note: Before proceeding, manually check if any sensitive information is in the screenshot preview by clicking the selected track entry)

  • Select your preferred directory for saving the ZIP file.

  • The application will compile the required data and screenshots into a ZIP file. Please be patient, as this process contains a lot of data processing and may take a long time.

  • When the Zipping process is complete, a pop up will appear to inform you that the zipping is successful.

  • Only ZIP files generated by TrackManager_v5 will be accepted. The exported filename should look like below format: xx-xx-xx-xx-xx-xx_XXXX-XX-XX-XX-XX-XX-XXX.

Example : AC-19-8E-2C-40-47_2025-03-27-15-00-00-000).

Please do not modify the filename or any content within the ZIP file, as doing so may result in disapproval.

Submission

Upload your ZIP file to the Data Service Platform and wait for approval.

For Ubuntu Virtual Machine

This task requires you to perform all required operations on an Ubuntu 22.04 Virtual Machine (VM). After launching the recording tracker application on your Windows or Mac system, you must switch to your Ubuntu VM in full-screen mode to perform the required tasks. In other words, you will use the Screen Tracker on Windows or Mac to record activities that are performed within a full-screen Ubuntu 22.04 VM.

Quick Guide to Setting Up Ubuntu 22.04 VM for Beginner

Video Tutorials:

Important Note

  • This task requires you to perform all required operations on an Ubuntu 22.04 Virtual Machine (VM).

  • Please use the full-screen Ubuntu virtual machine interface to ensure the data you provide meets the required quality standards.

  • This time, only recording on one designated software is required in this task, please read recording content requirements carefully.

  • If you have previously applied for a similar assignment, please ensure you remove any older software installations and download the updated versions specified below. Recording with an outdated version of "ScreenTracker" will be rejected.

  • If you have two screens, make sure your work happens on the main screen to produce valid results.

  • Ensure your recordings are varied—repetitive workflows may lead to disapproval due to low data quality.

  • Resubmitting the same ZIP file (even across tasks) will not be approved!

Source of Files

System Requirements

Confirm that your computer has a minimum of 5GB disk space, as the application stores track data in “trackDB” and screenshots in the “_cache” directory.

Run the Recording App

  • Double-click on “ScreenTracker_v5” to open the recording program. Please disregard the pop-up and select (“More Info”, "Run Anyway")

  • Click the “Start Recording” button to begin. Follow the Data Content and Quality Requirements while recording.

  • Press End Recording” to close the program when you’re finished.

Recording Length Requirement

You can record for as long as you like. The recording will be automatically split by 5‑minute, with each 5‑minute counting as a valid datapoint.

Remember that mouse clicks, keyboard typing, and mouse movements around the screen all produce screenshots. A 5-minute period of real working scenarios will definitely generate enough screenshots to support your submission.

Recording Content Requirements

  • Record your work flow using software such as Chrome, Gimp, or Impress.

Example Recording Content (but not limited to those operations):

  • "Enable the 'Do Not Track' feature in Chrome to enhance privacy "

  • "Change settings of chrome so it will bring back the last tab when computer restart "

  • "Browse the natural products database"

  • “Find a large car with the lowest price from next Monday to next Friday in Zurich.”

Data Quality Criteria

Maintain high accuracy in your recordings. Specifically, ensure that no more than 10% of the recorded interactions or steps contain errors. Examples of errors include unintended mouse clicks, accidental keyboard inputs, incorrect selections, repetitive meaningless actions. Aim to clearly capture intended and purposeful actions to produce reliable data. Recording activities in unrelated software applications will result in your submission being disapproved.

Run the Select & Export App

  • Double-click on “TrackManager_v5” to start the export program when you finish recording.

  • Enter your whitelisted wallet address in both the “Username” and “Password” fields.

  • Click the “Login” button to access the main page. If the same wallet address is already logged in, click the “Logout” button first to avoid an error message. If the issue persists, close the software, log out, and then try logging in again.

  • Check if you have the “Export select track” button.(If you cannot find this button, simply drag and zoom the main interface and it should appear at left bottom corner)

  • Click the “Load exist track:” button. Your recordings are automatically segmented into 5‑minute tracks. Each batch is marked with a timestamp on the right-hand side of the application. For example, a timestamp like “2025-03-07-15-45-00-000” indicates that the first batch started on March 7th at 15:45.

  • From the list, select a specific 5‑minute track. Click the entry to view detailed track data, including a preview of the corresponding event screenshot.

Deleting Track Data

  • If you wish to remove data, select the corresponding 5‑minute track from the list.

  • Click the “Delete select track” button to remove both the cursor and screenshot data for that period.

  • (Optional) Restart “TrackManager_v5” to confirm the data deletion.

  • (Optional) Note that the “Delete select track” button does not physically remove the recorded data from your device; it only prevents the “TrackManager_v5” from accessing the data for your privacy. To completely delete recorded data, you must manually remove the files from the “_cache” folder.

Export Track Data (Download ZIP File for Task Completion)

  • Click the “Export select track” button.

  • Choose the 5-minute trajectory data. Note: Before proceeding, manually check if any sensitive information is in the screenshot preview by clicking the selected track entry.

  • Select your preferred directory for saving the ZIP file.

  • The application will compile the required data and screenshots into a ZIP file. Please be patient, as this process contains a lot of data processing and may take a long time.

  • When the Zipping process is complete, a pop up will appear to inform you that the zipping is successful.

  • Only ZIP files generated by TrackManager_v5 will be accepted. The exported filename should look like below format: xx-xx-xx-xx-xx-xx_XXXX-XX-XX-XX-XX-XX-XXX.

Example : AC-19-8E-2C-40-47_2025-03-27-15-00-00-000). Please do not modify the filename or any content within the ZIP file, as doing so may result in disapproval.

Frequently Asked Questions

Q: I'm experiencing an Error 500 (Invalid credentials) when trying to log in. What should I do?

A: Please ensure you're using all lowercase characters for your wallet address. This resolves the Error 500 login issue in most cases.

Q: Why am I getting a "file size too small" error when uploading my zip file?

A: This indicates your zip file doesn't contain enough data to support effective model training. Remember that mouse clicks, keyboard typing, and mouse movements around the screen all produce screenshots. Please follow the task instructions regarding content requirements and perform your regular operations with designated software applications. A 5-minute period of real working scenarios will definitely generate enough screenshots to support your submission.

Q: Is this recording software safe to use? My antivirus flagged it as suspicious.

Download VirtualBox :

Installation Guide:

Download Ubuntu 22.04 LTS:

For Windows Users, Obtain the application package using []. Download and Unzip the “client_v5” File.

For Mac Users, Obtain the application package using []. Download and Unzip the “client_v5” File.

A: We understand your concern. Since our recording software is newly developed and hasn't been publicly released yet, some antivirus programs may flag it as potentially dangerous. We want to assure you that we fully respect your privacy - all recording happens locally on your machine, giving you complete control over what gets uploaded. For full transparency, the software package is open source on .

GitHub
Download Link
VirtualBox Official
VirtualBox User Manual
22.04 LTS
For Windows Users
For Mac Users
Download Link
Download Link
GitHub