Metadata-Version: 2.3
Name: tradr
Version: 0.1.1
Summary: Terminal-first trading cockpit with Textual, Plotext charts, AI chat, and a live watchlist
Keywords: textual,crypto,terminal,trading,stocks,plotext,watchlist
Author: wiseman-umanah
Author-email: wiseman-umanah <wisemanumanah@gmail.com>
License: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Environment :: Console
Classifier: Topic :: Office/Business :: Financial :: Investment
Requires-Dist: alpaca-py>=0.43.2
Requires-Dist: groq>=1.1.2
Requires-Dist: plotext>=5.3.2
Requires-Dist: rich>=14.3.3
Requires-Dist: textual>=8.2.3
Requires-Dist: textual-dev>=1.8.0
Requires-Dist: textual-plotext>=1.0.1
Requires-Dist: yfinance>=1.2.1
Requires-Python: >=3.11
Project-URL: Homepage, https://github.com/wiseman-umanah/tradr
Project-URL: Issues, https://github.com/wiseman-umanah/tradr/issues
Project-URL: Repository, https://github.com/wiseman-umanah/tradr
Description-Content-Type: text/markdown

<img width="1359" height="620" alt="Screenshot From 2026-04-12 00-52-37" src="https://github.com/user-attachments/assets/ac78f801-8f70-4e6b-9975-887f1af09f53" />

<img width="1359" height="620" alt="Screenshot From 2026-04-12 00-52-53" src="https://github.com/user-attachments/assets/9cc216e5-9347-4eb7-bc5e-9384be5709d1" />


# Tradr

Tradr is a Textual-based terminal trading desk built by **Wiseman Umanah**. It combines a live ASCII candlestick chart, an AI-powered chat console, and a continuously updating watchlist sourced from Yahoo Finance screeners.

## Features

- **Live chart**: Plotext candlesticks that refresh automatically and follow the app's light/dark theme.
- **AI + commands**: A chat console where quick commands (`chart`, `watch`, `analyze`, `set-key`, `about`, etc.) coexist with a Groq-backed assistant.
- **Dynamic watchlist**: Dozens of trending tickers, rotating through a cached universe, with keyboard focus + scrolling.


## Getting Started

### Linux/macOS via install script

```bash
curl -fsSL https://raw.githubusercontent.com/wiseman-umanah/tradr/refs/heads/master/install.sh | bash
```

The script installs dependencies with `uv`, sets up entry points, and guides you through launching `tradr-dev`.

### Windows / manual install

```bash
pip install tradr
# or, for development:
uv sync
uv run tradr
```

Set `GROQ_API_KEY="gsk_..."` (or run `set-key <gsk_...>` inside the app), press `d` to toggle the theme, type `help` to see every command, and run `about` to view author details.

## About the Author

Created by **Wiseman Umanah** ([@wiseman-umanah](https://github.com/wiseman-umanah)). Feel free to reach out for feedback, collaborations, or feature ideas.
