Metadata-Version: 2.3
Name: bullishpy
Version: 0.64.0
Summary: 
Author: aan
Author-email: andoludovic.andriamamonjy@gmail.com
Requires-Python: >=3.12,<3.13
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: bearishpy (>=0.26.0,<0.27.0)
Requires-Dist: click (>=7.0,<=8.1)
Requires-Dist: huey (>=2.5.3,<3.0.0)
Requires-Dist: joblib (>=1.5.1,<2.0.0)
Requires-Dist: pandas-ta (>=0.3.14b0,<0.4.0)
Requires-Dist: plotly (>=4.12.0,<6.0.0)
Requires-Dist: streamlit (>=1.45.1,<2.0.0)
Requires-Dist: streamlit-file-browser (>=3.2.22,<4.0.0)
Requires-Dist: streamlit-pydantic (>=v0.6.1-rc.3,<0.7.0)
Requires-Dist: ta-lib (>=0.6.4,<0.7.0)
Requires-Dist: tickermood (>=0.28.0,<0.29.0)
Requires-Dist: vectorbt (>=0.28.0,<0.29.0)
Description-Content-Type: text/markdown

# Bullish

**Bullish** is a high-powered stock screener that helps you quickly identify the best stock or trading opportunities in the market.  
It can scan **thousands of equities** across multiple markets, exchanges, and countries to uncover strong *buy* candidates.  

Bullish uses the well-known **TA-Lib** library to calculate popular technical analysis indicators—such as **RSI**, **MACD**, and moving averages—then lets you filter and select the strongest stocks from your **local database**.

---

## Why Bullish?
The main goals behind Bullish are:
- **Full control over your data** — no dependency on third-party screeners  
- **Local analysis** — run any type of screening or backtesting on your own system  

Bullish is built on:
- **bearish** – a Python library that fetches equity data from multiple sources (*yfinance*, *yahooquery*, *FMP*, …)  
- **tickermood** – retrieves recent, relevant news for screened tickers and uses LLMs to produce an investment recommendation.

---

## Prerequisites
### Install TA-Lib
Bullish depends on **TA-Lib** for technical analysis calculations.  
TA-Lib must be installed separately before using Bullish.  
See the [TA-Lib installation guide](https://ta-lib.org/) for instructions.

---

## Installation
```bash
pip install bullishpy
```

---

## Quick Start

### 1. Create a Bearish Database
A **bearish database** contains historical prices and fundamental data for all stocks in your chosen market.

Example: Create a database for the Belgian stock market:
```bash
bearish run ./bearish.db Belgium
```
You can replace `Belgium` with any supported country.  
**Note:** Building the database can take some time.

---

### 2. Run Bullish
Navigate to the folder containing your **bullish database** and run:
```bash
bullish
```
This launches a **local Streamlit app** where you can screen, filter, and analyze stocks interactively.

![img1.png](docs/img1.png)


![img.png](docs/img.png)

---

## What Bullish Is Not
Bullish is **not**:
- A real-time trading platform  
- A tool for intraday or high-frequency trading  

It is designed for **retail traders** and **swing traders** focusing on opportunities over days or weeks.
