ftui 0.1.13

Freqtrade TUI

Welcome to FTUI

Freqtrade Textual User Interface (FTUI) is a text-based interface for the Freqtrade bot.

FTUI is developed using the awesome Textual and Rich frameworks.

• Original concept and development: @froggleston
• Github : https://github.com/freqtrade/ftui

FTUI is in an alpha state so there will be bugs and missing features

Getting Started

FTUI is designed to mimic the FreqUI interface as much as possible, but the main difference is that FTUI does not currenty support controlling a running bot. Rather FTUI acts as a lightweight passive monitoring system for running Freqtrade bots.

Installation

Currently, FTUI is only supported on Linux systems. We hope to provide a Docker container in future.

The easiest way to install FTUI is via pip: pip install ftui

Linux

FTUI can be installed into an existing venv (e.g. a existing freqtrade venv) or in a new directory, e.g. ~/ftui, and venv as follows:

$ mkdir ~/ftui
$ cd ftui
$ python3 -m venv .venv
$ source .venv/bin/activate
$ pip3 install -r requirements.txt
$ pip3 install -e .

Once installed, a config.yaml needs to be provided to FTUI, so create it in your new ftui/ directory and edit it with a cli text editor like nano:

$ touch config.yaml
$ nano config.yaml

Configuration

FTUI is configured using a config.yaml file, where a list of running Freqtrade bots needs to be provided. An example has been provided to get you started as below:

---
servers:
    - name        : "botA"
      username    : "you"
      password    : "your_password"
      ip          : 1.2.3.4
      port        : 8080
    - name        : "botB"
      username    : "you"
      password    : "your_password"
      ip          : 1.2.3.4
      port        : 8081

    - name        : "botC"
      username    : "you"
      password    : "your_password"
      ip          : 5.6.7.8
      port        : 8080

colours:
    pair_col: "purple"
    bot_col: "yellow"
    bot_start_col: "white"
    trade_id_col: "white"
    open_rate_col: "white"
    current_rate_col: "white"
    open_date_col: "cyan"
    winrate_col: "cyan"
    open_trade_num_col: "cyan"
    closed_trade_num_col: "purple"
    profit_chart_col: "orange"
    link_col: "yellow"
    candlestick_trade_text_col: "orange"
    candlestick_trade_open_col: "blue"
    candlestick_trade_close_col: "purple"

debug: False
show_fear: True

Add a corresponding servers block into your own config.yaml, making note of the indentation.

You can monitor bots across multiple servers easily in one FTUI interface. FTUI uses the freqtrade-client REST API client, so you do not need to wrestle with any CORS setup as you have to do in FreqUI to access multiple bots.

You can also set custom colours for some of the UI elements as per the example above. The supported list of colour names can be found here. You can leave the colours option out of the configuration and defaults will be used.

In future, the Settings screen will allow configuration of the config.yaml from inside the FTUI interface.

Running FTUI

Once you have saved your config.yaml file, make sure you are in your ftui directory with your venv activated, and run FTUI as below. FTUI will load each bot client, and preload trade data into memory:

$ ftui -y config.yaml

███████╗████████╗██╗   ██╗██╗
██╔════╝╚══██╔══╝██║   ██║██║
█████╗     ██║   ██║   ██║██║
██╔══╝     ██║   ██║   ██║██║
██║        ██║   ╚██████╔╝██║
╚═╝        ╚═╝    ╚═════╝ ╚═╝

Freqtrade Textual User Interface (FTUI)

Run with:

    ftui -y config.yaml

Setting up botA version 2024.1-dev-1b70e9b07 at http://1.2.3.4:8080: SampleStrategy running dry_run 5m
Setting up botB version 2024.1-dev-1b70e9b07 at http://1.2.3.4:8081: SampleStrategy running dry_run 5m
Setting up botC version 2024.1-dev-1b70e9b07 at http://5.6.7.8:8080: SampleStrategy running dry_run 5m

Starting FTUI - preloading all dataframes.......

Screens

Dashboard

The main dashboard shows summary statistics from all bots. You can access the dashboard by clicking the Dashboard button in the bottom left, or hitting the D key.

View Bots

The bot view allows selection of a running bot from the dropdown at the top of the screen. Once selected, various information about the bot will be shown in the tabs in the bottom half of the screen. You can access the View Bots screen by clicking the button in the bottom left, or hitting the B key.

Open trades:

Closed trades:

Tag summary:

Performance:

General bot information:

Logs:

Sysinfo:

Settings

The Settings screen shows the list of configured bots on the left hand side of the screen. Other configuration options are shown on the right. You can access the Settings screen by clicking the button in the bottom left, or hitting the S key.

In future, you will be able to show and hide bots in FTUI by selecting/deselecting them in the bot list, as well as changing other configuration options. Currently this feature is disabled in this alpha release.

Help

This README!

Known Issues

General

• When the bot is been running and you put your PC to sleep, the async worker will bug out and intermittently crash the UI.
• The Settings screen save functionality is currently disabled.

urllib pool connection errors

When running a larger number of bots within one FTUI instance, you may see urllib/requests warnings about the pool connections being exhausted:

connection pool is full, discarding connection: 127.0.0.1. Connection pools size: 10

Raising the pool size limits can help avoid these warnings.

There are two command line/yaml config options that can be adjusted:

CLI

ftui -c config.json --pool_connections 20 --pool_maxsize 15

YAML config

pool_connections: 20
pool_maxsize: 15