Superalgos 1.0.0

Table of Contents

• Table of Contents
• Introduction
• Getting Started Guide
• Pre-Requisites
  • Windows Install
  • Mac OS Install
  • Linux Install (e.g. Raspberry Pi running Raspberry Pi OS/Raspbian)
• Superalgos Platform Client Installation
  • Fork the Superalgos Repository
  • Clone Your Fork
  • Install Node Dependencies
    • Troubleshooting Dependency Installation
    • Enable Desktop Shortcut in Ubuntu
  • Installation Notes
  • Uninstall
• Usage
  • Run the Client and GUI
    • Using the shortcuts
    • Using the Command Line
  • Usage Notes
  • Running Superalgos on a Headless Linux Server as a Daemon
    • Using Systemd
  • Docker Deployments
• Welcome Tutorial
• What is the Superalgos Platform?
  • Superalgos Platform Features
  • Superalgos Development Pipeline
  • Superalgos is User-centric
  • Superalgos Platform Allows You To
  • Superalgos Platform for Developers
  • Superalgos Platform Saves You Time
  • Superalgos Platform is Permissionless
  • Superalgos Platform for Algo-Traders
  • Superalgos Platform Saves You Money
  • Superalgos Platform Minimizes Risks
  • Superalgos Platform for Companies
• Support
• Other Resources
• Contributing
• License

Introduction

Superalgos is not just another open-source project. We are an open and welcoming community devised, nurtured, and incentivized with the project's native Superalgos (SA) Token to build an open trading intelligence network.

You will notice the difference as soon as you join the Telegram Community Group or the new Discord Server!

Can't wait to contribute? Start by giving a star to this repository in the top-right corner of this page!

Getting Started Guide

All procedures are the same for Windows, Linux, or Mac OS. Raspberry Pi terminal commands have been included for ease of use.

IMPORTANT:

Remote installations and minimalist hardware — both virtual and physical — are better suited for production deployments, where the use of the GUI is minimal. We highly recommend learning Superalgos in a local installation. Mastering the system takes time, and the use of the GUI to go through in-app tutorials is crucial during the learning process. Your experience will be orders of magnitude better if you follow this advice: leave remote installations and minimalist hardware for when you are ready to start trading live.

Pre-Requisites

In order to run Superalgos on your computer, you will need the latest versions of Node JS and Git installed. You will also need a web browser to access the interface. Google Chrome is recommended as it is what the development team uses and supports.

• Node.js download page
• Git download page
• Google Chrome download page

Windows Install

You can use the windows installer (Setup file) which will install all the necessary dependencies and files for you to run the platform. Also the shortcuts are placed. This application will notify you and update as new releases come (to be released).

IMPORTANT: The single executable and the installer do not have Tensorflow active yet.

NOTE There's a known issue where the screen stays white. In this case, go to "View/Reload" and it should work.

NOTE The application is not signed yet. The antivirus probably will flag the file as unsecure. You can force the installation and running or way for the signed app.

The manual installation option, tailored for users who are experienced and who want to contribute to the project (highly appreciated and rewarded with SA tokens). Follow the install wizards to install the latest NodeJS and Github Desktop applications.

• Node.js download page. Select "Current" then "Windows Installer", then follow the wizard to install after the download completes.
• GitHub Desktop download page. Click the "Download for Windows" button and follow the wizard to install after the download completes.
• Google Chrome download page. After the install, it is recommended to set Chrome as the default browser.
• If you intend on running the machine learning features (TensorFlow), you must install Python 2 as well.

Mac OS Install

You can use the MacOS installer (DMG file) which will install all the necessary dependencies and files for you to run the platform. Also the shortcuts are placed. This application will notify you and update as new releases come (to be released).

NOTE The application is not signed. To be able to run you have to permit it in System Preferences > Security & Privacy > General > Open Anyway.

Homebrew can be used to install the requirements with minimal effort on Mac OS. After you clone the repository, change directory to the Superalgos base and install the requirements using the Brewfile. Python 3 is only required for running machine learning (TensorFlow).

brew install git node npm [email protected]

Or use the Brewfile included in the code repository. After downloading, run this command in the same directory where the Brewfile resides:

brew bundle

You can use Safari or Google Chrome as your default browser. If you run into a bug in Safari, you will be asked to reproduce it in Chrome as the development team uses Chrome.

Linux Install (e.g. Raspberry Pi running Raspberry Pi OS/Raspbian)

Follow the Node.js package manager install instructions for your distribution to ensure you are getting the latest version of Node.js. Many distributions only maintain an older version in their default repositories. Python 3 is only required for running machine learning (TensorFlow).

curl -sL https://deb.nodesource.com/setup_16.x | sudo -E bash -
sudo apt-get install -y nodejs npm git python3

You may verify the installed versions with these commands:

node -v
npm -v
git --version

If you are running headless (i.e. as a server without a monitor attached) then you do not need to install a web browser and you can follow the tutorial for information on connecting remotely to the server.

Superalgos Platform Client Installation

Fork the Superalgos Repository

• Scroll the page all the way to the top. Find and click the Fork button to create your fork/copy of this repository. To fork Superalgos you need a Github account. If you don't have one, go ahead and create it.

NOTE

A Fork is required for your contributions to the project. The reason why Superalgos is free and open-source is that the project has set up a collective business in which all users may participate. The way to participate is to contribute to make Superalgos better. The project's token is distributed among contributors.

Clone Your Fork

• Once the fork is created, you will land on the page of your fork. Copy the URL from your browser's address bar.
• In your computer/laptop/server, open a command prompt or terminal. Make sure you are in a directory where you have write permissions (on most systems the terminal will open in your user's home directory, so you're good). Clone the git repository using the command:

git clone <URL of your Superalgos fork>

For example, if your Github username is John, the command will look like this:

git clone https://github.com/John/Superalgos

This creates the Superalgos folder in the current directory, which contains the whole installation.

Install Node Dependencies

After the Superalgos directory has been installed, the final step of installation is to set up the necessary node dependencies. In the same command prompt or terminal you just used, type the following:

cd Superalgos

That should take you inside the Superalgos folder created by the git clone command earlier. Now type node setup to install the dependencies.

node setup

By default, desktop shortcuts are created if they can be. Currently, Mac OS shortcuts are not created. Linux installations may require extra steps to view and use the shortcuts.

Available Options:

usage: node setup <options>

Option	Description
noShortcuts	Do not install desktop shortcuts
tensorflow	Include the TensorFlow dependencies

NOTE FOR WINDOWS USERS INSTALLING TENSORFLOW DEPENDENCIES:

You may get an error at the end of the set up process. If you do, please follow the instructions following the error message.

NOTE FOR USERS INSTALLING MULTIPLE INSTANCES OF SUPERALGOS ON THE SAME MACHINE:

In order to avoid name conflicts between shortcuts, make sure to rename each Superalgos directory before running node setup.

Congratulations your installation is complete! Follow the "Running the Application" directions below.

Troubleshooting Dependency Installation

If you are having difficulty running the node setup command here are a few common issues that may be getting in the way.

1. Check the version of node and npm you have installed. Make sure that you are running an updated version of node greater than version 12 and npm greater than version 5. You can check which version you have by typing node -v and npm -v into a command prompt or terminal. If your version numbers are below these, you can update your installation by following the instructions outlined in the "Node JS Installation" step above.
2. If you are installing Superalgos in an administratively protected directory you will need to do one of the following:
   • For Windows start your command prompt as an administrator.
   • For Linux and Mac Systems make sure to add the sudo command to node setup. This will look like sudo node setup.
3. For Windows it is important that you have C:\Windows\System32 added to your global PATH. For instructions on how to do this google "add to the path on Windows 10."

Enable Desktop Shortcut in Ubuntu

The majority of shortcuts that are automatically installed will work out of the box. Desktop shortcuts on Ubuntu, however, require a few additional steps to set up. First, desktop icons need to be enabled within the Tweaks app.

• Check if Tweaks is installed.
• If not go to Ubuntu Software.
• Install Tweaks.
• Open Tweaks.
• Under extensions turn on Desktop Icons

TIP: If you do not see the desktop shortcut appear right away you may need to restart your computer.

Finally, you will need to enable the desktop shortcut. Right click Superalgos.desktop and select Allow Launching.

Now both launcher and desktop shortcuts will launch Superalgos like any other program on your computer.

Installation Notes

• You need to make a fork so that you may contribute work. Superalgos is a Community project and you are expected to contribute, like everyone else. You don't need to be a technical person to contribute. Fixing a typo in the docs or translating a paragraph into your native language are valuable contributions too. Superalgos has built-in features that make contributing easy. Help make Superalgos better and Superalgos will better serve you! Free-riding is not cool, particularly on free, open-source, Community-driven projects.
• The software includes an in-app self-update command / feature. It will help you stay up-to-date with the latest version of the software. Updates are on-demand, so don't worry about undesired updates. The project moves very fast and new features become available regularly, particularly if you choose to run the software in the develop branch (you may switch branches from within the app).
• It is a good idea to periodically run the node setup command to keep the underlying dependencies for your Superalgos installation up to date.
• Before installing the client on a remote computer in an attempt to access the UI from a different machine, we highly recommend you do a standard installation on your PC / laptop first. Leave your Raspberry Pi or VPS for later, once you have done all available tutorials. This single tip will save you a lot of time: you don't need to add complexity before you learn how to handle the app, and the GUI performs best in a local installation.

Uninstall

Superalgos writes nothing outside of the Superalgos folder other than shortcut files. In order to quickly remove the shortcut files, open a terminal or command prompt, navigate to your main Superalgos directory, and type the following command:

node uninstall

Then simply delete the Superalgos folder to completely remove the application.

Usage

Run the Client and GUI

Using the shortcuts

If you ran node setup with no options above, then you should see a desktop icon which you can double click to launch the Superalgos application. A terminal window will show the server is running, and a browser window will open with the WebUI.

Using the Command Line

To run Superalgos, go to the Superalgos directory/folder and run this command:

node platform

Available Options:

usage: node platform <options>

Option	Description
minMemo	Run with minimal memory footprint. This is critical for running on platforms with less than 8GB of ram, like a Raspberry Pi.
noBrowser	Do not attempt to open the WebUI in a browser. This is useful on headless servers where a UI is not available.

The Client will run on your terminal and the GUI will launch on your default browser. If Chrome/Safari is not your default browser, copy the URL, close the browser, open Chrome/Safari, and paste the URL. Be patient... it takes a few seconds to fully load the GUI.

A Welcome Tutorial pops-up automatically. You must do this Tutorial to finish the setup and to learn the basics. It's the ultimate onboarding experience, superior to all other resources available, including videos and the Docs.

Usage Notes

We are testing the UI on Google Chrome and Safari on macOS only. It may work on other browsers as well — or not. If you are running on a different browser and ever need support, make sure you mention that fact upfront, or even better, try on Chrome/Safari first.

TIP:

If your computer has 8 GB of RAM or less, use node platform minMemo to run the system with minimal RAM requirements.

Running Superalgos on a Headless Linux Server as a Daemon

If you're running Superalgos on a headless linux server like a Raspberry Pi, you might want to run it as a daemon so it isn't attached to your current login session. The easiest, most standard way to go about this is probably using systemd. Most linux distributions use it as default init system/service manager.

Using Systemd

Create a superalgos.service file looking like this (change <user> to your user name and /path/to/Superalgos to your Superalgos folder, for instance /home/John/Superalgos):

[Unit]
Description=Superalgos Platform Client

[Service]
Type=simple
User=<user>
WorkingDirectory=/path/to/Superalgos
ExecStart=/usr/bin/node platform minMemo noBrowser

[Install]
WantedBy=multi-user.target

There is no need to run Superalgos as root so we're running it as a user. The minMemo option assumes you're running on a small machine like a Raspberry Pi, while noBrowser makes sense for running daemonized. Now, you'll need to move the file to /etc/systemd/system/ in order for it to be recognized. You'll need then to enable and start the service.

sudo mv superalgos.service /etc/systemd/system
sudo systemctl daemon-reload
sudo systemctl enable superalgos
sudo systemctl start superalgos

To see the output of Superalgos, use:

journalctl -u superalgos

or to follow the output with -f:

journalctl -u superalgos -f

Docker Deployments

See the Docker Readme for more information.

Workspace Refactoring for beta 13

Beta 13 carries with it a reorganization of the codebase where several projects where extracted from Foundations : Data-Mining, Algorithmic Trading, Machine Learning and Community Plugins.

This means that these projects can now have a project leader and a team working on them.

In order to get your custom workspace upgraded to be compatible with beta 13 you will need to make a few changes:

Project nodes need to be present at the workspace for things to work. The presence of the node of a project, somehow, enables that projects features at a workspace. Go to the workspace node and click add missing projects.

At the Plugins hierarchy, new guys appear, each one with their own type of plugins. Meaning that every workspace needs to be manually fixed, because currently all plugins are loaded from Foundations node there. The fix is easy though, it takes 2 - 3 min to delete the child nodes from the foundation node, and add the same plugins from the project they actually belong now.

Welcome Tutorial

Once the app finishes loading, an interactive tutorial takes you by the hand and walks you all around the system while you learn the basic skills required to use the interface, mine data, backtest strategies, and even run a live trading session. It is highly recommended you follow the tutorial until the end, as it is carefully crafted to make your onboarding as easy as possible. Tutorials are the absolute best way to tackle the learning curve. You should do all tutorials before you start exploring other avenues on your own.

NOTE:

The tutorial uses Binance or Binance US as the exchange of choice. If you don't have an account with Binance or Binance US, you will still be able to follow 100% of the tutorial. When you get to the live trading section, keep going even if you don't intend to run the session. You may learn how to work with other exchanges later on.

What is the Superalgos Platform?

Superalgos Platform is a set of tools to automate crypto-trading. It is implemented as a Node JS Client + Web App that runs on your hardware and scales from a single Raspberry Pi to a Trading Farm. The Platform is fully functional and has been used for trading live since 2020.

At a future version, trading signals will be able to be sent to the Suerpalgos Network from the Superalgos Platform.

Superalgos Platform Features

• A Visual Scripting Designer.
• Integrated Charting System.
• A Visual Strategy Debugger.
• Data Mining Tools.
• Coordinated Task Management across a Trading Farm.
• Community-built strategies to learn and start from.
• TensorFlow Machine Learning integration.
• In-App Tutorials.
• Complete In-App Documentation.
• SA Token / Project Governance System.

Superalgos Development Pipeline

• Superalgos P2P Network: Will allow the project to distribute trading intelligence produced by algo-traders.
• Trading Signals: Will allow providers to broadcast trading signals and be rewarded with SA Tokens.
• Superalgos Mobile: Will allow users to consume trading signals for free and autonomously execute trades from their mobile phones.
• Ethereum Integration: Will allow mining data from an Ethereum network node, and bring it into the Superalgos workflow.

Superalgos is User-centric

• No ads, anywhere.
• No sign-up / logins.
• No user/usage data collection of any kind.
• No user trading information collected or sold.
• Runs 100% on uncompiled code anyone can read and audit.

Superalgos Platform Allows You To

• Visually design your trading strategies.
• Visually debug your trading strategies.
• Visually design your indicators.
• Visually design your plotters to visualize indicators or mined data.
• Visually design your data-mining operations.
• Download historical market data from crypto exchanges.
• Backtest your strategies against historical data.
• Run live trading sessions.
• Run arbitrary data-mining operations of any size.
• Feed your trading strategies with the data mined.
• Use your token holdings to vote and influence the direction of the project development.
• Produce real-time trading signals and send them via the p2p network. (under development)

Superalgos Platform for Developers

• You may use Superalgos as a platform or as a component of a larger system.
• No proprietary code/libraries. All open-source and free.
• Superalgos features a library of community-contributed plugins (workspaces, strategies, indicators, plotters, tutorials, etc.).

Superalgos Platform Saves You Time

• No need to code the download of historical data from crypto exchanges.
• No need to code the streaming of market data from crypto exchanges.
• No need to hardcode strategies. Use the visual designer for a more flexible approach.
• No need to debug what went wrong, line by line, or dive into log files with tons of data. You can see each variable of the state of the Trading Engine at every candle by hovering the mouse over the charts.
• No need to integrate a charting library, Superalgos features an integrated Charting System.
• No need to manage task data or execution dependencies. Superalgos allows you to define Tasks and distribute them across a Trading Farm and takes care of the data and execution dependencies so that each task automatically starts when their dependencies are ready.

Superalgos Platform is Permissionless

• Don't like the UI?
• Don't like the icons used?
• Don't like the Charting System?
• Don't like the Visual Designer?
• Don't like the Visual Debugger?
• Don't like the Docs?
• Don't like the Trading Bot?
• Don't like the Indicators?
• Don't like the Plotters?
• Don't like any other part of the system?

No problem, code or integrate libraries with your own version of any component and we promise we will merge your work and provide it as an alternative to users. We believe in Permissionless Innovation and that users, not team members, are the final judges and the ones who decide what they prefer to use. You are free to create an alternative for any part of the system that you believe that should work or should have been done in a different way. We will help you integrate your vision into the next release and enable a way for users to choose between different implementations of the same functionality. You will also be granted the title of maintainer of the functionality you provide and have decision power on how it evolves in the future.

Superalgos Platform for Algo-Traders

• Superalgos is easy to install/uninstall.
• Superalgos is easy to run.
• Superalgos is easy to use.
• Superalgos is easy to learn.
• Superalgos is easy to debug.
• Superalgos is well documented.
• You have free online support via Telegram and Discord.

Superalgos Platform Saves You Money

• There are no paid plans or anything that costs you money.
• There is no locked functionality. You may use the full capacity of the software.
• There is no limit to the number of backtests you may run.
• There is no limit to the number of live sessions you may run.
• There is no limit to the number of historical data you may download.
• There is no limit to the volume of data you may process.
• You may use all the plugins available (indicators, plotters, strategies, etc.)
• You may install Superalgos in as many machines as you wish.
• Your installations may be used by as many people as required.
• You may connect to as many crypto exchanges as you wish.

Superalgos Platform Minimizes Risks

• No one can know what strategies you design/run.
• No one can front-run you.
• No one can steal your trading ideas.
• No one knows how much capital you trade.
• No one can see your exchange keys.

Superalgos Platform for Companies

• No need to buy expensive software for monitoring crypto markets or trading execution.
• No need to hire your own developers.
• All your employees can use Superalgos for free.
• You can use Superalgos to its full capacity or just the features you are currently interested in.
• Superalgos may be integrated into your existing operation, feeding to and from other systems.
• You've got a growing community of algo-traders constantly improving the software at zero cost for you.
• You've got free online customer support via Telegram or Discord.

Support

We just opened a brand new Discord server for Support and the Community.

We also meet on several Telegram groups, where it all started!

BEWARE OF IMPERSONATORS — SCAMMERS ARE LURKING!

Superalgos Admins, the Core Team, and Community Mods will never contact you directly unless you contact them first. We will never ask you for API keys, coins, or cash. In fact, we will never ask you to trust us in any way. Our Community Safety Policy explains why. In short, we want to make it clear that if someone contacts you directly claiming to work with or for the project, it is a scam. Please report scammers in the Community group so that they may be banned, and to increase awareness of the problem, but also block them and report them to Telegram if the option is available.

• Via Telegram
  • Online support through our Superalgos User's Support Group.
• In-App Integrated Documentation
  • Superalgos features interactive documentation built-in the system.
• Video Tutorials
  • Subscribe to the Superalgos YouTube Channel.
• In-App Tutorials
  • There are many interactive tutorials you may do and learn from.

Other Resources

• Web Site
  • For an overview of what Superalgos can do for you, check the Superalgos Website.
• Telegram
  • For official news, join the Superalgos Announcements Channel.
  • Meet other users in the Superalgos Telegram Community Group.
  • Meet developers in the Superalgos Telegram Developer's Group.
  • Users meet in other topic-specific Telegram Groups. There's a complete list of groups on the website.
• Blog
  • Find official announcements and various articles on the Superalgos Blog.
• Twitter
  • To stay in the loop, follow Superalgos on Twitter.
• Facebook
  • Or follow Superalgos on Facebook.

Contributing

Superalgos is a Community Project built by users for users. Learn how you may contribute.

License

Superalgos is open-source software released under Apache License 2.0.