Releases: nikhilsaraf/kelp
experimental v1.11.0 and v1.0.0-rc2
do not download, this is only for private use by me
Experimental private Kelp GUI build 1 pre-release
Please note the Kelp GUI is experimental software and is not ready for public consumption. It is in alpha stage (i.e. before beta testing) and is not tested yet. There is a significant risk of losing money by using this software. Please exercise caution and place minimal funds on it since there is a risk of malfunctioning and losing the funds.
There are known issues such as:
- bots showing they are active when they have been stopped and vice-versa; in most cases this can be corrected by refreshing the page (command + R on mac, F5 on windows).
- If bots fail because of low balance, or network disconnections, or some other reason, then the user cannot easily see the reason why it failed.
- Bots will sometimes fail to stop when the GUI is closed, which keeps them running forever, and your offers outstanding! The best way to prevent this is to always stop all the bots from the GUI, refresh the page to confirm that they show up as stopped with 0 bids and 0 asks, and then only shut down Kelp.
- The security of the software has not been tested.
- Secret keys are saved in plaintext on your file system.
There are many more known and unknown issues not listed above, and we are only getting around to fixing all these issues now.
Please only use the Kelp GUI on mainnet if you understand and accept these risks.
If you encounter an issue that you are unable to resolve from the GUI, the best way is to email me and I will try and help you as quickly as possible.
Kelp GUI v0.0.4-rc1 (internal)
This is v0.0.4-rc1, the first release candidate for the Kelp GUI.
This is a release-candidate because it is experimental, unpolished, and still has several known bugs.
Download for your relevant platform (macOS = darwin) and unzip, double-click to use.
Running Instructions
Instructional Video to help get you started (insert link when Video ready)
There are two ways to quit the Kelp application:
- Clicking the "Quit" text on the top left (there is no
Xor red dot on mac by design) - You will notice a
Kicon in your task bar on mac, you can click that to find the Menu which has aQuitoption
Windows
You need to run the kelp-start.bat file to start kelp. If you double-click on kelp.exe it will not work.
This requires you to have Windows 10 and to enable the Ubuntu on Windows Subsystem for Linux (WSL)
Follow instructions for Linux below if you run into any issues (such as the unzip command exiting with exit code 127)
Linux
You may need to install dependencies for electron. The full list of dependencies for different flavors of Linux can be found at https://www.electronjs.org/docs/development/build-instructions-linux
Example command to run on Ubuntu to ensure that you have all the dependencies:
sudo apt-get install -y build-essential clang libdbus-1-dev libgtk-3-dev libnotify-dev libgnome-keyring-dev libasound2-dev libcap-dev libcups2-dev libxtst-dev libxss1 libnss3-dev gcc-multilib g++-multilib curl gperf bison python-dbusmock openjdk-8-jre libX11-xcb-dev libstdc++6
Additionally ensure that these dependencies exist:
sudo apt-install -y unzip
MacOS
This version is not code signed for MacOS, but there is a workaround.
You need to copy Kelp.app from the DMG file into the /Applications folder (Applications shortcut in the DMG) and run it from /Applications. If you open it from the dmg directly it may fail without any error.
Limitations
- This will only run on the test network for now
How can I get more tokens?
The secret key for the COUPON:GBMMZMK2DC4FFP4CAI6KCVNCQ7WLO5A7DQU7EC7WGHRDQBZB763X4OQI asset issuer is SANPCJHHXCPRN6IIZRBEQXS5M3L2LY7EYQLAVTYD56KL3V7ABO4I3ISZ
Where can I file issues
File a bug report on github
Where can I get help if I am stuck
The #kelp channel on slack
Can I share this externally?
Yes but privately only.
We will be sharing it externally this week along with a public announcement and some more marketing.
Kelp GUI v0.0.3-rc1 (internal)
This is v0.0.3-rc1, the first release candidate for the Kelp GUI.
This is a release-candidate because it is experimental, unpolished, and still has several known bugs.
Download for your relevant platform (macOS = darwin) and unzip, double-click to use.
Running Instructions
Instructional Video to help get you started (insert link when Video ready)
There are two ways to quit the Kelp application:
- Clicking the "Quit" text on the top left (there is no
Xor red dot on mac by design) - You will notice a
Kicon in your task bar on mac, you can click that to find the Menu which has aQuitoption
Windows
You need to run the kelp-start.bat file to start kelp. If you double-click on kelp.exe it will not work.
This requires you to have Windows 10 and to enable the Ubuntu on Windows Subsystem for Linux (WSL)
Linux
You may need to install dependencies for electron. The full list of dependencies for different flavors of Linux can be found at https://www.electronjs.org/docs/development/build-instructions-linux
Example command to run on Ubuntu to ensure that you have all the dependencies:
sudo apt-get install -y build-essential clang libdbus-1-dev libgtk-3-dev libnotify-dev libgnome-keyring-dev libasound2-dev libcap-dev libcups2-dev libxtst-dev libxss1 libnss3-dev gcc-multilib g++-multilib curl gperf bison python-dbusmock openjdk-8-jre libX11-xcb-dev libstdc++6
MacOS
This version is not code signed for MacOS, but there is a workaround.
You need to copy Kelp.app from the DMG file into the /Applications folder (Applications shortcut in the DMG) and run it from /Applications. If you open it from the dmg directly it may fail without any error.
Limitations
- This will only run on the test network for now
- When you double-click to run it, it will first automatically download the CCXT-rest binary in the background (20 MB). This will be fixed in rc2.
How can I get more tokens?
The secret key for the COUPON:GBMMZMK2DC4FFP4CAI6KCVNCQ7WLO5A7DQU7EC7WGHRDQBZB763X4OQI asset issuer is SANPCJHHXCPRN6IIZRBEQXS5M3L2LY7EYQLAVTYD56KL3V7ABO4I3ISZ
Where can I file issues
File a bug report on github
Where can I get help if I am stuck
The #kelp channel on slack
Can I share this externally?
Not yet. We will be sharing it externally this week once we get feedback from everyone internally along with a public announcement.
Kelp GUI v0.0.2-rc1 (internal)
This is v0.0.2-rc1, the first release candidate for the Kelp GUI.
This is a release-candidate because it is experimental and still has some known bugs.
Our purpose is to do some internal testing before releasing this to the public. This is the version that we will ship to the public once it passes internal testing.
Download for your relevant platform (macOS = darwin) and unzip, double-click to use.
Running Instructions
General: If you want to move the installation then move the entire directory since there are folders such as .kelp and vendor that are required for Kelp to run
Windows
Prerequisite: You need to install Xming, which is an X-Server for windows. This is required to render the GUI of Kelp.
You need to run the kelp-start.bat file so it runs under the linux subsystem.
For any other issues that pop up, see the Linux section below
Linux
If your bot get stuck at the point where it is waiting for CCXT to start up.
- Go to .kelp/ccxt/ccxt-rest_linux-x64 and run ./ccxt
- If you see the error “version ‘GLIBCXX-3.4.21’ not found” then try this solution (both parts): https://askubuntu.com/a/582910
Ubuntu
sudo apt-get install -y build-essential clang libdbus-1-dev libgtk-3-dev libnotify-dev libgnome-keyring-dev libasound2-dev libcap-dev libcups2-dev libxtst-dev libxss1 libnss3-dev gcc-multilib g++-multilib curl gperf bison python-dbusmock openjdk-8-jre libX11-xcb-dev libstdc++6
RHEL / CentOS / Fedora
https://www.electronjs.org/docs/development/build-instructions-linux
MacOS
This version is not code signed for MacOS, but there is a workaround.
You need to copy Kelp.app from the DMG file into the /Applications folder (shortcut in the DMG) and run it from /Applications.
Goal
The goal is to catch any obvious bugs that we may have missed
Capabilities
You should be able to see over 100 exchanges available in the price feeds via CCXT.
Limitations
- This will only run on the test network for now
- When you double-click to run it, it will first automatically download one dependency in the background (~50 MB) to enable the UI to work. You will see nothing when this happens, which is expected for rc1. This will be fixed in rc2.
What to test
- The GUI opens up correctly on your platform
- Ensure that you can create, update, and modify bots.
- You can trade against a market, defaulting to the "COUPON" market against XLM.
- See your offers in stellar.expert and interstellar.exchange directly from within the Kelp GUI.
How is this different from the Kelpathon?
The Kelpathon tested the web-version of the Kelp GUI.
This test is for the downloadable desktop application of the Kelp GUI.
How much time should I spend on this
20-60 minutes based on your level of interest and curiosity.
How can I get more tokens?
The secret key for the COUPON:GBMMZMK2DC4FFP4CAI6KCVNCQ7WLO5A7DQU7EC7WGHRDQBZB763X4OQI asset issuer is SANPCJHHXCPRN6IIZRBEQXS5M3L2LY7EYQLAVTYD56KL3V7ABO4I3ISZ
Where can I file issues
File a bug report on github
Where can I get help if I am stuck
The #kelp channel on slack
Can I share this externally?
Not yet. We will be sharing it externally within the next two weeks along with a public announcement.
Kelp GUI v0.0.1-rc1 (internal)
This is v0.0.1-rc1, the first release candidate for the Kelp GUI.
This is a release-candidate because it is experimental and still has some known bugs.
Our purpose is to do some internal testing before releasing this to the public. This is the version that we will ship to the public once it passes internal testing.
Download for your relevant platform (macOS = darwin) and unzip, double-click to use.
Goal
The goal is to catch any obvious bugs that we may have missed
Capabilities
You should be able to see over 100 exchanges available in the price feeds via CCXT.
Limitations
- This will only run on the test network for now
- When you double-click to run it, it will first automatically download one dependency in the background (~50 MB) to enable the UI to work. You will see nothing when this happens, which is expected for rc1. This will be fixed in rc2.
What to test
- The GUI opens up correctly on your platform
- Ensure that you can create, update, and modify bots.
- You can trade against a market, defaulting to the "COUPON" market against XLM.
- See your offers in stellar.expert and interstellar.exchange directly from within the Kelp GUI.
How is this different from the Kelpathon?
The Kelpathon tested the web-version of the Kelp GUI.
This test is for the downloadable desktop application of the Kelp GUI.
How much time should I spend on this
20-60 minutes based on your level of interest and curiosity.
How can I get more tokens?
The secret key for the COUPON:GBMMZMK2DC4FFP4CAI6KCVNCQ7WLO5A7DQU7EC7WGHRDQBZB763X4OQI asset issuer is SANPCJHHXCPRN6IIZRBEQXS5M3L2LY7EYQLAVTYD56KL3V7ABO4I3ISZ
Where can I file issues
File a bug report on github
Where can I get help if I am stuck
The #kelp channel on slack
Can I share this externally?
Not yet. We will be sharing it externally within the next two weeks along with a public announcement.