chore: update package size references and simplify installation instructions

tae898 · tae898 · commit bf943da714ab · 2025-12-28T11:13:59.000+01:00
diff --git a/.github/workflows/test-python-bindings.yml b/.github/workflows/test-python-bindings.yml
@@ -364,7 +364,7 @@ jobs:
             echo "" >> $GITHUB_STEP_SUMMARY
             echo "The arcadedb-embedded package has been successfully built and tested." >> $GITHUB_STEP_SUMMARY
             echo "" >> $GITHUB_STEP_SUMMARY
-            echo "**Package**: arcadedb-embedded (~160MB with bundled JRE)" >> $GITHUB_STEP_SUMMARY
+            echo "**Package**: arcadedb-embedded" >> $GITHUB_STEP_SUMMARY
           else
             echo "❌ **Some platforms failed testing**" >> $GITHUB_STEP_SUMMARY
             echo "" >> $GITHUB_STEP_SUMMARY
diff --git a/README.md b/README.md
@@ -17,17 +17,9 @@
 ### Installation
 
 ```bash
-# Temporarily install from GitHub Pages (awaiting PyPI size limit approval)
-pip install arcadedb-embedded \
-  --index-url https://humemai.github.io/arcadedb-embedded-python/simple/ \
-  --extra-index-url https://pypi.org/simple/
-
-# Once PyPI approves our size limit request, installation will be simpler:
-# pip install arcadedb-embedded
+pip install arcadedb-embedded
 ```
 
-> **Note:** We're temporarily using GitHub Pages while awaiting PyPI size limit approval (~160MB wheels, default limit 100MB). The `--extra-index-url` ensures dependencies like JPype1 are installed from PyPI.
-
 **Requirements:**
 
 - **Python 3.8+** only - No Java installation required! (JRE is bundled)
diff --git a/bindings/python/README.md b/bindings/python/README.md
@@ -25,23 +25,9 @@ Quick links:
 ### Installation
 
 ```bash
-# Temporarily install from GitHub Pages (awaiting PyPI size limit approval)
-pip install arcadedb-embedded \
-  --index-url https://humemai.github.io/arcadedb-embedded-python/simple/ \
-  --extra-index-url https://pypi.org/simple/
-
-# Once PyPI approves our size limit request, installation will be simpler:
-# pip install arcadedb-embedded
-
-# Development version (latest features, may be unstable)
-pip install --pre arcadedb-embedded \
-  --index-url https://humemai.github.io/arcadedb-embedded-python/simple/ \
-  --extra-index-url https://pypi.org/simple/
+pip install arcadedb-embedded
 ```
 
-!!! note "PyPI Size Limit"
-We're temporarily hosting wheels on GitHub Pages while awaiting PyPI size limit approval (our wheels are ~164MB, default limit is 100MB). The `--index-url` tells pip to use our GitHub Pages index for arcadedb-embedded, while `--extra-index-url` ensures dependencies like JPype1 are installed from PyPI.
-
 **Requirements:**
 
 - **Python 3.8+ only** - No Java installation required!
diff --git a/bindings/python/build.sh b/bindings/python/build.sh
@@ -25,7 +25,7 @@ print_header() {
 print_usage() {
     echo "Usage: $0 [PLATFORM]"
     echo ""
-    echo "Builds arcadedb-embedded package with bundled JRE (~160MB)"
+    echo "Builds arcadedb-embedded package with bundled JRE"
     echo "No external Java installation required!"
     echo ""
     echo "PLATFORM:"
@@ -52,7 +52,7 @@ print_usage() {
     echo "  ✅ Bundled platform-specific JRE (no Java required)"
     echo "  ✅ Optimized JAR selection (see jar_exclusions.txt)"
     echo "  ✅ Multi-platform support (6 platforms)"
-    echo "  📦 Size: ~160MB (JRE ~63MB, JARs ~13MB, overhead ~84MB)"
+    echo "  📦 Size: ~215MB (compressed), ~289MB (installed)"
     echo ""
 }
 
diff --git a/bindings/python/docs/development/build-architecture.md b/bindings/python/docs/development/build-architecture.md
@@ -6,25 +6,24 @@ This document describes the build architecture for creating platform-specific Py
 
 **Goal:** Distribute a single `arcadedb-embedded` package that works on 6 platforms with **zero Java installation required**.
 
-**Achievement:** 6 platform-specific wheels (~155-161MB each) with bundled platform-specific JRE, built and tested on GitHub Actions using native runners.
+**Achievement:** 6 platform-specific wheels (~215MB each) with bundled platform-specific JRE, built and tested on GitHub Actions using native runners.
 
 ## Supported Platforms
 
 | Platform | Wheel Size | JRE Size | Runner | Build Method | Notes |
 |----------|-----------|----------|---------|--------------|-------|
-| **linux/amd64** | 160.9M | 62.7M | `ubuntu-24.04` | Docker native | Most common Linux platform |
-| **linux/arm64** | 159.9M | 61.8M | `ubuntu-24.04-arm` | Docker native | ARM64 servers, Raspberry Pi |
-| **darwin/amd64** | 157.8M | 55.3M | `macos-15-intel` | Native build | Intel Macs (2006-2020) |
-| **darwin/arm64** | 156.7M | 53.9M | `macos-15` | Native build | Apple Silicon Macs (2020+) |
-| **windows/amd64** | 157.4M | 51.5M | `windows-2025` | Native build | 64-bit Windows |
-| **windows/arm64** | 155.1M | 47.3M | `windows-11-arm` | Native build | ARM64 Windows (Surface, etc.) |
+| **linux/amd64** | 215.0M | 62.7M | `ubuntu-24.04` | Docker native | Most common Linux platform |
+| **linux/arm64** | 214.1M | 61.8M | `ubuntu-24.04-arm` | Docker native | ARM64 servers, Raspberry Pi |
+| **darwin/amd64** | 211.9M | 55.3M | `macos-15-intel` | Native build | Intel Macs (2006-2020) |
+| **darwin/arm64** | 210.8M | 53.9M | `macos-15` | Native build | Apple Silicon Macs (2020+) |
+| **windows/amd64** | 211.6M | 51.6M | `windows-2025` | Native build | 64-bit Windows |
+| **windows/arm64** | 209.4M | 47.6M | `windows-11-arm` | Native build | ARM64 Windows (Surface, etc.) |
 
 **All platforms:**
 
 - ✅ 205/205 tests passing
-- ✅ 167.4M JARs (83 files, identical across platforms)
+- ✅ 226.0M JARs (83 files, identical across platforms)
 - ✅ All native runners (no QEMU emulation)
-- ✅ ~40MB savings vs initial builds (195.9M → 155-161M)
 - ✅ Reproducible builds (pinned runner versions)
 
 ## Architecture
@@ -379,22 +378,22 @@ bindings/python/
 - Python package: ~5M
 - **Total:** 195.9M wheel
 
-### After Optimization (157-160M)
+### After Optimization (215M)
 
-- ArcadeDB JARs: 167.4M (83 files, gRPC excluded)
+- ArcadeDB JARs: 226.0M (83 files, gRPC excluded)
 - Bundled JRE: ~63M
 - Python package: ~5M
-- **Total:** 157-160M wheel
-- **Savings:** ~40MB per wheel
+- **Total:** ~215M wheel (compressed)
+- **Installed:** ~289M (uncompressed)
 
 ### Why Sizes Vary by Platform
 
 - JRE binaries differ by platform (different native code)
-- darwin/amd64: 157.8M (Intel Mac JRE)
-- darwin/arm64: 156.7M (Apple Silicon JRE, more efficient)
-- windows/amd64: 157.4M (Windows JRE)
-- linux/amd64: 160.9M (Linux x64 JRE)
-- linux/arm64: 159.9M (Linux ARM64 JRE)
+- darwin/amd64: ~215M (Intel Mac JRE)
+- darwin/arm64: ~215M (Apple Silicon JRE)
+- windows/amd64: ~215M (Windows JRE)
+- linux/amd64: ~215M (Linux x64 JRE)
+- linux/arm64: ~215M (Linux ARM64 JRE)
 
 ## Development
 
diff --git a/bindings/python/docs/development/ci-setup.md b/bindings/python/docs/development/ci-setup.md
@@ -102,29 +102,29 @@ You need to create one environment in GitHub repository settings:
 After a successful release, you should see:
 
 - **6 wheel files** on PyPI for `arcadedb-embedded` (one per platform):
-  - linux/amd64: ~160.9MB wheel
-  - linux/arm64: ~159.9MB wheel
-  - darwin/amd64: ~157.8MB wheel
-  - darwin/arm64: ~156.7MB wheel
-  - windows/amd64: ~157.4MB wheel
-  - windows/arm64: ~155.1MB wheel
+  - linux/amd64: ~215MB wheel
+  - linux/arm64: ~215MB wheel
+  - darwin/amd64: ~215MB wheel
+  - darwin/arm64: ~215MB wheel
+  - windows/amd64: ~215MB wheel
+  - windows/arm64: ~215MB wheel
 
 ### Test Results (CI run #96)
 
 All 6 platforms passing 205/205 tests:
 
 | Platform | Wheel Size | JRE Size | Tests |
 |----------|-----------|----------|-------|
-| linux/amd64 | 160.9M | 62.7M | 205/205 ✅ |
-| linux/arm64 | 159.9M | 61.8M | 205/205 ✅ |
-| darwin/amd64 | 157.8M | 55.3M | 205/205 ✅ |
-| darwin/arm64 | 156.7M | 53.9M | 205/205 ✅ |
-| windows/amd64 | 157.4M | 51.5M | 205/205 ✅ |
-| windows/arm64 | 155.1M | 47.3M | 205/205 ✅ |
+| linux/amd64 | ~215M | 62.7M | 205/205 ✅ |
+| linux/arm64 | ~215M | 61.8M | 205/205 ✅ |
+| darwin/amd64 | ~215M | 55.3M | 205/205 ✅ |
+| darwin/arm64 | ~215M | 53.9M | 205/205 ✅ |
+| windows/amd64 | ~215M | 51.5M | 205/205 ✅ |
+| windows/arm64 | ~215M | 47.3M | 205/205 ✅ |
 
 **All platforms include:**
 
-- 167.4M JARs (83 files, identical across platforms, gRPC excluded)
+- 226.0M JARs (83 files, identical across platforms, gRPC excluded)
 - Platform-specific JRE (47-63MB depending on platform)
 - Native runners (no QEMU emulation anywhere)
 
diff --git a/bindings/python/docs/getting-started/distributions.md b/bindings/python/docs/getting-started/distributions.md
@@ -6,15 +6,12 @@ ArcadeDB Python provides a **self-contained embedded** package that runs the dat
 
 | Package | Wheel Size | Installed Size | Java Required | Studio UI | Query Languages |
 |---------|-----------|----------------|---------------|-----------|----------------|
-| **arcadedb-embedded** | 155-161MB | ~215-230MB | ❌ No | ✅ | SQL, Cypher, Gremlin, MongoDB |
+| **arcadedb-embedded** | ~215MB | ~289MB | ❌ No | ✅ | SQL, Cypher, Gremlin, MongoDB |
 
 **Installation:**
 
 ```bash
-# Temporarily install from GitHub Pages (awaiting PyPI size limit approval)
-pip install arcadedb-embedded \
-  --index-url https://humemai.github.io/arcadedb-embedded-python/simple/ \
-  --extra-index-url https://pypi.org/simple/
+pip install arcadedb-embedded
 ```
 
 **Requirements:** Python 3.8+ only - No Java installation needed!
@@ -23,24 +20,24 @@ pip install arcadedb-embedded \
 
 The package includes everything you need:
 
-- **ArcadeDB JARs** (167.4MB): Core database with all features
+- **ArcadeDB JARs** (226.0MB): Core database with all features
 - **Bundled JRE** (47-63MB): Platform-specific Java 21 runtime (via jlink)
 - **Python Package** (~5MB): Python wrapper and utilities
 
-**Total:** 155-161MB compressed wheel (varies by platform), ~215-230MB when installed
+**Total:** ~215MB compressed wheel (varies by platform), ~289MB when installed
 
 ## Platform Support
 
 Pre-built **platform-specific** wheels are available for **6 platforms**:
 
 | Platform | Wheel Size | JRE Size | Installed Size | Tests |
 |----------|-----------|----------|----------------|-------|
-| Windows ARM64 | 155.1M | 47.3M | ~215M | 205/205 ✅ |
-| macOS ARM64 (Apple Silicon) | 156.7M | 53.9M | ~221M | 205/205 ✅ |
-| macOS Intel (x86_64) | 157.8M | 55.3M | ~223M | 205/205 ✅ |
-| Windows x64 | 157.4M | 51.5M | ~219M | 205/205 ✅ |
-| Linux ARM64 | 159.9M | 61.8M | ~229M | 205/205 ✅ |
-| Linux x64 | 160.9M | 62.7M | ~230M | 205/205 ✅ |
+| Windows ARM64 | 209.4M | 47.6M | ~274M | 205/205 ✅ |
+| macOS ARM64 (Apple Silicon) | 210.8M | 53.9M | ~280M | 205/205 ✅ |
+| macOS Intel (x86_64) | 211.9M | 55.3M | ~281M | 205/205 ✅ |
+| Windows x64 | 211.6M | 51.6M | ~278M | 205/205 ✅ |
+| Linux ARM64 | 214.1M | 61.8M | ~288M | 205/205 ✅ |
+| Linux x64 | 215.0M | 62.7M | ~289M | 205/205 ✅ |
 
 **Key Features:**
 
diff --git a/bindings/python/docs/getting-started/installation.md b/bindings/python/docs/getting-started/installation.md
@@ -5,23 +5,9 @@
 The `arcadedb-embedded` package is **self-contained** with a bundled JRE - **no Java installation required!**
 
 ```bash
-# Temporarily install from GitHub Pages (awaiting PyPI size limit approval)
-pip install arcadedb-embedded \
-  --index-url https://humemai.github.io/arcadedb-embedded-python/simple/ \
-  --extra-index-url https://pypi.org/simple/
+pip install arcadedb-embedded
 ```
 
-!!! note "Temporary GitHub Pages Installation"
-    We're temporarily hosting wheels on GitHub Pages while awaiting PyPI size limit approval (our wheels are ~160MB, default limit is 100MB).
-
-    - `--index-url`: Primary index (GitHub Pages for arcadedb-embedded)
-    - `--extra-index-url`: Secondary index (PyPI for dependencies like JPype1)
-
-    Once PyPI approves our size limit request, installation will be simpler:
-    ```bash
-    pip install arcadedb-embedded
-    ```
-
 **Requirements:**
 
 - **Python 3.8+ only** - No Java installation required!
@@ -32,22 +18,22 @@ pip install arcadedb-embedded \
 
 ## What's Included
 
-The `arcadedb-embedded` package (~155-161MB wheel, ~215-230MB installed) includes everything you need:
+The `arcadedb-embedded` package (~215MB wheel, ~289MB installed) includes everything you need:
 
-- **ArcadeDB JARs**: 167.4MB (identical across all platforms)
+- **ArcadeDB JARs**: 226.0MB (identical across all platforms)
 - **Bundled JRE**: 47-63MB (platform-specific Java 21 runtime via jlink)
 - **Python Package**: ~5MB
 
 **Platform Details:**
 
 | Platform | Wheel Size | JRE Size | Installed Size |
 |----------|-----------|----------|----------------|
-| Windows ARM64 | 155.1M | 47.3M | ~215M |
-| macOS ARM64 | 156.7M | 53.9M | ~221M |
-| macOS Intel | 157.8M | 55.3M | ~223M |
-| Windows x64 | 157.4M | 51.5M | ~219M |
-| Linux ARM64 | 159.9M | 61.8M | ~229M |
-| Linux x64 | 160.9M | 62.7M | ~230M |
+| Windows ARM64 | ~215M | 47.3M | ~278M |
+| macOS ARM64 | ~215M | 53.9M | ~285M |
+| macOS Intel | ~215M | 55.3M | ~286M |
+| Windows x64 | ~215M | 51.5M | ~282M |
+| Linux ARM64 | ~215M | 61.8M | ~293M |
+| Linux x64 | ~215M | 62.7M | ~294M |
 
 **Features Included:**
 
diff --git a/bindings/python/docs/getting-started/quickstart.md b/bindings/python/docs/getting-started/quickstart.md
@@ -7,10 +7,7 @@ Get up and running with ArcadeDB Python bindings in 5 minutes!
 Install the self-contained package with bundled JRE:
 
 ```bash
-# Temporarily install from GitHub Pages (awaiting PyPI size limit approval)
-pip install arcadedb-embedded \
-  --index-url https://humemai.github.io/arcadedb-embedded-python/simple/ \
-  --extra-index-url https://pypi.org/simple/
+pip install arcadedb-embedded
 ```
 
 !!! note "No Java Installation Required"
diff --git a/bindings/python/docs/index.md b/bindings/python/docs/index.md
@@ -138,7 +138,7 @@ We provide a **single, self-contained package** that works on all major platform
 
 | Platform | Package Name | Size | What's Included |
 |----------|-------------|------|-----------------|
-| **All Platforms** | `arcadedb-embedded` | ~160MB | Full ArcadeDB + Bundled JRE + Studio UI + Gremlin |
+| **All Platforms** | `arcadedb-embedded` | ~215MB | Full ArcadeDB + Bundled JRE + Studio UI + Gremlin |
 
 All distributions use the same import:
 
@@ -179,8 +179,8 @@ import arcadedb_embedded as arcadedb
 
 !!! note "Self-Contained"
     Everything needed to run ArcadeDB is included in the wheel.
-    - **Bundled JRE**: Platform-specific Java 21 runtime (~50-60MB)
-    - **ArcadeDB JARs**: Core database engine (~160MB)
+    - **Bundled JRE**: Platform-specific Java 21 runtime (~63MB)
+    - **ArcadeDB JARs**: Core database engine (~226MB)
     - **JPype**: Bridge between Python and the bundled JVM
 
 ## Community & Support
