Add portable distribution build system
Zero-install Windows distribution: - Embeddable Python 3.12 (no installer needed) - SQLite default (already in codebase) - Pre-built frontend bundled - Cross-downloads Windows wheels on Linux build host - start.bat launcher: extract, double-click, done - 22MB zip / 61MB extracted - No Docker, no Python install, no admin rights - Data stays in the portable folder (USB-stick friendly)
This commit is contained in:
parent
9ab9135ca2
commit
60e7eadb1e
5 changed files with 359 additions and 0 deletions
4
.gitignore
vendored
4
.gitignore
vendored
|
|
@ -29,3 +29,7 @@ Thumbs.db
|
||||||
|
|
||||||
# Content (scraped recipes — not for distribution)
|
# Content (scraped recipes — not for distribution)
|
||||||
content/
|
content/
|
||||||
|
|
||||||
|
# Portable build artifacts
|
||||||
|
portable/build/
|
||||||
|
portable/dist/
|
||||||
|
|
|
||||||
82
portable/README.txt
Normal file
82
portable/README.txt
Normal file
|
|
@ -0,0 +1,82 @@
|
||||||
|
|
||||||
|
DILIGENCE
|
||||||
|
Self-hosted fitness rewards platform
|
||||||
|
=====================================
|
||||||
|
|
||||||
|
QUICK START (Windows)
|
||||||
|
---------------------
|
||||||
|
1. Extract this entire folder to your Desktop or Documents
|
||||||
|
2. Double-click start.bat
|
||||||
|
3. Your browser opens to http://localhost:8000
|
||||||
|
4. Create your account on first visit
|
||||||
|
|
||||||
|
That's it. No installation needed.
|
||||||
|
|
||||||
|
|
||||||
|
YOUR DATA
|
||||||
|
---------
|
||||||
|
Everything is stored in the "data" folder right here:
|
||||||
|
- data/data.db — your database (workouts, points, rewards)
|
||||||
|
- data/.env — your configuration (auto-generated)
|
||||||
|
|
||||||
|
Your data never leaves your computer.
|
||||||
|
To back up, just copy the "data" folder somewhere safe.
|
||||||
|
To move to another computer, copy this entire Diligence folder.
|
||||||
|
|
||||||
|
|
||||||
|
STOPPING
|
||||||
|
--------
|
||||||
|
Press Ctrl+C in the black command window, or just close it.
|
||||||
|
|
||||||
|
|
||||||
|
AI AGENT CONNECTION (Optional)
|
||||||
|
------------------------------
|
||||||
|
Diligence includes an MCP connector for AI agents like Claude Desktop.
|
||||||
|
After starting, the MCP endpoint is at:
|
||||||
|
URL: http://localhost:3001/sse
|
||||||
|
Token: (see data/.env, the API_TOKEN line)
|
||||||
|
|
||||||
|
Claude Desktop config (claude_desktop_config.json):
|
||||||
|
{
|
||||||
|
"mcpServers": {
|
||||||
|
"diligence": {
|
||||||
|
"url": "http://localhost:3001/sse",
|
||||||
|
"headers": {
|
||||||
|
"Authorization": "Bearer YOUR_API_TOKEN_HERE"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
SYSTEM REQUIREMENTS
|
||||||
|
-------------------
|
||||||
|
- Windows 10 or later (64-bit)
|
||||||
|
- 150 MB disk space
|
||||||
|
- 300 MB free RAM
|
||||||
|
- Any web browser (Edge, Chrome, Firefox)
|
||||||
|
- No admin rights needed
|
||||||
|
- No internet needed (except for Strava/Polar sync)
|
||||||
|
|
||||||
|
|
||||||
|
TROUBLESHOOTING
|
||||||
|
---------------
|
||||||
|
"Windows protected your PC" (SmartScreen):
|
||||||
|
Click "More info" then "Run anyway". This appears because the
|
||||||
|
app is not digitally signed, not because it is harmful.
|
||||||
|
|
||||||
|
"Port already in use":
|
||||||
|
Another program is using port 8000. Close it, or run:
|
||||||
|
start.bat --port 9000
|
||||||
|
|
||||||
|
The window closes immediately:
|
||||||
|
Open a Command Prompt, navigate to this folder, and type:
|
||||||
|
start.bat
|
||||||
|
to see the error message.
|
||||||
|
|
||||||
|
|
||||||
|
LICENSE
|
||||||
|
-------
|
||||||
|
MIT License — DiligenceWorks Pte. Ltd.
|
||||||
|
https://github.com/DiligenceWorks/Diligence
|
||||||
|
|
||||||
201
portable/build.sh
Executable file
201
portable/build.sh
Executable file
|
|
@ -0,0 +1,201 @@
|
||||||
|
#!/bin/bash
|
||||||
|
# =============================================================================
|
||||||
|
# Diligence Portable Build Script
|
||||||
|
# Assembles a zero-install portable distribution for Windows 10 x64
|
||||||
|
#
|
||||||
|
# Run this on a Linux build host (subo). It downloads the Windows embeddable
|
||||||
|
# Python, cross-downloads Windows wheels, and packages everything into a zip
|
||||||
|
# that the end user extracts and double-clicks start.bat.
|
||||||
|
#
|
||||||
|
# Usage: ./build.sh [PYTHON_VERSION]
|
||||||
|
# Output: dist/Diligence-portable-win64.zip
|
||||||
|
# =============================================================================
|
||||||
|
set -euo pipefail
|
||||||
|
|
||||||
|
# --- Configuration -----------------------------------------------------------
|
||||||
|
PYTHON_VERSION="${1:-3.12.10}"
|
||||||
|
PYTHON_MAJOR_MINOR=$(echo "$PYTHON_VERSION" | cut -d. -f1,2)
|
||||||
|
PYTHON_TAG=$(echo "$PYTHON_MAJOR_MINOR" | tr -d '.')
|
||||||
|
|
||||||
|
APP_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
|
||||||
|
BUILD_DIR="$APP_ROOT/portable/build"
|
||||||
|
DIST_DIR="$APP_ROOT/portable/dist"
|
||||||
|
STAGE="$BUILD_DIR/Diligence"
|
||||||
|
WHEELS_DIR="$BUILD_DIR/wheels"
|
||||||
|
|
||||||
|
PYTHON_EMBED_URL="https://www.python.org/ftp/python/${PYTHON_VERSION}/python-${PYTHON_VERSION}-embed-amd64.zip"
|
||||||
|
|
||||||
|
OUTPUT_ZIP="$DIST_DIR/Diligence-portable-win64.zip"
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo " Diligence Portable Build"
|
||||||
|
echo " Python: ${PYTHON_VERSION} (embed amd64)"
|
||||||
|
echo " App root: ${APP_ROOT}"
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
# --- Clean -------------------------------------------------------------------
|
||||||
|
rm -rf "$BUILD_DIR" "$DIST_DIR"
|
||||||
|
mkdir -p "$STAGE" "$WHEELS_DIR" "$DIST_DIR"
|
||||||
|
|
||||||
|
# --- Step 1: Download embeddable Python --------------------------------------
|
||||||
|
echo " [1/6] Downloading embeddable Python ${PYTHON_VERSION}..."
|
||||||
|
curl -sL -o "$BUILD_DIR/python-embed.zip" "$PYTHON_EMBED_URL"
|
||||||
|
mkdir -p "$STAGE/python"
|
||||||
|
unzip -q "$BUILD_DIR/python-embed.zip" -d "$STAGE/python"
|
||||||
|
rm "$BUILD_DIR/python-embed.zip"
|
||||||
|
|
||||||
|
# --- Step 2: Configure Python import paths -----------------------------------
|
||||||
|
echo " [2/6] Configuring Python import paths..."
|
||||||
|
|
||||||
|
# The ._pth file controls sys.path for the embeddable Python.
|
||||||
|
# Paths are relative to the python/ directory.
|
||||||
|
cat > "$STAGE/python/python${PYTHON_TAG}._pth" << EOF
|
||||||
|
python${PYTHON_TAG}.zip
|
||||||
|
.
|
||||||
|
..
|
||||||
|
../lib
|
||||||
|
import site
|
||||||
|
EOF
|
||||||
|
|
||||||
|
# --- Step 3: Download Windows wheels -----------------------------------------
|
||||||
|
echo " [3/6] Downloading Windows wheels..."
|
||||||
|
|
||||||
|
# We download binary wheels for Windows from PyPI using the Linux pip.
|
||||||
|
# --platform win_amd64 fetches Windows-specific binaries.
|
||||||
|
# --no-deps because we manage the dependency list explicitly to avoid
|
||||||
|
# pulling in unnecessary transitive deps.
|
||||||
|
|
||||||
|
# Core dependencies (from pyproject.toml)
|
||||||
|
CORE_DEPS=(
|
||||||
|
"fastapi>=0.115.0"
|
||||||
|
"uvicorn>=0.30.0"
|
||||||
|
"sqlalchemy>=2.0.30"
|
||||||
|
"aiosqlite>=0.20.0"
|
||||||
|
"pydantic>=2.10.0"
|
||||||
|
"pydantic-settings>=2.7.0"
|
||||||
|
"pydantic-core"
|
||||||
|
"python-jose>=3.3.0"
|
||||||
|
"cryptography"
|
||||||
|
"bcrypt>=4.2.0"
|
||||||
|
"httpx>=0.27.0"
|
||||||
|
"python-multipart>=0.0.18"
|
||||||
|
"tzdata>=2024.1"
|
||||||
|
)
|
||||||
|
|
||||||
|
# Transitive dependencies (required by core deps)
|
||||||
|
TRANSITIVE_DEPS=(
|
||||||
|
"annotated-types"
|
||||||
|
"typing-extensions"
|
||||||
|
"anyio"
|
||||||
|
"sniffio"
|
||||||
|
"idna"
|
||||||
|
"certifi"
|
||||||
|
"httpcore"
|
||||||
|
"h11"
|
||||||
|
"starlette"
|
||||||
|
"click"
|
||||||
|
"jinja2"
|
||||||
|
"markupsafe"
|
||||||
|
"ecdsa"
|
||||||
|
"rsa"
|
||||||
|
"pyasn1"
|
||||||
|
"cffi"
|
||||||
|
"pycparser"
|
||||||
|
"greenlet"
|
||||||
|
"python-dotenv"
|
||||||
|
)
|
||||||
|
|
||||||
|
download_wheel() {
|
||||||
|
local pkg="$1"
|
||||||
|
# Try platform-specific binary first
|
||||||
|
pip download \
|
||||||
|
--platform win_amd64 \
|
||||||
|
--python-version "$PYTHON_MAJOR_MINOR" \
|
||||||
|
--only-binary :all: \
|
||||||
|
--dest "$WHEELS_DIR" \
|
||||||
|
--no-deps \
|
||||||
|
"$pkg" 2>/dev/null && return 0
|
||||||
|
|
||||||
|
# Fall back to pure-python wheel (no platform restriction needed)
|
||||||
|
pip download \
|
||||||
|
--python-version "$PYTHON_MAJOR_MINOR" \
|
||||||
|
--dest "$WHEELS_DIR" \
|
||||||
|
--no-deps \
|
||||||
|
"$pkg" 2>/dev/null && return 0
|
||||||
|
|
||||||
|
echo " WARNING: Could not download $pkg"
|
||||||
|
return 1
|
||||||
|
}
|
||||||
|
|
||||||
|
for pkg in "${CORE_DEPS[@]}" "${TRANSITIVE_DEPS[@]}"; do
|
||||||
|
download_wheel "$pkg" || true
|
||||||
|
done
|
||||||
|
|
||||||
|
# MCP connector (optional — included if available)
|
||||||
|
download_wheel "fastmcp>=3.0.0" || echo " (fastmcp unavailable — MCP will be optional)"
|
||||||
|
|
||||||
|
# --- Step 4: Extract wheels into lib/ ----------------------------------------
|
||||||
|
echo " [4/6] Extracting wheels into lib/..."
|
||||||
|
mkdir -p "$STAGE/lib"
|
||||||
|
for whl in "$WHEELS_DIR"/*.whl; do
|
||||||
|
[ -f "$whl" ] || continue
|
||||||
|
unzip -qo "$whl" -d "$STAGE/lib"
|
||||||
|
done
|
||||||
|
|
||||||
|
# Clean .dist-info (saves space, not needed at runtime)
|
||||||
|
find "$STAGE/lib" -type d -name "*.dist-info" -exec rm -rf {} + 2>/dev/null || true
|
||||||
|
# Remove any .tar.gz source dists that snuck in
|
||||||
|
rm -f "$WHEELS_DIR"/*.tar.gz 2>/dev/null || true
|
||||||
|
|
||||||
|
# --- Step 5: Copy application code ------------------------------------------
|
||||||
|
echo " [5/6] Copying application code..."
|
||||||
|
|
||||||
|
# Copy the diligence package (includes pre-built frontend at diligence/frontend/)
|
||||||
|
cp -r "$APP_ROOT/diligence" "$STAGE/diligence"
|
||||||
|
|
||||||
|
# Remove __pycache__
|
||||||
|
find "$STAGE/diligence" -type d -name "__pycache__" -exec rm -rf {} + 2>/dev/null || true
|
||||||
|
|
||||||
|
# Copy supporting files
|
||||||
|
cp "$APP_ROOT/LICENSE" "$STAGE/"
|
||||||
|
|
||||||
|
# Create data directory placeholder
|
||||||
|
mkdir -p "$STAGE/data"
|
||||||
|
|
||||||
|
# Copy launchers and README from portable/
|
||||||
|
cp "$APP_ROOT/portable/start.bat" "$STAGE/"
|
||||||
|
cp "$APP_ROOT/portable/start.sh" "$STAGE/"
|
||||||
|
cp "$APP_ROOT/portable/README.txt" "$STAGE/"
|
||||||
|
|
||||||
|
# --- Step 6: Package --------------------------------------------------------
|
||||||
|
echo " [6/6] Creating zip..."
|
||||||
|
|
||||||
|
# Use system zip if available, otherwise use Docker Alpine
|
||||||
|
if command -v zip &>/dev/null; then
|
||||||
|
cd "$BUILD_DIR"
|
||||||
|
zip -qr "$OUTPUT_ZIP" Diligence/
|
||||||
|
cd "$APP_ROOT"
|
||||||
|
else
|
||||||
|
echo " (zip not installed — using Docker Alpine)"
|
||||||
|
sg docker -c "docker run --rm \
|
||||||
|
-v '$BUILD_DIR':/build \
|
||||||
|
-v '$DIST_DIR':/dist \
|
||||||
|
-w /build \
|
||||||
|
alpine sh -c 'apk add --no-cache -q zip && zip -qr /dist/Diligence-portable-win64.zip Diligence/'"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# --- Report ------------------------------------------------------------------
|
||||||
|
ZIP_SIZE=$(du -sh "$OUTPUT_ZIP" | cut -f1)
|
||||||
|
STAGE_SIZE=$(du -sh "$STAGE" | cut -f1)
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo " Build complete:"
|
||||||
|
echo " Zip: $OUTPUT_ZIP ($ZIP_SIZE)"
|
||||||
|
echo " Extracted size: $STAGE_SIZE"
|
||||||
|
echo " Python: $PYTHON_VERSION (embed amd64)"
|
||||||
|
echo ""
|
||||||
|
echo " Test on Windows:"
|
||||||
|
echo " 1. Extract zip to any folder"
|
||||||
|
echo " 2. Double-click start.bat"
|
||||||
|
echo " 3. Browser opens to http://localhost:8000"
|
||||||
|
echo ""
|
||||||
36
portable/start.bat
Normal file
36
portable/start.bat
Normal file
|
|
@ -0,0 +1,36 @@
|
||||||
|
@echo off
|
||||||
|
:: ============================================================================
|
||||||
|
:: Diligence — Self-hosted fitness rewards platform
|
||||||
|
:: Double-click this file to start. Your browser will open automatically.
|
||||||
|
:: Press Ctrl+C in this window to stop.
|
||||||
|
:: ============================================================================
|
||||||
|
title Diligence
|
||||||
|
|
||||||
|
:: Get the directory this script lives in
|
||||||
|
set "APP_DIR=%~dp0"
|
||||||
|
|
||||||
|
:: Data lives alongside the app (portable — no files outside this folder)
|
||||||
|
set "DATA_DIR=%APP_DIR%data"
|
||||||
|
|
||||||
|
:: Tell Python where to find the app and its dependencies
|
||||||
|
:: (The ._pth file handles most of this, but DATA_DIR needs an env var)
|
||||||
|
set "DATA_DIR=%DATA_DIR%"
|
||||||
|
|
||||||
|
echo.
|
||||||
|
echo Diligence
|
||||||
|
echo =========
|
||||||
|
echo.
|
||||||
|
echo Starting up... (this may take 10-30 seconds on first run)
|
||||||
|
echo Your browser will open automatically.
|
||||||
|
echo.
|
||||||
|
echo Data folder: %DATA_DIR%
|
||||||
|
echo Press Ctrl+C to stop.
|
||||||
|
echo.
|
||||||
|
|
||||||
|
:: Run the app using the bundled Python
|
||||||
|
"%APP_DIR%python\python.exe" -m diligence --data-dir "%DATA_DIR%" %*
|
||||||
|
|
||||||
|
:: If we get here, the app exited
|
||||||
|
echo.
|
||||||
|
echo Diligence has stopped.
|
||||||
|
pause
|
||||||
36
portable/start.sh
Executable file
36
portable/start.sh
Executable file
|
|
@ -0,0 +1,36 @@
|
||||||
|
#!/bin/bash
|
||||||
|
# ============================================================================
|
||||||
|
# Diligence — Self-hosted fitness rewards platform (Mac/Linux)
|
||||||
|
#
|
||||||
|
# This launcher is for systems that already have Python 3.11+ installed.
|
||||||
|
# It uses the bundled dependencies from lib/ but your system Python.
|
||||||
|
#
|
||||||
|
# Usage: ./start.sh
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
APP_DIR="$(cd "$(dirname "$0")" && pwd)"
|
||||||
|
DATA_DIR="$APP_DIR/data"
|
||||||
|
|
||||||
|
export PYTHONPATH="$APP_DIR/lib:$APP_DIR:$PYTHONPATH"
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo " Diligence"
|
||||||
|
echo " ========="
|
||||||
|
echo ""
|
||||||
|
echo " Starting up..."
|
||||||
|
echo " Data folder: $DATA_DIR"
|
||||||
|
echo " Press Ctrl+C to stop."
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
# Try bundled python first, then system python3
|
||||||
|
if [ -x "$APP_DIR/python/python3" ]; then
|
||||||
|
"$APP_DIR/python/python3" -m diligence --data-dir "$DATA_DIR" "$@"
|
||||||
|
elif command -v python3 &>/dev/null; then
|
||||||
|
python3 -m diligence --data-dir "$DATA_DIR" "$@"
|
||||||
|
else
|
||||||
|
echo " ERROR: Python 3 not found."
|
||||||
|
echo " Install Python 3.11+ or use the pip install path:"
|
||||||
|
echo " pip install diligence"
|
||||||
|
echo " diligence"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
Loading…
Add table
Add a link
Reference in a new issue