CakeCFD

Overview

Everything from geometry to results

One workflow, from CAD import through meshing, solving, and analysis.

TENO convection schemes

Targeted Essentially Non-Oscillatory schemes with adaptive C_T weighting, shipped as a wmake library not in stock OpenFOAM.

Geometry import

Native STEP and BREP import via OpenCASCADE 7.6, with automatic tessellation and STL export for meshing.

Automated meshing

A guided blockMesh / snappyHexMesh pipeline covering surface features, boundary layers, and refinement regions.

Native 3D viewport

Qt5 + VTK 9 interface with isocontours, streamline tracing, live residual plots, and a solver console.

Turbulence database

Configured for the Johns Hopkins Turbulence Database with custom server integration, providing DNS inflow data directly exportable to OpenFOAM boundary conditions.

AI-driven control

Drive meshing, solving, and reporting from natural language through the companion cakecfd_ai package.

Components

Two repositories, one workflow

Both are public and licensed for reuse.

Desktop application

Cake Studio

A native C++ Qt5 application covering the full workflow: geometry import, mesh generation, solver configuration, run control, and post-processing in a single interface.

Per-solver dialog writes fvSchemes, fvSolution, initial fields
Dark and light themes
Linux (Ubuntu 22.04+) or WSL2 on Windows via WSLg

View repository Build instructions

AI interface

cakecfd_ai

A Python package that exposes meshing, solving, monitoring, and post-processing as tools Claude can call — set up, run, and interpret a simulation from natural language.

Python API (CakeAgent), CLI REPL, and direct tool calls with no API key
14 tools spanning meshing, solver control, and reporting
pip install cakecfd_ai

View repository Usage guide

Numerics

Solver & verification status

Solver base	OpenFOAM 2412, finite volume method
Supported solvers	simpleFoam, icoFoam, pimpleFoam, pisoFoam, rhoSimpleFoam, rhoPimpleFoam, rhoCentralFoam, buoyantSimpleFoam, buoyantPimpleFoam
Turbulence closures	k–ω SST, k–ε, Spalart–Allmaras
License	GNU General Public License v3.0 (solver & application)

Verification status. As shipped, the TENO schemes measure second order on smooth linear advection, not the fifth and sixth order of the reference formulation — the reconstruction reduces to central differencing in smooth regions, a deliberate choice for pressure–velocity stability that caps the achievable order. Reproducible via validation/tools/advection_order.py (case VC‑001). A k‑exact upwind‑biased reconstruction reaching approximately fifth order on the same test is in progress on a development branch.

Roadmap

Project status

Component	Status
Solver core & TENO schemes	Public — higher-order in progress
Cake Studio application	Public — repository
`cakecfd_ai` package	Public — repository
Cross-platform installer	Planned
Technical manuscript	Planned

License

Licensing

CakeCFD (solver core and Cake Studio application) is released under the GNU General Public License v3.0 — source at github.com/CakeCFD/cake-studio. The companion cakecfd_ai package is released separately under CC BY 4.0 — source at github.com/CakeCFD/cakecfd-ai.

Documentation

Getting started

References for building, installing, and using CakeCFD.

Building Cake Studio

Dependencies, build instructions, and platform notes for Ubuntu 22.04+ and WSL2.

Build guide →

cakecfd_ai usage

API reference, CLI usage, and examples for the Python AI interface package.

Usage guide →

Solver repository

Source, validation cases, and TENO scheme implementation details.

cake-studio →

AI interface repository

Tool definitions, agent loop, and CLI REPL source for cakecfd_ai.

cakecfd-ai →

High-order CFD, built on OpenFOAM