We understand the importance of getting started quickly and easily. So we've taken care of all the hard work for you.
Here is the required stack:
- Python >=
- pip >=
- PostgreSQL >=
- Redis >=
- ta-lib >=
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:
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 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
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
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
REDIS_HOST are set to
localhost. And then run the application by:
And it will print a local URL for you to open in your browser such as:
INFO: Started server process  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
So for example if the IP address of your server is
22.214.171.124 the URL would be http://126.96.36.199:9000open in new window.
If you want to change the default
9000 port, you can do it by modifying the
APP_PORT value in your project's