forbes-0023
5319387030
- build.yml: Add --force flag to tag fetch to prevent 'would clobber
existing tag' error when 'latest' tag already exists locally
- build.yml: Use github.run_id instead of github.sha for ccache keys
to ensure unique keys per workflow run while still benefiting from
restore-key prefix matching
- release.yml: Add --force flag to tag fetch commands
- release.yml: Use github.run_id for ccache keys (same reason)
- release.yml: Comment out build-macos and build-windows jobs since
no native runners are available for these platforms
- release.yml: Update publish-release to only depend on build-linux
- release.yml: Update release notes to indicate macOS/Windows builds
are not yet available
The ccache key strategy now works correctly with immutable caches:
- Save with unique key: ccache-{workflow}-{branch}-{run_id}
- Restore with prefix fallback: tries same branch first, then main
The macOS and Windows jobs require platform-specific tooling:
- macOS: dmgbuild, pyobjc-framework-Quartz for DMG creation
- Windows: NSIS, Visual Studio toolchain for installer creation
These cannot be easily cross-compiled from Linux. The jobs are
preserved as comments so they can be re-enabled when native runners
become available or when cross-compilation tooling is set up.
Kindred Create
An engineering-focused parametric 3D CAD platform built on FreeCAD 1.0+
Website | Downloads | Issue Tracker
Kindred Create is in active development. Features and interfaces may change.
What is Kindred Create?
Kindred Create is a fork of FreeCAD that adds integrated tooling for professional engineering workflows. It ships two custom workbenches and a purpose-built dark theme on top of FreeCAD's parametric modeling core.
ztools -- A unified workbench that consolidates part design, assembly, and sketcher tools into a single interface. Adds custom datum creation (planes, axes, points with 16 creation modes), pattern tools for assemblies, an enhanced pocket with flip-side cutting, and spreadsheet formatting commands.
Silo -- A parts database system for managing CAD files, part numbers, revisions, and bills of materials across teams. Includes a Go REST API server backed by PostgreSQL and MinIO, with FreeCAD commands for opening, saving, and syncing files directly from the application. A dock panel provides in-viewport browsing and search.
Catppuccin Mocha theme -- A dark theme applied across the entire application, including the 3D viewport, sketch editor, spreadsheet view, and tree view. Uses spanning-line branch indicators instead of disclosure arrows.
Kindred Create is maintained by Kindred Systems LLC.
Installing
Prebuilt packages (Linux)
Download from the releases page.
Debian/Ubuntu:
sudo apt install ./kindred-create_*.deb
AppImage:
chmod +x KindredCreate-*.AppImage
./KindredCreate-*.AppImage
Building from source
Kindred Create uses pixi for dependency management and CMake for building.
git clone --recursive ssh://git@git.kindred-systems.com:2222/kindred/create.git
cd create
pixi run configure
pixi run build
pixi run install
pixi run freecad
Debug and release variants are available (pixi run build-debug, pixi run build-release). See CMakePresets.json for platform-specific presets covering Linux, macOS, and Windows.
For general FreeCAD compilation guidance, see the FreeCAD wiki for Linux, Windows, or macOS.
Usage
Kindred Create is compatible with standard FreeCAD workflows. The FreeCAD wiki covers general usage.
ztools
Select the ztools workbench from the workbench selector. It presents consolidated toolbars from PartDesign, Sketcher, Assembly, and Spreadsheet in a single interface. ZTools commands are also injected into the PartDesign workbench menus and toolbars automatically.
See mods/ztools/ for workbench-specific documentation.
Silo
Silo requires a running server instance. See mods/silo/README.md for server deployment instructions.
The FreeCAD workbench reads configuration from:
SILO_API_URL-- Server API endpoint (default:http://localhost:8080/api)SILO_PROJECTS_DIR-- Local projects directory (default:~/projects)
On first launch, Kindred Create prompts for Silo server configuration. Silo commands (Open, Save, Commit, Pull, Push, BOM) are available in the File menu across all workbenches.
Project structure
create/
├── src/
│ ├── App/ # Core application (C++)
│ ├── Base/ # Base classes (C++)
│ ├── Gui/ # GUI framework and stylesheets (C++)
│ ├── Mod/ # FreeCAD modules (PartDesign, Assembly, Sketcher, ...)
│ │ └── Create/ # Kindred bootstrap module -- loads ztools and Silo
│ └── 3rdParty/ # Vendored dependencies (OndselSolver, GSL)
├── mods/ # Kindred addon workbenches (git submodules)
│ ├── ztools/ # ztools workbench
│ └── silo/ # Silo parts database
├── resources/preferences/ # Default preferences and theme
├── package/ # Packaging (Debian, AppImage, Windows installer, RPM)
├── .gitea/workflows/ # CI/CD (build and release pipelines)
├── docs/ # Architecture and integration docs
├── CMakeLists.txt # Root build configuration
├── CMakePresets.json # Platform build presets
└── pixi.toml # Pixi environment and tasks
The mods/ workbenches are git submodules. If you cloned without --recursive, initialize them with:
git submodule update --init --recursive
Contributing
Contributions follow the FreeCAD Contribution Process (FCP). Submit changes as pull requests against the main branch.
Code quality tools are configured and enforced via pre-commit hooks:
- C/C++: clang-format, clang-tidy
- Python: black (100-char lines), pylint
Install pre-commit hooks locally:
pip install pre-commit
pre-commit install
Reporting issues
Report issues at the issue tracker. When reporting:
- Note whether the issue involves Kindred Create additions (ztools, Silo, theme) or base FreeCAD
- Include version info from Help > About FreeCAD > Copy to clipboard
- Provide reproduction steps and attach example files (FCStd as ZIP) if applicable
For base FreeCAD issues, also check the FreeCAD issue tracker.
License
LGPL-2.1-or-later, consistent with FreeCAD.
Acknowledgments
Built on FreeCAD and its ecosystem: OpenCASCADE, Coin3D, Qt, Python. Theme colors from Catppuccin.