Metadata-Version: 2.3
Name: k-nobg
Version: 0.1.1
Summary: KπX sovereign background removal — FeyNobg semantic matting (CPU / Intel Arc / NVIDIA CUDA)
Author: KpihX
Author-email: KpihX <kapoivha@gmail.com>
License: MIT
Requires-Dist: nobg>=0.2.5
Requires-Dist: loadimg>=0.1.0
Requires-Dist: typer>=0.15.1
Requires-Dist: rich>=15.0.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: torch>=2.0 ; extra == 'cpu'
Requires-Dist: torchvision>=0.15 ; extra == 'cpu'
Requires-Dist: torch>=2.0 ; extra == 'gpu-cuda'
Requires-Dist: torchvision>=0.15 ; extra == 'gpu-cuda'
Requires-Dist: torch>=2.0 ; extra == 'gpu-intel'
Requires-Dist: torchvision>=0.15 ; extra == 'gpu-intel'
Requires-Dist: intel-extension-for-pytorch>=2.0 ; extra == 'gpu-intel'
Requires-Dist: triton-xpu>=3.8.0 ; extra == 'gpu-intel'
Requires-Python: >=3.12
Provides-Extra: cpu
Provides-Extra: gpu-cuda
Provides-Extra: gpu-intel
Description-Content-Type: text/markdown

# k-nobg

KπX sovereign background removal — **FeyNobg** semantic alpha matting.

Three hardware profiles: **CPU**, **Intel Arc (XPU)**, **NVIDIA CUDA**.

## Install from Source

```bash
cd ~/Labs/KpihX-Labs/AI/nobg
```

### Editable

```bash
# CPU
uv tool install '.[cpu]' -e

# Intel Arc
uv tool install '.[gpu-intel]' -e

# NVIDIA CUDA
uv tool install '.[gpu-cuda]' -e
```

### Non-editable

```bash
# CPU
uv tool install '.[cpu]'

# Intel Arc
uv tool install '.[gpu-intel]'

# NVIDIA CUDA
uv tool install '.[gpu-cuda]'
```

### Purge

```bash
uv tool uninstall k-nobg
```

## Install from PyPI

```bash
# CPU
uv tool install k-nobg[cpu]

# Intel Arc
uv tool install k-nobg[gpu-intel]

# NVIDIA CUDA
uv tool install k-nobg[gpu-cuda]
```

### Purge

```bash
uv tool uninstall k-nobg
```

## Build / Publish

```bash
make build       # sdist + wheel
make publish     # build + publish to PyPI
make release     # check → push → publish
```

## Sources

- FeyNobg: https://github.com/feyninc/nobg
- Model: `feyninc/FeyNobg` (HuggingFace Hub, ~200 MB, auto-downloaded)
- Full reference: `~/.agents/skills/k-ai/references/remove-bg.md`
