semvec/pypi-packages huggingface dataset:
pykabu 0.1.3
Python library and CLI for Japanese stock market data
License: MIT
Requires Python: >=3.10
Keywords: kabu, nikkei, stock, cli, japan, finance, scraping

# pykabu

Python library and CLI for Japanese stock market data.

## Requirements

- Python 3.10+

## Installation

### Quick Install (Global)

```bash
# 1. Install pykabu
pip install pykabu

# 2. Install browser for market index feature
playwright install chromium
```

### Recommended: Virtual Environment with uv

[uv](https://docs.astral.sh/uv/) is a fast Python package manager written in Rust.

**Step 1: Install uv** (one-time setup)

```bash
# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows (PowerShell)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
```

**Step 2: Create virtual environment and install**

```bash
# Create virtual environment
uv venv

# Activate it
source .venv/bin/activate   # macOS / Linux
.venv\Scripts\activate      # Windows (PowerShell)

# Install pykabu
uv pip install pykabu

# Install browser for market index feature
playwright install chromium
```

### Alternative: pip + venv

```bash
# Create virtual environment
python -m venv .venv

# Activate it
source .venv/bin/activate   # macOS / Linux
.venv\Scripts\activate      # Windows (PowerShell)

# Install pykabu
pip install pykabu

# Install browser for market index feature
playwright install chromium
```

### Platform Notes

- **macOS**: Works out of the box
- **Windows**: Use PowerShell (not CMD)
- **Linux**: If playwright fails, run: `playwright install-deps chromium`

## CLI Usage

```bash
kabu sche              # Today's schedule
kabu sche -t           # Tomorrow's schedule
kabu sche -w           # This week's schedule
kabu sche -i 3         # Filter by importance (>= 3 stars)

# Market indices
kabu index             # Default 8 indices
kabu index --all       # All known indices (~25)
kabu index --custom    # Custom configured indices
kabu index --merged    # Default + custom indices

# Nikkei 225 contribution ranking
kabu rank225           # Show top & bottom contributors
kabu rank225 --top     # Top contributors only
kabu rank225 --bottom  # Bottom contributors only

# Sector ranking
kabu rank_sec          # Show top gainers & losers
kabu rank_sec --top    # Top gainers only
kabu rank_sec --bottom # Top losers only

# Configuration
kabu config show                      # Show current config
kabu config set default_importance 3  # Set default star filter

# Custom indices
kabu config index list                # List all available codes
kabu config index add 212             # Add NASDAQ
kabu config index add 1001            # Add Bitcoin
kabu config index remove 212          # Remove an index
```

## Library Usage

```python
from pykabu.sources import nikkei225

# Schedule data
schedule = nikkei225.get_schedule()
today = nikkei225.get_today_schedule()
tomorrow = nikkei225.get_tomorrow_schedule()
week = nikkei225.get_week_schedule()

# Market indices (requires playwright)
indices = nikkei225.get_indices()
```

## Data Sources

- [nikkei225jp.com](https://nikkei225jp.com) - Economic calendar and market indices
grapho-mathcore 0.1.0
Safe mathematical evaluation and utilities
License: MIT
Requires Python: >=3.1

## API

### -> safe_eval
safe_eval(expr, variables=None, degrees=False)

Evaluates a mathematical expression safely.

### -> solve_equation
solve_equation(expr, var="x", interval=(-10,10), constraint=None)

Solves equations numerically.

### -> convert_base
convert_base(value, from_base, to_base)

Converts numbers between bases.

### -> value_table
value_table(expr, var="x", start=0, end=10, step=1)

Generates a table of values for a function.