harmonic-pattern-cli

Dependency-light command-line scanner for Fibonacci harmonic trading patterns from OHLCV CSV files.

It detects XABCD swing structures and validates common harmonic patterns with configurable Fibonacci tolerance:

• Gartley
• Bat
• Butterfly
• Crab

Educational use only; not financial advice. Validate patterns independently and manage risk.

Install

python -m pip install git+https://github.com/mattpartida/harmonic-pattern-cli.git

For local development:

git clone https://github.com/mattpartida/harmonic-pattern-cli.git
cd harmonic-pattern-cli
python -m pip install -e .

CSV format

Required columns:

timestamp,open,high,low,close,volume
2026-01-01,100,101,99,100.5,1000000

volume is optional. All price columns must be numeric.

Usage

JSON output:

harmonic-pattern scan examples/sample_gartley.csv --format json --tolerance 0.06

Markdown output:

harmonic-pattern scan examples/sample_gartley.csv --format markdown --tolerance 0.06

From source without installing:

PYTHONPATH=src python -m harmonic_pattern_cli.cli scan examples/sample_gartley.csv --format json

Output fields

Each pattern includes:

• pattern: pattern type, e.g. gartley
• direction: bullish or bearish
• points: X, A, B, C, D pivots
• ratios: XAB, ABC, BCD, XAD Fibonacci ratios
• entry_zone: D point ± 1%
• stop_loss: beyond X point
• targets: 38.2% and 61.8% retracements of C-D
• risk_reward: target-2 reward divided by stop risk
• invalidation: plain-English invalidation level

Example

$ harmonic-pattern scan examples/sample_gartley.csv --format markdown --tolerance 0.06
# Harmonic Pattern Scan

Source: `examples/sample_gartley.csv`

## 1. Gartley (bullish)
...

Development

Run tests:

PYTHONPATH=src python -m unittest discover -s tests -q

Compile check:

python -m compileall -q src tests

Package smoke:

python -m build
python -m venv /tmp/hpc-smoke
/tmp/hpc-smoke/bin/python -m pip install dist/*.whl
/tmp/hpc-smoke/bin/harmonic-pattern --version

Limitations

This is an MVP scanner. Harmonic trading is sensitive to pivot selection, timeframe, liquidity, and market regime. Treat signals as candidates for further chart review, not as trade recommendations.