Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
# three.ws Forge release build: Linux (.AppImage, .deb) and Windows (NSIS
# installer) on Cloud Build, published to the release bucket that the three.ws
# load balancer serves at https://three.ws/releases/forge/. macOS builds on a
# Mac (apps/forge-desktop/scripts/release-mac.sh) and merges into the same
# release.json. Runbook: docs/ops/forge-desktop-release.md.
#
# Submit from the repo root. Publishing is owner-gated: the default
# (_PUBLISH=0) builds, writes release.json and stages everything under
# staging/forge/<version>/<build id>/ without touching the live feed.
#
# gcloud builds submit --config apps/forge-desktop/cloudbuild.yaml \
# --ignore-file apps/forge-desktop/.gcloudignore \
# --region us-central1 --project aerial-vehicle-466722-p5 \
# --substitutions _PUBLISH=1
#
# Windows signing reuses three.ws Desktop's secrets (desktop-windows-csc-link,
# desktop-windows-csc-password): both apps ship under the three.ws publisher.
steps:
- id: prepare
name: gcr.io/google.com/cloudsdktool/cloud-sdk:slim
entrypoint: bash
args:
- -c
- |
set -euo pipefail
mkdir -p /workspace/.release
if gcloud secrets versions access latest --secret=desktop-windows-csc-link --project=$PROJECT_ID > /workspace/.release/win.pfx.b64 2>/dev/null \
&& gcloud secrets versions access latest --secret=desktop-windows-csc-password --project=$PROJECT_ID > /workspace/.release/win.pass 2>/dev/null; then
echo 1 > /workspace/.release/win.signed
echo "Windows certificate found: the installer will be signed."
else
rm -f /workspace/.release/win.pfx.b64 /workspace/.release/win.pass
echo 0 > /workspace/.release/win.signed
echo "No Windows certificate in Secret Manager: building unsigned."
fi
if ! gcloud storage cp gs://${_BUCKET}/releases/forge/release.json /workspace/.release/published.json 2>/dev/null; then
echo '{}' > /workspace/.release/published.json
echo "No published release.json yet: this is the first Forge release."
fi
- id: install
name: electronuserland/builder:20-wine
dir: apps/forge-desktop
entrypoint: bash
args: ['-c', 'npm ci --no-audit --no-fund && node node_modules/electron/install.js']
- id: build
name: electronuserland/builder:20-wine
dir: apps/forge-desktop
entrypoint: bash
args: ['-c', 'npm run build']
- id: linux
name: electronuserland/builder:20-wine
dir: apps/forge-desktop
entrypoint: bash
args:
- -c
- |
set -euo pipefail
node scripts/download-python-embed.js --platform linux --arch x64
npx electron-builder --config electron-builder.config.cjs --linux --publish never
- id: windows
name: electronuserland/builder:20-wine
dir: apps/forge-desktop
entrypoint: bash
args:
- -c
- |
set -euo pipefail
node scripts/download-python-embed.js --platform win32 --arch x64
if [ "$$(cat /workspace/.release/win.signed)" = "1" ]; then
export CSC_LINK="$$(cat /workspace/.release/win.pfx.b64)"
export CSC_KEY_PASSWORD="$$(cat /workspace/.release/win.pass)"
else
export CSC_IDENTITY_AUTO_DISCOVERY=false
fi
npx electron-builder --config electron-builder.config.cjs --win --publish never
- id: manifest
name: electronuserland/builder:20-wine
dir: apps/forge-desktop
entrypoint: bash
args:
- -c
- |
set -euo pipefail
rm -f /workspace/.release/win.pfx.b64 /workspace/.release/win.pass
THREE_WS_SIGNED_WIN="$$(cat /workspace/.release/win.signed)" \
node scripts/release-manifest.mjs --merge /workspace/.release/published.json
node -e "process.stdout.write(require('./package.json').version)" > /workspace/.release/version
- id: publish
name: gcr.io/google.com/cloudsdktool/cloud-sdk:slim
dir: apps/forge-desktop/dist
entrypoint: bash
args:
- -c
- |
set -euo pipefail
shopt -s nullglob
VERSION="$$(cat /workspace/.release/version)"
BINARIES=(*.AppImage *.deb *.exe *.blockmap)
FEED_FILES=(latest*.yml release.json)
STAGE="gs://${_BUCKET}/staging/forge/$${VERSION}/$BUILD_ID"
gcloud storage cp "$${BINARIES[@]}" "$${FEED_FILES[@]}" "$$STAGE/"
echo "Staged $${#BINARIES[@]} binaries for Forge $$VERSION at $$STAGE/"
if [ "${_PUBLISH}" != "1" ]; then
echo "Dry run (_PUBLISH=${_PUBLISH}): the live feed is unchanged. Publish with --substitutions _PUBLISH=1."
exit 0
fi
LIVE="gs://${_BUCKET}/releases/forge"
# Binaries first, versioned names, cached forever; the feed files that
# point at them last, never cached, so no client sees a feed entry
# before its file exists.
gcloud storage cp "$${BINARIES[@]}" "$$LIVE/" --cache-control="public, max-age=31536000, immutable"
gcloud storage cp release.json "$$LIVE/versions/$${VERSION}.json" --cache-control="public, max-age=300"
gcloud storage cp "$${FEED_FILES[@]}" "$$LIVE/" --cache-control="no-cache, max-age=0"
echo "Published three.ws Forge $$VERSION to https://three.ws/releases/forge/"
substitutions:
_BUCKET: three-ws-desktop-releases
_PUBLISH: '0'
serviceAccount: projects/aerial-vehicle-466722-p5/serviceAccounts/[email protected]
timeout: 5400s
options:
machineType: E2_HIGHCPU_8
logging: CLOUD_LOGGING_ONLY
diskSizeGb: 150
tags: ['three-ws-forge-release']