fix: update package sizes and JRE details in documentation for consistency across platforms

Author: tae898

bindings/python/README.md

@@ -59,11 +59,11 @@ with arcadedb.create_database("./mydb") as db:
 
 ## ✨ Features
 
-- ☕ **No Java Installation Required**: Bundled JRE (~249MB uncompressed)
+- ☕ **No Java Installation Required**: Bundled JRE (~60MB uncompressed)
 - 🌍 **4 Platforms Supported**: Linux (x86_64, ARM64), macOS (ARM64), Windows (x86_64)
 - 🚀 **Embedded Mode**: Direct database access in Python process (no network)
 - 🌐 **Server Mode**: Optional HTTP server with Studio web interface
-- 📦 **Self-contained**: All dependencies bundled (~116MB wheel)
+- 📦 **Self-contained**: All dependencies bundled (~68MB wheel)
 - 🔄 **Multi-model**: Graph, Document, Key/Value, Vector, Time Series
 - 🔍 **Multiple query languages**: SQL, OpenCypher, MongoDB
 - ⚡ **High performance**: Direct JVM integration via JPype
@@ -79,10 +79,10 @@ The `arcadedb-embedded` package is platform-specific and self-contained:
 
 **Package Contents (all platforms):**
 
-- **Wheel size (compressed)**: ~116MB
+- **Wheel size (compressed)**: ~68MB
 - **ArcadeDB JARs (uncompressed)**: ~32MB
-- **Bundled JRE (uncompressed)**: ~249MB (platform-specific Java 25 runtime via jlink)
-- **Total uncompressed size**: ~281MB
+- **Bundled JRE (uncompressed)**: ~60MB (platform-specific Java 25 runtime via jlink)
+- **Total uncompressed size**: ~95MB
 
 **Note**: Some JARs are excluded to optimize package size (e.g., gRPC wire protocol). See [`jar_exclusions.txt`](https://github.com/humemai/arcadedb-embedded-python/blob/main/bindings/python/jar_exclusions.txt) for details.
 

bindings/python/docs/development/build-architecture.md

@@ -6,16 +6,16 @@ This document describes the build architecture for creating platform-specific Py
 
 **Goal:** Distribute a single `arcadedb-embedded` package that works on 4 platforms with **zero Java installation required**.
 
-**Achievement:** 4 platform-specific wheels (~63–115MB compressed) with bundled platform-specific JRE, built and tested on GitHub Actions using native runners.
+**Achievement:** 4 platform-specific wheels (~68MB compressed) 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** | 115.2M | 249.0M | `ubuntu-24.04` | Docker native | Most common Linux platform |
-| **linux/arm64** | 114.1M | 249.6M | `ubuntu-24.04-arm` | Docker native | ARM64 servers, Raspberry Pi |
-| **darwin/arm64** | 63.1M | 55.1M | `macos-15` | Native build | Apple Silicon Macs (2020+) |
-| **windows/amd64** | ~115M | ~249M | `windows-2025` | Native build | Windows x86_64 |
+| **linux/amd64** | ~68M | ~60M | `ubuntu-24.04` | Docker native | Most common Linux platform |
+| **linux/arm64** | ~68M | ~60M | `ubuntu-24.04-arm` | Docker native | ARM64 servers, Raspberry Pi |
+| **darwin/arm64** | ~68M | ~60M | `macos-15` | Native build | Apple Silicon Macs (2020+) |
+| **windows/amd64** | ~68M | ~60M | `windows-2025` | Native build | Windows x86_64 |
 
 **All supported platforms:**
 
@@ -381,33 +381,14 @@ bindings/python/
 
 **Solution:** Switch to JUnit XML (structured data, no regex).
 
-## Size Breakdown (current, as of 26-Jan-2026)
+## Size Breakdown (current, as of 29-Jan-2026)
 
-**linux/amd64**
+Sizes are now consistent across platforms (ballpark):
 
-- Wheel: 115.2M (compressed)
-- JRE: 249.0M (uncompressed)
-- JARs: 31.7M (uncompressed)
-- Installed: ~281M (uncompressed)
-
-**linux/arm64**
-
-- Wheel: 114.1M (compressed)
-- JRE: 249.6M (uncompressed)
-- JARs: 31.7M (uncompressed)
-- Installed: ~281M (uncompressed)
-
-**darwin/arm64**
-
-- Wheel: 63.1M (compressed)
-- JRE: 55.1M (uncompressed)
-- JARs: 31.7M (uncompressed)
-- Installed: ~87M (uncompressed)
-
-### Why Sizes Vary by Platform
-
-- JRE binaries differ by platform (different native code and compression).
-- Linux wheels include larger JRE footprints than macOS arm64.
+- Wheel: ~68M (compressed)
+- JRE: ~60M (uncompressed)
+- JARs: ~32M (uncompressed)
+- Installed: ~95M (uncompressed)
 
 ## Development
 

bindings/python/docs/development/ci-setup.md

@@ -8,7 +8,7 @@ The CI/CD workflows now support building and releasing across **4 platforms** fo
 
 ### Single-Package Strategy
 
-- **arcadedb-embedded**: All platforms (~63–115MB compressed) - JRE bundled, no external Java needed
+- **arcadedb-embedded**: All platforms (~68MB compressed) - JRE bundled, no external Java needed
 
 ### Platforms (All Native Runners)
 
@@ -100,17 +100,14 @@ After a successful release, you should see:
 
 All 4 platforms passing 258 tests and example scripts:
 
-| Platform | Wheel Size | JRE Size | Tests |
-|----------|-----------|----------|-------|
-| linux/amd64 | 115.2M | 249.0M | 258 passed ✅ |
-| linux/arm64 | 114.1M | 249.6M | 258 passed ✅ |
-| darwin/arm64 | 63.1M | 55.1M | 258 passed ✅ |
-| windows/amd64 | ~115M | ~249M | 258 passed ✅ |
+| Platforms | Wheel Size | JRE Size | Tests |
+|-----------|-----------|----------|-------|
+| linux/amd64, linux/arm64, darwin/arm64, windows/amd64 | ~68M | ~60M | 258 passed ✅ |
 
 **All platforms include:**
 
-- 31.7M JARs (83 files, identical across platforms, gRPC excluded)
-- Platform-specific JRE (55.1–249.6M uncompressed, depending on platform)
+- 32.4M JARs (83 files, identical across platforms, gRPC excluded)
+- Platform-specific JRE (~60M uncompressed, similar across platforms)
 - Native runners (no QEMU emulation anywhere)
 
 ## Cross-Platform Building

bindings/python/docs/getting-started/distributions.md

@@ -6,7 +6,7 @@ ArcadeDB Python provides a **self-contained embedded** package that runs the dat
 
 | Package | Wheel Size | Installed Size (uncompressed) | Java Required | Studio UI | Query Languages |
 |---------|-----------|------------------------------|---------------|-----------|----------------|
-| **arcadedb-embedded** | ~63–115MB | ~87–281MB | ❌ No | ✅ | SQL, OpenCypher, MongoDB |
+| **arcadedb-embedded** | ~68MB | ~95MB | ❌ No | ✅ | SQL, OpenCypher, MongoDB |
 
 **Installation:**
 
@@ -21,13 +21,13 @@ uv pip install arcadedb-embedded
 The package includes everything you need:
 
 - **ArcadeDB JARs** (~32MB, uncompressed): Core database with all features
-- **Bundled JRE** (~249MB, uncompressed): Platform-specific Java 25 runtime (via jlink)
+- **Bundled JRE** (~60MB, uncompressed): Platform-specific Java 25 runtime (via jlink)
 
-**Total:** ~63–115MB compressed wheel, ~87–281MB uncompressed installed size (platform-dependent)
+**Total:** ~68MB compressed wheel, ~95MB uncompressed installed size (similar across platforms)
 
 ## Platform Support
 
-Pre-built **platform-specific** wheels are available for **4 platforms**. Sizes vary slightly by platform, but the ballpark totals are consistent (see size breakdown below).
+Pre-built **platform-specific** wheels are available for **4 platforms**. Sizes are consistent across platforms (see size breakdown below).
 
 **Key Features:**
 
@@ -41,7 +41,7 @@ Pre-built **platform-specific** wheels are available for **4 platforms**. Sizes
 
 **Core Features:**
 
-- ✅ **No Java Installation Required**: Platform-specific JRE bundled (~249MB uncompressed)
+- ✅ **No Java Installation Required**: Platform-specific JRE bundled (~60MB uncompressed)
 - ✅ **Core Database**: All models (Graph, Document, Key/Value, Vector, Time Series)
 - ✅ **Query Languages**: SQL, OpenCypher, MongoDB (all included)
 - ✅ **Studio Web UI**: Visual database explorer and query editor
@@ -107,17 +107,15 @@ Simple and consistent across all platforms!
 
 ## Size Breakdown
 
-Platform-specific sizes (current):
+Current sizes are consistent across platforms (ballpark):
 
-- **linux/amd64**: 115.2MB wheel, ~281MB installed
-- **linux/arm64**: 114.1MB wheel, ~281MB installed
-- **darwin/arm64**: 63.1MB wheel, ~87MB installed
-- **windows/amd64**: ~115MB wheel, ~281MB installed (sizes may vary)
+- **Wheel (compressed)**: ~68MB
+- **Installed (uncompressed)**: ~95MB
 
 **Components (uncompressed):**
 
 - **ArcadeDB JARs**: ~31.7MB
-- **Bundled JRE**: ~55–250MB (platform-dependent)
+- **Bundled JRE**: ~60MB (platform-specific Java 25 runtime via jlink)
 
 **Optimizations:**
 

bindings/python/docs/getting-started/installation.md

@@ -18,10 +18,10 @@ uv pip install arcadedb-embedded
 
 ## What's Included
 
-The `arcadedb-embedded` package (~63–115MB wheel, ~87–281MB uncompressed installed, platform-dependent) includes everything you need:
+The `arcadedb-embedded` package (~68MB wheel, ~95MB uncompressed installed, similar across platforms) includes everything you need:
 
 - **ArcadeDB JARs**: ~31.7MB (uncompressed)
-- **Bundled JRE**: ~55–250MB (uncompressed, platform-specific Java 25 runtime via jlink)
+- **Bundled JRE**: ~60MB (uncompressed, platform-specific Java 25 runtime via jlink)
 
 **Features Included:**
 

bindings/python/docs/index.md

@@ -161,12 +161,9 @@ See [Java API Coverage](java-api-coverage.md) for detailed comparison.
 
 We provide a **single, self-contained package** that works on all major platforms:
 
-| Platform | Package Name | Size | What's Included |
+| Platforms | Package Name | Size | What's Included |
 |----------|-------------|------|-----------------|
-| **linux/amd64** | `arcadedb-embedded` | ~115MB | Full ArcadeDB + Bundled JRE + Studio UI |
-| **linux/arm64** | `arcadedb-embedded` | ~114MB | Full ArcadeDB + Bundled JRE + Studio UI |
-| **darwin/arm64** | `arcadedb-embedded` | ~63MB | Full ArcadeDB + Bundled JRE + Studio UI |
-| **windows/amd64** | `arcadedb-embedded` | ~115MB | Full ArcadeDB + Bundled JRE + Studio UI |
+| linux/amd64, linux/arm64, darwin/arm64, windows/amd64 | `arcadedb-embedded` | ~68MB | Full ArcadeDB + Bundled JRE + Studio UI |
 
 The package uses the standard import:
 
@@ -206,10 +203,10 @@ import arcadedb_embedded as arcadedb
 - **OS**: Linux (x86_64, ARM64), macOS (Apple Silicon), or Windows (x86_64)
 
 !!! note "Self-Contained"
-    Everything needed to run ArcadeDB is included in the wheel (~63–115MB):
+    Everything needed to run ArcadeDB is included in the wheel (~68MB):
 
     - **Bundled JRE**
-    (Platform-specific Java 25 runtime trimmed with jlink to only what's required for ArcadeDB, ~249MB uncompressed)
+    (Platform-specific Java 25 runtime trimmed with jlink to only what's required for ArcadeDB, ~60MB uncompressed)
     - **ArcadeDB JARs**
     (~32MB uncompressed)
     - **JPype** (Bridge between Python and the bundled JVM)