Jesse

Getting Started

We understand the importance of getting started quickly and easily. So we've taken care of all the hard work for you.

Environment Setup

Here is the required stack:

  • Python >= 3.8 and < 3.10
  • pip >= 19.3.0
  • PostgreSQL >= 10
  • Redis >= 5
  • ta-lib >= 0.4

You have two options for your environment. To use the docker, which is the fastest way to get started, or to install the required stack natively. Choose the option that suits you best:

PIP Installation

If you went with the docker option, then Jesse is installed for you and you don't have to do anything else. If you went with the native installation, then you have to install Jesse via pip:

pip install jesse

(Optional) Install numba (Doesn't work on M1 macs at the moment):

pip install numba==0.53

This package speeds up some indicators. M1 mac users can't use it.

Upgrade with PIP

We are constantly pushing new patches. To upgrade to the latest version run:

pip install -U jesse

(Optional) If you use numba, you then have to update it too.

pip install -U numba

WARNING

Sometimes pip doesn't upgrade to the latest version on the first time running the above command. To make sure you're running the latest release, check out the latest version number on PyPiopen in new window, and then make sure you see that version in pip show jesse output.

Create a new Jesse project

You'll need to create your own Jesse project to define your very own strategies.

Go to the directory you intend to create the project in and run:

# change the name "my-bot" to whatever you want
git clone https://github.com/jesse-ai/project-template my-bot
# enter the directory
cd my-bot
# create a .env file by copying it from the template
cp .env.example .env

This will create a new project containing only files and folders that you actually need:

├── .env # file where you enter the dashboard password, database credentials, etc
├── plugins.py # file where you register installed plugins
├── docker # directory containing the required config files for docker
├── storage # directory containing logs, chart images, etc
└── strategies # directory containing your strategies
    ├── Strategy01
    │   └─ __init__.py
    └── Strategy02
        └─ __init__.py

Start Jesse

If you are using Jesse via Docker, you don't need to run anything as it is explained in the Docker documentation. For native setups however, to get the party started, (inside your Jesse project) first make sure that the values for both POSTGRES_HOST and REDIS_HOST are set to localhost. And then run the application by:

jesse run

And it will print a local URL for you to open in your browser such as:

INFO:     Started server process [66103]
INFO:     Waiting for application startup.
INFO:     Application startup complete.
INFO:     Uvicorn running on http://0.0.0.0:9000 (Press CTRL+C to quit)

Go ahead and open (in my case) 127.0.0.1:9000 in your browser of choice. If you are running on a server, you can use the IP address of the server instead of 0.0.0.0.

So for example if the IP address of your server is 1.2.3.4 the URL would be http://1.2.3.4:9000open in new window.

TIP

If you want to change the default 9000 port, you can do it by modifying the APP_PORT value in your project's .env file.