Skip to content

Build from Source

This page is for advanced users and contributors. Ordinary Windows users should use the prebuilt package from GitHub Releases.

Clone and Bootstrap

git clone <your-repo-url>
cd f8studio

Use Pixi tasks for common runtime commands:

pixi run -e default f8pystudio
pixi run -e default runner --help

Python and Runtime Basics

  • The workspace is organized through pixi.toml
  • Runtime services are described by services/**/service.yml
  • Static discovery metadata is stored in services/**/describe.json

Regenerate static describes when needed:

pixi run -e default update_describes

Native/C++ Services

Bootstrap and build native services:

pixi run -e cpp cpp_bootstrap
pixi run -e cpp cpp_configure_release
pixi run -e cpp cpp_build_release

Refresh locks when dependency versions change:

pixi lock
pixi run -e cpp cpp_lock_refresh

Packaging

Build a distributable runtime bundle:

pixi run -e ci dist_ci
  • Output directory: build/dist/f8studio-<platform-tag>
  • Optional archive mode: pixi run -e ci dist_ci --archive

Build a Studio launcher executable:

pixi run -e ci build_studio_launcher

Windows Notes

  • CI uses GitHub-hosted Windows runners plus MSVC environment setup
  • Local Windows native builds still need Visual Studio Build Tools