Repository navigation
Releases
AeroFlowSim 0.3.2 - Add to Claude
- Add to Claude. Tools > Use with AI assistants has a button Add to Claude: make the plugin file. It writes
AeroFlowSim-Claude-plugin.zipinto the workspace folder (with the full path of this AeroFlowSim, the workspace
folder, the AeroFlowSim skill and the logo) and opens that folder. In Claude: Customize > Plugins > Add >
Upload, choose the file, Upload. Then ask Claude "List the AeroFlowSim templates". No configuration file to
edit. (Current Claude Desktop versions add programs that run on this computer as plugins; "Add custom connector"
only takes internet (HTTPS) servers.) Tested in Claude Desktop 4.23118 on Windows. - Installing the plugin is the user's permission (Claude shows what it is and asks first), so the "Allow" tick is not
needed for it: the plugin startsAeroFlowSim mcp --extension --workspace <folder>. Remove or switch off the plugin
in Claude to stop it. Everything else is unchanged: local only, the workspace folder only, nothing deleted. - The logo: the plugin carries
icon(read by Anthropic's plugin directory; Claude shows a plain icon for plugins
you upload yourself until AeroFlowSim is listed in the directory). - Also new:
tools/build_mcpb.pywrites a Claude Desktop extension (.mcpb, checked against the official schema) for
Claude Desktop versions that install extensions; attached to every release. The installer bundles the skill and
its smoke test checks it. - Ready for Anthropic's plugin directory: the plugin in
integrations/claudestarts the installed program by
its name (AeroFlowSim mcp --extension, no path variable, as the directory requires), has a README that says what
it runs and sends, the logo, licence, documentation, support and privacy links; newPRIVACY.md. The Windows
installer has a ticked box "Let Claude and the command line start AeroFlowSim (add it to PATH)" (the user's PATH,
removed again on uninstall). Tested: Claude ranlist_templatesthrough the uploaded plugin in a normal chat. - No solver, template or validated number changed (results of 0.3.1 projects show "needs update": press Run).
How to add AeroFlowSim to Claude: install AeroFlowSim, open Tools > Use with AI assistants, press "Add to Claude: make the plugin file", then in Claude: Customize > Plugins > Add > Upload that file.
Installers: Windows (setup.exe), macOS (.dmg) and Linux (.AppImage) are attached below by GitHub Actions in about 20 minutes. Not code-signed (see the user guide).
AeroFlowSim 0.3.1 - AI connector in the installed program
- The installed program now includes the AI connector. 0.3.0 installers left out the MCP package, so Claude and
other AI apps could not use AeroFlowSim unless it was installed from source. NowAeroFlowSim.exe mcp(Windows; the
program inside AeroFlowSim.app on macOS, the AppImage on Linux) serves the connector, and Tools > Use with AI
assistants shows configuration text with the path of the installed program; its Test button works there too. - A configuration written for a Python installation (
... -m aeroflowsim mcp) also works with the program. - The Claude Code plugin asks for "AeroFlowSim program (or its python)".
- The installer smoke test now starts the connector and lists its tools; the installer build stops if the MCP
package is missing. - No solver, template or validated number changed. As at every release the version is part of every fingerprint:
results of 0.3.0 projects show "needs update" (press Run).
Installers: Windows (setup.exe), macOS (.dmg) and Linux (.AppImage), attached below by GitHub Actions. Not code-signed (see the user guide).
AeroFlowSim 0.3.0 - 3D
AeroFlowSim is a GUI-first, open-source CFD solver for nozzle and propulsion aerodynamics, with built-in validity checks
and published validation. 0.3.0 completes the 3D workflow:
- Multiple cell zones in 2D and 3D: overlapping fluid bodies become zones that share their faces (Gmsh/OpenCASCADE
Fragment), each with its own name, cell size, start state or "excluded"; flux balance per zone and per interface;
zones kept in Gmsh, SU2, CGNS (now also 3D) and Fluent mesh files. - 3D nozzles: a new 3D nozzle template (quarter or full, optional plume region), plume / plenum regions round any
imported nozzle, and a step-by-step tutorial. - 3D Results: Cp (or any field) along a cut of the walls, report definitions, snapshots and comparison.
- 3D geometry: pick edges for a local cell size, fillet, chamfer; split bodies by a plane.
- Honest validation: the bow-shock stand-off on tetrahedra was traced to shock-layer resolution plus the gap of
Billig's correlation (the structured-grid answer is converged; the tetrahedral one levels off about 3.5 % above it,
an open gap). ONERA M6 (Euler, NASA data) passes its pre-registered Cp limit, just inside (0.0996 vs 0.10). The new
3D-vs-axisymmetric nozzle case passes for Isp and is a documented SHORTFALL for mass flow / thrust on the default
mesh; the 3D laminar CubeSat nozzle passes. Every SHORTFALL is listed invalidation/report.md.
Installers: Windows (setup.exe), macOS (.dmg) and Linux (.AppImage), built by GitHub Actions from the tag. Not
code-signed (see the user guide). Results of 0.2 projects show "needs update": press Run.
AeroFlowSim v0.2.0a3
AeroFlowSim 0.2.0a2 (alpha): speed
Second alpha of AeroFlowSim: the 2D / axisymmetric solver is now fast.
Speed (Prompt 8)
- Compiled Numba kernels on all CPU cores (Tools > Preferences > Solver threads; results do not depend on the thread count).
- Implicit LU-SGS time stepping is the default for steady runs (SSP-RK3 and Jameson stay available; projects saved with them keep them).
- Default N2 nozzle (8k cells) converges in about 20 s (was 13-19 min); MMS 128 x 128 in 12.5 s (was 27 min); full validation suite 39 min (was ~3 h).
Validation
- Full suite: all cases pass; 7 of 129 values changed from 0.2.0a1, every change explained in the CHANGELOG.
- NACA 0012 study redesigned (all sizes refined together, up to 137k cells): Mach 0.5 lift and Mach 0.8 drag within tolerance; Mach 0.8 lift 4.8 % low is a documented shortfall (far-field size suspected).
Install
- Windows: run
AeroFlowSim-0.2.0a2-setup.exe(not code-signed: SmartScreen warns; "More info" > "Run anyway"). The first 2D run compiles the solver kernels (about 10-40 s, once). - Source code of this exact version: the tag
v0.2.0a2(GPL-3.0-or-later).
Full details: CHANGELOG.md, validation/report.md, validation/timing.md.
AeroFlowSim 0.2.0a1 - 2D alpha
AeroFlowSim 0.2.0a1 - 2D alpha (pre-release)
A GUI-first, open-source CFD solver for nozzle and propulsion aerodynamics, with built-in validity checks and
published validation. This is the first alpha: 2D planar and axisymmetric, inviscid.
What works
- 2D / axisymmetric finite-volume Euler solver (HLLC with carbuncle fix, second order), full boundary-condition set,
live monitors, Stop / Continue / Start from scratch. - Verified second order by the Method of Manufactured Solutions on quads, distorted quads, triangles and mixed meshes,
planar and axisymmetric (observed L2 order 1.98-2.08). - Validation (validation/report.md): 15 of 15 cases pass - Sod, quasi-1D nozzle, Mach 2 wedge, diamond airfoil
(shock-expansion theory), 15 deg cone (Taylor-Maccoll), Prandtl-Meyer corner, Mach 6 cylinder (stand-off and
carbuncle metric), N2 nozzle (sharp and rounded throat), NACA 0012 (Vassberg and Jameson 2010), Back-Massier-Gier
measured wall pressures, MMS. Two explained shortfalls are listed openly in the report. - Desktop GUI with a CAD-like geometry workspace and a Fluent-level results workspace: contours, lines, vectors,
streamlines, mirror and 3D revolved views, linked views, surfaces, integrals, flux balance, forces, report
definitions as live monitors, XY plots with reference data, snapshots and differences, custom fields, exports
(CSV, VTU, Tecplot), automatic HTML / PDF report. - Command line and scripting with the same engine (run, report, export, snapshot).
Install
Run AeroFlowSim-0.2.0a1-setup.exe (per user, no administrator rights). It is not code-signed: Windows SmartScreen
may warn; choose "More info" > "Run anyway". Example projects are on the start page. User guide: docs/user_guide.md.
Known limitations (docs/gap_register.md)
- Inviscid and 2D only; calorically perfect gas.
- Explicit solver: slow (minutes for the default nozzle); a few cases stall near a residual of 1e-3-1e-4 in a few cells
while forces have settled. Speed (Numba, implicit LU-SGS) is the next step (Prompt 8). - Venkatakrishnan's limiter loses order on smooth flows on fine meshes.
- The NACA 0012 mesh study is not yet a systematic refinement (Cl 4 % low; explained shortfall).
Reporting problems
Open an issue with the bug-report template and paste Help > Copy diagnostic info (no personal data).
Licence note
AeroFlowSim is GPL-3.0-or-later and bundles Gmsh (GPL), Qt / PySide6 (LGPL), VTK (BSD) and others
(THIRD_PARTY_LICENSES.txt). Before this installer is shared with anyone, the repository must be public or the source
code attached to the release.