Metadata-Version: 2.4
Name: nepse-cli
Version: 3.1.30
Summary: Modern CLI tool for Meroshare IPO automation and NEPSE market data with interactive TUI
Home-page: https://github.com/menaceXnadin/nepse-cli
Author: MenaceXnadin
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: playwright>=1.40.0
Requires-Dist: prompt_toolkit>=3.0.48
Requires-Dist: rich>=13.0.0
Requires-Dist: textual>=0.60.0
Requires-Dist: colorama>=0.4.6
Requires-Dist: requests>=2.25.0
Requires-Dist: beautifulsoup4>=4.9.0
Requires-Dist: cloudscraper>=1.2.0
Requires-Dist: tenacity>=9.0.0
Requires-Dist: lxml>=4.9.0
Requires-Dist: curl-cffi>=0.7.0
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# Nepse CLI - Meroshare IPO Automation & Market Data

[![PyPI version](https://badge.fury.io/py/nepse-cli.svg?cacheSeconds=1)](https://badge.fury.io/py/nepse-cli)
[![Python Version](https://img.shields.io/pypi/pyversions/nepse-cli.svg)](https://pypi.org/project/nepse-cli/)
[![PyPI Downloads](https://static.pepy.tech/personalized-badge/nepse-cli?period=total&units=NONE&left_color=BLACK&right_color=GREEN&left_text=downloads)](https://pepy.tech/projects/nepse-cli)

![Nepse CLI](https://res.cloudinary.com/dzbc5mlm9/image/upload/v1768644603/nepse-cli-image_tcx7tx.png)

A professional command-line tool for NEPSE market analysis and automated Meroshare IPO applications.

[Watch on YouTube](https://youtu.be/S7aOPU2NkIQ)

## Installation

Install (from source or PyPI):

```bash
# From PyPI (recommended when available)
pip install nepse-cli

# Or run directly from the repository for development
python main.py

# On Windows you can also use the bundled start script
start_nepse.bat
```

## Overview

Nepse CLI is a command-line tool for Nepal Stock Exchange (NEPSE) users. It provides automated Meroshare IPO application flows (fast API-based and legacy browser automation), market data, portfolio reporting, and member management.

### Key Features

**IPO Automation**
- Fast API-based IPO application (`apply` for single member, `apply-all` for all members)
- Legacy browser automation is available but deprecated (`apply-legacy`, `apply-all-legacy`)
- Multi-member support and allotment/result checking (`result`, `ipo-status`)

**Market Analysis**
- Real-time NEPSE indices (Main, Sensitive, Float, Sector-wise)
- Comprehensive stock information and live prices
- Fundamental analysis and company profiles
- Market depth and order book visualization
- Trading signals and price alerts
- Floor sheet with live trade data
- 52-week performance tracking
- Broker rankings and analysis

**Portfolio Management**
- Multi-member portfolio tracking
- Real-time profit/loss calculation with WACC
- Secure local credential storage
- Interactive member management
- Portfolio visualization and reporting

**User Experience**
- Interactive shell with searchable command palette (`/`)
- Autocompletion and persisted history
- Rich-formatted output and progress indicators

## Requirements

- Python 3.8 or higher
- Windows, Linux, or macOS
- Internet connection
- Meroshare account (for IPO features)

Optional (legacy flows): Playwright and a browser if you intend to use browser automation commands.

## Available Commands (current)

### Market Data
- `nepse` — Display NEPSE indices
- `subidx <name>` — Show sub-index details
- `mktsum` — Display market summary
- `topgl` — Show top gainers and losers
- `stonk <symbol>` — Show stock details (supports multiple symbols)
- `ph <symbol>` — Interactive price history view
- `52week` — Stocks at 52-week high/low
- `near52` — Stocks near 52-week high/low
- `floor [symbol] [--date YYYY-MM-DD] [--buyer ID] [--seller ID] [--page N] [--size N]` — View floorsheet (with broker names)
- `holidays` — Show market holidays

### Stock Analysis
- `profile <symbol>` — Company profile & info
- `fundamental <symbol>` — Stock fundamentals (EPS, P/E, Book Value)
- `depth <symbol>` — Market depth (order book)

### Trading Info
- `signals` — Strong buy/sell signals
- `announce` — Market announcements
- `brokers` — List all brokers
- `bsum [--1d|--1w|--1m]` — Broker net buy/sell summary
- `sectors` — List all sectors

### IPO Management
- `ipo` — List all open IPOs
- `ipo-status [member] [--limit N]` — Show IPO application status for a member
- `apply [member]` — Fast API-based IPO application (single member)
- `apply-all` — Fast API-based IPO application for all members (parallel)
- `schedule enable [--time HH:MM]` — Schedule daily auto-apply for applicable Ordinary Shares IPOs (default `09:00`)
- `schedule disable` — Remove the Nepse CLI scheduler entry
- `schedule status` — Show whether the scheduler is registered and at what time
- `schedule history` — Show recent scheduled IPO run history
- `apply-legacy [member] [--gui]` — Deprecated browser-based IPO application
- `apply-all-legacy [--gui]` — Deprecated browser-based IPO for all
- `result [member] [--all]` — Check IPO allotment results

Notes:
- The modern default is `apply` / `apply-all` which use the fast API flows.
- Legacy browser automation commands (`apply-legacy`, `apply-all-legacy`) require Playwright and may be removed in future releases.

### Member & Account Management
- `add` — Add new family member
- `list` — List all family members
- `edit` — Edit existing family member
- `delete` — Delete family member
- `manage` — Member management menu

### Meroshare Account & Portfolio
- `portfolio [name]` — Get real-time portfolio with P/L (includes WACC). If no name is provided, you'll be prompted to select a member.
- `wacc [name]` — Process pending WACC calculations
- `wacc-report [name]` — View WACC holdings report with P/L
- `info [name]` — Meroshare account information
- `login [name]` — Test login for member (GUI/headless depends on flags)
- `dp-list` — Search and list available DPs

### Interactive Tools
- `help | ? | /` — Show/search command palette
- `guide` — Open the tutorial link
- `dev` — Developer socials and links
- `clear | cls` — Clear the screen
- `exit | quit` — Exit the CLI

## Links

- **PyPI Package:** https://pypi.org/project/nepse-cli/
- **Documentation / Tutorial:** https://youtu.be/S7aOPU2NkIQ
- **Report Issues:** https://github.com/menaceXnadin/nepse-cli/issues

## License

MIT License

## Disclaimer

This tool is for educational and personal use only. Users are responsible for complying with Meroshare's terms of service and applicable regulations. The developers are not liable for any misuse or issues arising from the use of this tool.

## Acknowledgments

- Data sources: NEPSE, ShareSansar, ShareHubNepal
- Built with: Rich, Playwright, Click, Prompt Toolkit
- Community contributions and feedback

---

**Support:** For questions or issues, please open an issue on GitHub
