Upload README.md with huggingface_hub

README.md

@@ -0,0 +1,231 @@
+<div align="center">
+
+# PythonSTB PyPI 3.12 By Rimi
+
+### Python 3.12 Wheels for Android
+
+[![Python 3.12](https://img.shields.io/badge/Python-3.12-blue?logo=python&logoColor=white)](https://www.python.org/)
+[![Android](https://img.shields.io/badge/Android-24+-green?logo=android&logoColor=white)](https://developer.android.com)
+[![Arch](https://img.shields.io/badge/Arch-arm64_+_x86__64-orange)](https://huggingface.co/PythonSTB/pypi312/tree/main)
+[![License](https://img.shields.io/badge/License-Proprietary-yellow.svg)](LICENSE)
+
+</div>
+
+---
+
+## Overview
+
+A **PEP 503 compliant** simple repository hosting **Python 3.12 Wheels By Rimi** for Android.
+
+Wheels built info:
+- **Android API 24+** minimum
+- **Dual architecture**: `arm64_v8a` (real devices) + `x86_64` (emulators)
+
+---
+
+## Quick Start
+
+### Install via pip
+
+```bash
+pip install --extra-index-url https://huggingface.co/PythonSTB/pypi312/resolve/main/ <package>
+```
+
+### Example: Install numpy
+
+```bash
+pip install --extra-index-url https://huggingface.co/PythonSTB/pypi312/resolve/main/ numpy
+```
+
+---
+
+## Available Packages
+
+| Package | Architectures | Description |
+|---------|---------------|-------------|
+| aiohttp | arm64_v8a, x86_64 | Async HTTP client/server |
+| bcrypt | arm64_v8a, x86_64 | Password hashing |
+| blosc | arm64_v8a, x86_64 | Compression |
+| cffi | arm64_v8a, x86_64 | C FFI |
+| duckdb | arm64_v8a, x86_64 | Analytical database |
+| greenlet | arm64_v8a, x86_64 | Lightweight coroutines |
+| lxml | arm64_v8a, x86_64 | XML/HTML parsing |
+| matplotlib | arm64_v8a, x86_64 | Plotting library |
+| numpy | arm64_v8a, x86_64 | Numerical computing |
+| opencv | arm64_v8a, x86_64 | Computer vision |
+| pandas | arm64_v8a, x86_64 | Data analysis |
+| pillow | arm64_v8a, x86_64 | Image processing |
+| psutil | arm64_v8a, x86_64 | System monitoring |
+| pydantic | arm64_v8a, x86_64 | Data validation |
+| PyNaCl | arm64_v8a, x86_64 | Networking crypto |
+| PyYAML | arm64_v8a, x86_64 | YAML parser |
+| scikit-image | arm64_v8a, x86_64 | Image algorithms |
+| scipy | arm64_v8a, x86_64 | Scientific computing |
+| tkinter | arm64_v8a, x86_64 | GUI toolkit (Tcl/Tk 8.6) |
+| + many more | | [See full list below](https://huggingface.co/PythonSTB/pypi312/tree/main) |
+
+<details>
+<summary><h2>Some of Package List</h2></summary>
+
+| Package | Architectures |
+|---------|---------------|
+| aiohttp | arm64_v8a, x86_64 |
+| blosc | arm64_v8a, x86_64 |
+| brotli | arm64_v8a, x86_64 |
+| cchardet | arm64_v8a, x86_64 |
+| contourpy | arm64_v8a, x86_64 |
+| duckdb | arm64_v8a, x86_64 |
+| greenlet | arm64_v8a, x86_64 |
+| lightgbm | arm64_v8a, x86_64 |
+| markupsafe | arm64_v8a, x86_64 |
+| msgpack | arm64_v8a, x86_64 |
+| numpy | arm64_v8a, x86_64 |
+| orjson | arm64_v8a, x86_64 |
+| pillow | arm64_v8a, x86_64 |
+| propcache | arm64_v8a, x86_64 |
+| psycopg2 | arm64_v8a, x86_64 |
+| pyaudio | arm64_v8a, x86_64 |
+| PyNaCl | arm64_v8a, x86_64 |
+| pyzmq | arm64_v8a, x86_64 |
+| rpds-py | arm64_v8a, x86_64 |
+| scipy | arm64_v8a, x86_64 |
+| ujson | arm64_v8a, x86_64 |
+| wrapt | arm64_v8a, x86_64 |
+| yarl | arm64_v8a, x86_64 |
+
+</details>
+
+---
+
+## Repository Structure
+
+```
+pypi312/
+└── wheels/       ← PEP 503 index root
+    ├── numpy/
+    │   ├── Test_NumPy.py
+    │   ├── numpy-2.5.2-cp312-cp312-android_24_arm64_v8a.whl
+    │   ├── numpy-2.5.2-cp312-cp312-android_24_x86_64.whl
+    │   └── NUMPY_USER_GUIDE.txt
+    ├── pandas/
+    │   ├── Test_Pandas.py
+    │   ├── pandas-2.3.3-cp312-cp312-android_24_arm64_v8a.whl
+    │   ├── pandas-2.3.3-cp312-cp312-android_24_x86_64.whl
+    │   └── PANDAS_USER_GUIDE.txt
+    └── <package>/
+        ├── Test_Scrtip.py
+        ├── <package>-<version>-<tags>.whl
+        └── USER_GUIDE.txt
+```
+
+---
+
+## Installation Guide
+
+### Option A: Extra Index URL (Recommended)
+
+```bash
+pip install --extra-index-url https://huggingface.co/PythonSTB/pypi312/resolve/main/ <package>
+```
+
+### Option B: Find-Links (Per Package)
+
+```bash
+pip install --find-links https://huggingface.co/PythonSTB/pypi312/resolve/main/<package>/ <package>
+```
+
+### Option C: Global pip Configuration
+
+**Windows** (`%APPDATA%\pip\pip.ini`):
+```ini
+[global]
+extra-index-url = https://huggingface.co/PythonSTB/pypi312/resolve/main/
+```
+
+**Linux/macOS** (`~/.pip/pip.conf`):
+```ini
+[global]
+extra-index-url = https://huggingface.co/PythonSTB/pypi312/resolve/main/
+```
+
+Install plain `pip install <package>`.
+
+---
+
+## Android App Integration
+
+### Python Code Example
+
+```python
+import subprocess
+import sys
+
+HF_INDEX = "https://huggingface.co/PythonSTB/pypi312/resolve/main/"
+
+subprocess.check_call([
+    sys.executable, "-m", "pip", "install",
+    "--extra-index-url", HF_INDEX,
+    "numpy",
+    "pandas",
+    "duckdb",
+])
+```
+
+### PipManager (PythonSTB)
+
+PipManager is a built-in package manager for installing Python packages on Android.
+
+**How to use:**
+
+1. Open PipManager from the home screen
+2. Type package name(s) in the text field — **space separated** for multiple packages
+3. Click **INSTALL**
+
+**Examples:**
+
+| Input | What it does |
+|-------|--------------|
+| `requests` | Install requests |
+| `requests[socks]` | Install with extras |
+| `numpy pandas duckdb` | Install 3 packages at once |
+| `colorama pyyaml six` | Install multiple small packages |
+
+**Options:**
+- **Upgrade** — upgrade to latest version
+- **Reinstall** — force reinstall
+- **Uninstall** — remove a package
+- **NoDeps** — install without dependencies
+- **NoCache** — install without using the cache
+
+**Features:**
+- Live pip output in built-in terminal
+- Smart detection — skips install if already installed
+- Auto-logs: `✅` success, `❌` failure, `💡` hints for common issues
+- Supports version specifiers: `numpy==2.5.2`, `pandas>=2.0`
+
+---
+
+## Package Naming (PEP 503)
+
+| Rule | Example |
+|------|---------|
+| Folder name: **lowercase** | `PyNaCl` → `pynacl` |
+| Replace `[_.,]` with `-` | `my_package` → `my-package` |
+| Wheel filename: **keep original case** | `PyNaCl-1.5.0-...whl` |
+
+---
+
+## License
+
+PROPRIETARY
+
+---
+
+<div align="center">
+
+**Built with care for the Android Python community**<br>
+**Creator and Coder by RIMI Dev**
+
+[Python](https://www.python.org/) • [Android](https://developer.android.com)
+
+</div>