Skip to main content

A high-performance terminal-native crypto signal scanner with live Z-score analytics, DEAP-based RL tuning, and automated backtesting.

Project description

Cb-signalTUI

Build

img

Features

  • Real-Time Cryptocurrency Scanning: Continuously scans a wide range of crypto pairs for trade signals.
  • Dynamic Technical Analysis: Uses adaptive Exponential Moving Averages (EMA), Z-scores, slope detection, RSI, and volatility analysis.
  • Reinforcement Learning Optimization: Dynamically tunes Z-score thresholds using DEAP-based RL algorithms.
  • Strategy Classification: Differentiates between momentum, reversal, and neutral strategies.
  • Live Terminal UI: Displays results in a color-coded, real-time TUI with rich.live.
  • Asynchronous Data Fetching: Utilizes aiohttp and retries on failure for reliable data streaming.
  • Voice Alerts: Uses pyttsx3 for real-time vocal alerts when high-confidence signals occur.
  • Database Logging: Stores all signal events with aiosqlite for historical reference.
  • Backtesting Accuracy: Includes a backtesting module to evaluate signal performance.
  • Custom Configs per Asset: Each asset has its own EMA and Z-score threshold settings.
  • Auto-Build Artifacts: Built packages are committed to /built/ on each push to main.

Project Structure

Cb-signalTUI/
├── cb_signal_tui/             # Main package directory
│   ├── __init__.py
│   └── __main__.py            # Entry point with config
├── built/                     # Auto-committed build artifacts (.whl, .tar.gz)
│   └── cb_signal_tui-*.whl
├── dist/                      # Local build output (ignored by .git)
├── .github/
│   └── workflows/
│       └── build.yml          # GitHub Actions workflow
├── requirements.txt           # Dependencies
├── pyproject.toml             # Build system config
├── README.md                  # Project documentation
└── signals.db                 # SQLite DB (optional, runtime-generated)

Installation

  1. Clone this repository:

    git clone https://github.com/LoQiseaking69/Cb-signalTUI.git
    cd Cb-signalTUI
    
  2. Install the required dependencies:

    pip install -r requirements.txt
    
  3. (Optional) Export a shortcut path to the .whl package for faster installs:

    echo 'export cb_sigTUI="$HOME/Desktop/Cb-signalTUI-main/built/*.whl"' >> ~/.bashrc
    source ~/.bashrc
    

    Now you can install with:

    pip install $cb_sigTUI
    

Dependencies

aiohttp
aiosqlite
pandas
numpy
pyttsx3
rich
scipy
deap
tabulate

Usage

Run the scanner:

cb-signal-tui

Example Output

img

Configuration

Edit settings in cb_signal_tui/__main__.py:

  • PRODUCTS: Assets to scan (BTC-USD, ETH-USD, etc.)
  • SETTINGS: EMA periods and Z-score threshold settings per asset
  • Z_SCORE_WINDOW, VOLATILITY_THRESHOLD, FLAT_SLOPE_THRESHOLD: Signal tuning
  • STRATEGY_FILTER: Control which strategies trigger alerts (momentum, reversal)
  • ALERT_CONFIDENCE_THRESHOLD: Minimum confidence for triggering an alert
  • REFRESH_INTERVAL: Refresh rate for terminal UI
  • GRANULARITY: Time granularity for fetched data (in seconds)

Database

SQLite database (signals.db) schema:

CREATE TABLE IF NOT EXISTS signals (
    timestamp TEXT,
    asset TEXT,
    price REAL,
    z_score REAL,
    signal TEXT,
    confidence REAL,
    strategy TEXT
);

Backtesting

Run the backtesting module to evaluate signal accuracy:

python3 __main__.py --backtest

The backtest fetches historical data and compares signal predictions with actual price movements.

Contributing

  1. Fork this repository.
  2. Create a new branch (git checkout -b my-feature).
  3. Make your changes.
  4. Push and open a Pull Request.

Built for precision. Tuned for performance. Stay ahead of the market.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cb_signal_tui-1.2.2.tar.gz (10.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cb_signal_tui-1.2.2-py3-none-any.whl (10.9 kB view details)

Uploaded Python 3

File details

Details for the file cb_signal_tui-1.2.2.tar.gz.

File metadata

  • Download URL: cb_signal_tui-1.2.2.tar.gz
  • Upload date:
  • Size: 10.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.10.17

File hashes

Hashes for cb_signal_tui-1.2.2.tar.gz
Algorithm Hash digest
SHA256 1c48f607bb076701aabec1bc02cf13414a3be4ef417e39f5b298a71a3f3adc18
MD5 14a2cda1eac9bf55466a8010b631c536
BLAKE2b-256 5d2b091a3ff68dfb72db426ff071dd366991fff6db01d3a389166b7c6b9c9962

See more details on using hashes here.

File details

Details for the file cb_signal_tui-1.2.2-py3-none-any.whl.

File metadata

  • Download URL: cb_signal_tui-1.2.2-py3-none-any.whl
  • Upload date:
  • Size: 10.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.10.17

File hashes

Hashes for cb_signal_tui-1.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 a38c88f561be0b1c3fb1f209cf2ebedd42aab1d0eb51b2c89b711de046c46305
MD5 b08ae813111ca8949bf15259a28b3a84
BLAKE2b-256 f24212ce4d0782a440aec1c0d204ee87f16b721b5507fac9bedbd0460ef403cc

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page