Skip to content

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.

4.3 KB
Raw Blame
// electron-builder configuration for three.ws Forge.
//
// Targets: macOS arm64 .dmg and .zip, Windows NSIS installer, Linux .AppImage
// and .deb. Each build bundles a standalone CPython (resources/python-embed,
// fetched by scripts/download-python-embed.js for the target platform) that
// creates the local generation backend's virtualenv on first launch.
//
// Artifacts land in dist/ with the names apps/desktop/scripts/release-manifest.mjs
// classifies, and are published to the release bucket behind the three.ws CDN
// (https://three.ws/releases/forge/) by apps/forge-desktop/cloudbuild.yaml
// (Linux and Windows) and scripts/release-mac.sh (macOS). The runbook is
// docs/ops/forge-desktop-release.md.
//
// Signing follows three.ws Desktop: the Windows certificate and the Apple
// Developer ID come from Secret Manager when present. Without them the build is
// complete and installable, ad-hoc signed on macOS (scripts/after-pack.js) and
// unsigned on Windows.

const FEED_URL = process.env.THREE_WS_RELEASE_FEED || 'https://three.ws/releases/forge';

const macSigned = Boolean(process.env.CSC_LINK || process.env.CSC_NAME);
const macNotarize = macSigned && Boolean(process.env.APPLE_API_KEY && process.env.APPLE_API_KEY_ID && process.env.APPLE_API_ISSUER);

const pythonEmbed = [{ from: 'resources/python-embed', to: 'python-embed' }];

/** @type {import('electron-builder').Configuration} */
module.exports = {
  appId: 'ws.three.forge',
  productName: 'three.ws Forge',
  copyright: 'Copyright three.ws. Based on Modly by Lightning Pixel (MIT).',
  artifactName: 'three.ws-Forge-${version}-${os}-${arch}.${ext}',
  directories: { output: 'dist', buildResources: 'resources' },
  files: ['out/**/*', 'resources/icons/**/*'],
  extraResources: [
    {
      from: 'api',
      to: 'api',
      filter: ['**/*', '!.venv/**/*', '!venv/**/*', '!__pycache__/**/*', '!**/build/**/*', '!**/*.pyd', '!**/*.egg-info/**/*', '!**/test_*.py'],
    },
    { from: 'out/builtin-extensions', to: 'builtin-extensions' },
    { from: 'LICENSE', to: 'LICENSE' },
    { from: 'NOTICE', to: 'NOTICE' },
  ],
  // ad-hoc signs the macOS bundle when no Developer ID is configured
  afterPack: macSigned ? undefined : 'scripts/after-pack.js',
  // The generic provider is a static directory. electron-builder writes
  // latest.yml / latest-mac.yml / latest-linux.yml beside the artifacts and
  // bakes this URL into app-update.yml, which electron/main/updater.ts reads.
  publish: [{ provider: 'generic', url: FEED_URL, channel: 'latest' }],
  mac: {
    category: 'public.app-category.graphics-design',
    icon: 'resources/icons/icon.png',
    target: [
      { target: 'dmg', arch: ['arm64'] },
      { target: 'zip', arch: ['arm64'] },
    ],
    minimumSystemVersion: '12.0',
    identity: macSigned ? undefined : null,
    hardenedRuntime: macSigned,
    notarize: macNotarize,
    extraResources: pythonEmbed,
    extendInfo: { NSHumanReadableCopyright: 'three.ws. Based on Modly by Lightning Pixel (MIT).' },
  },
  dmg: {
    sign: false,
    writeUpdateInfo: false,
    title: 'three.ws Forge ${version}',
  },
  win: {
    icon: 'resources/icons/icon.png',
    target: [{ target: 'nsis', arch: ['x64'] }],
    signtoolOptions: { publisherName: 'three.ws' },
    extraResources: pythonEmbed,
  },
  nsis: {
    oneClick: false,
    perMachine: false,
    allowToChangeInstallationDirectory: true,
    createDesktopShortcut: true,
    createStartMenuShortcut: true,
    shortcutName: 'three.ws Forge',
    artifactName: 'three.ws-Forge-${version}-win-${arch}-setup.${ext}',
    differentialPackage: true,
  },
  linux: {
    icon: 'resources/icons/icon.png',
    category: 'Graphics',
    target: [
      { target: 'AppImage', arch: ['x64'] },
      { target: 'deb', arch: ['x64'] },
    ],
    extraResources: pythonEmbed,
    executableName: 'three-ws-forge',
    maintainer: 'three.ws <[email protected]>',
    vendor: 'three.ws',
    synopsis: 'Image-to-3D generation and mesh workflows on your machine or the three.ws cloud',
    description: 'Turn images and prompts into 3D models with local open-source generators or the three.ws Forge cloud, chain mesh processing in a node workflow editor, and publish the result to your three.ws account.',
    desktop: { entry: { StartupWMClass: 'three.ws Forge' } },
  },
  deb: {
    packageName: 'three-ws-forge',
    depends: ['libnotify4', 'libxtst6', 'libnss3', 'libsecret-1-0'],
  },
};