RatioLab 0.1.0 Preview 2

Second public preview of RatioLab, an open-source parametric gear and reducer generator by NoOneExceptEnderk, licensed under GNU GPL version 3 only.

Fusion integration for Windows and Linux — 2026-10-29

Updated Windows Setup and Linux .run, .tar.gz and .deb downloads include CAD integrations → Install Fusion add-in / Connect / Create in Fusion.

• Fusion receives individual STEP BRep solids in a new component group, with source parameters, roles, visibility and BOM metadata. The bridge checks millimetre dimensions and volume and removes its new group on a failed import. Native Fusion feature timelines and joints are not reconstructed; RGB values are retained as metadata.
• Windows verified on a local PC: Fusion 2705.1.30, all nine default families and 74 components, failure cleanup, installation and the complete application-button workflow. The newly installed Windows bundle passed its GUI/export/MCP checks; 1083 manifest entries matched. Desktop OpenGL 3.3 / GLES 3.0 minimums are retained.
• Linux: the native RatioLab app can connect to Windows Fusion running through a community Wine/Proton port. Prefix/profile discovery and C-drive staging avoid requiring a Z: mapping. Set RATIOLAB_FUSION_WINEPREFIX (and RATIOLAB_FUSION_WINEUSER for ambiguous profiles) for custom installations. Linux installers and native runtime/rendering/export checks passed on Ubuntu CI. Wine path/protocol tests passed; a live Fusion-under-Wine import has not been verified.
• All seven GitHub Actions jobs passed for 2bf46071. See the Fusion setup guide and the attached checksum and build-evidence files.

Updated Windows/Linux runtime source: 2bf460713f667fd7c7738fe9262b573668f23e3b (source archive). macOS downloads keep their original Preview 2 binaries. The published tag and GitHub's automatic source archives still refer to the original preview revision.

Earlier Windows graphics hotfix — 2026-10-29

The Windows installer has been replaced with a build that fixes the "Application does not support OpenGL API" failure and black numeric text on the dark GTK workspace.

• GTK can negotiate desktop OpenGL 3.3+ or OpenGL ES 3.0+, with separate minimum-version requests. Shader dialect follows the realized context.
• Workspace controls inherit the intended foreground while retaining semantic and primary-button colors.
• Verified on a local Windows PC with NVIDIA GeForce GT 1030 / desktop OpenGL 4.6: 25 targeted tests passed; the installed application rendered all nine families, exported the workspace and passed both MCP protocol checks with external runtimes removed from PATH. All 1,079 installed manifest files matched the verified bundle.
• An additional 55 regression tests had 50 passes, one skip and four failures/errors reproduced unchanged on the original commit. GLES-only rendering is unavailable on this PC; its fallback and shader selection are covered by regression tests.

Windows runtime source: be73d21c437ba5c5ee562d8bce6cc610eab0d1cc (source archive). At the time of that hotfix, Linux and macOS downloads retained the original Preview 2 binaries. The published tag and its automatic source archives still refer to the original preview commit.

Repository cleanup

The public repository now separates application code in src/, automated checks in tests/, and user/developer documentation in docs/. The README starts with platform downloads and simple installation steps. Internal agent notes and working records remain outside the public source. Catalogs and branding have one canonical location. Runtime imports, project formats and calculation logic remain compatible.

Downloads

Python, GTK and the required application libraries are included. You do not need to install them separately.

System	Download
Windows 11 x86-64	RatioLab-0.1.0-windows-x86_64-setup.exe
macOS 15+, Apple Silicon	RatioLab-0.1.0-macos-arm64.dmg
macOS 15+, Intel	RatioLab-0.1.0-macos-x86_64.dmg
Linux x86-64, glibc 2.39+ (Ubuntu 24.04 baseline)	ratiolab_0.1.0_amd64.deb for Debian/Ubuntu, or RatioLab-0.1.0-linux-x86_64.run for a user installation; .tar.gz also available

Open Setup on Windows. On macOS, open the DMG and drag RatioLab to Applications. On Linux, open the .deb in the software manager or run sh RatioLab-0.1.0-linux-x86_64.run.

Included

• Nine gear/reducer families and an animated 3D workspace.
• Standalone STEP, STL and SVG/DXF, complete portable exports and BOMs.
• Projects with Undo/Redo, recent files, atomic saves and recovery.
• Generated tooth-root profiles and geometric worm/strain-wave study models.
• Discrete interference/distance checks and finite parameter searches.
• Component selection, isolation, sampled measurements and subset exports.
• An offline RatioLab-MCP companion (RatioLab-MCP.exe on Windows) with 13 agent tools, requiring no open GUI. MCP setup.

Repository/example filenames, code comments and exported report suffixes are in English. Source modules and tests are organized into dedicated folders; tests are excluded from installed applications. Earlier configuration formats remain readable; older preferences are preserved and migrate to ui-preferences.json when saved. The source includes a contributor guide and project license/attribution; the installers include those project notices and separate dependency notices.

Verification and preview limits

Original cross-platform build, before this Windows hotfix: 362 source tests passed, with no failures or skips. All four native installer jobs and all three Python distribution jobs passed. Installed GUI rendering, nine family previews, workspace exports and both supported MCP protocols were checked on Linux, Windows and both macOS architectures. The Windows hosted runner is Windows Server 2025; testing on individual Windows 11 systems is welcome. Hosted graphics checks do not cover every GPU/driver.

Windows Setup has no publisher signature. macOS uses ad hoc signing without Apple notarization, so the operating system may display a warning. The original Linux/macOS binaries need desktop OpenGL 3.3+. The updated Windows installer negotiates desktop OpenGL 3.3+ or OpenGL ES 3.0+, with ANGLE included as a GLES backend.

Interference checks use discrete samples; searches and measurements use the documented finite domains/sampled surfaces. Worm and strain-wave geometry are study models. This release does not certify strength, service life or manufacturing readiness.

SHA256SUMS covers all six installers. build-evidence.json records their exact hashes, native jobs and installed GUI/MCP results. See installation, verification evidence, license and contributing.

Native installer checks · Python distribution checks.

Original cross-platform runtime and release source commit: 870835e63fcf78e01b4c08acec0f271848cc7dca. Updated Windows/Linux runtime source commit: 2bf460713f667fd7c7738fe9262b573668f23e3b.