Repository navigation
Limitations
Written plainly so you can decide whether this fits your work before you invest time in it.
Docker Desktop only. Colima, OrbStack, Rancher Desktop, and podman are not reachable. The app looks for Docker Desktop's default socket, and a GUI app does not inherit the DOCKER_HOST from your shell. No UI setting to override it yet.
"Fix it for me" can fail on macOS. Finder-launched apps get a minimal PATH without /usr/local/bin or /opt/homebrew/bin, so the auto-fix cannot find the docker or npm binaries. Manual commands work; see Troubleshooting.
Unsigned binaries. No code signing or notarization, so both macOS and Windows warn on first launch. Signing certificates cost money this project does not currently spend.
Rolling releases, not versions. mac-latest and windows-latest are replaced on every push to main. There is no way to pin or roll back to a specific earlier build.
Windows is less tested. The installer is built by CI on every push and the code is identical, but day-to-day use and manual verification happen on macOS.
No CAD import and no GUI mesh generation. Geometry comes from blockMeshDict. If your work starts from STEP or STL files and needs snappyHexMesh, this is not your tool yet.
No cloud or multi-machine execution. Everything runs in one container on your machine. No cluster support, no MPI decomposition across nodes.
OpenFOAM Foundation v13 only. Not the ESI/OpenCFD fork, and not older Foundation releases. Solver names and dictionary keywords differ enough between forks that supporting both properly is its own project.
Incompressible flow is the well-trodden path. That is what the staged tests validate and where the knowledge base is deepest. Compressible, multiphase, and heat-transfer cases can work — a VoF path with setFields exists — but you are further from what is tested.
Turbulence is thinner than laminar. RANS fields are generated and understood, but validation focused on the laminar Ghia benchmark.
Post-processing is a first look, not a replacement for ParaView. The Results tab covers slice, clip, iso-surface, glyphs, streamlines, probe, and time animation. It has no calculator, no custom expressions, no plot-over-line, no animation export. Your case directory is a normal OpenFOAM case, so open it in ParaView when you need the real thing.
Case generation is demanding: OpenFOAM's file layout, dependency ordering, and exact patch-name consistency across a dozen files. Frontier models handle it well. Small local models often lose patch-name consistency between blockMeshDict and the 0/ fields, which produces a case that will not mesh.
Local models through Ollama or LM Studio work and keep everything offline, but expect more retries on anything beyond a tutorial case.
The app is free and MIT-licensed. Your provider is not. A non-trivial case generation is a multi-turn conversation with a large system prompt and several file writes, so it consumes real tokens — more than a single chat message, less than a coding session. Local models cost nothing but your GPU.
The agent has no shell access. Docker commands come from a fixed eight-command allowlist and file writes are confined to managed project directories. The local server binds to loopback only.
What is not claimed: the app has not had a third-party security audit. If you find something, SECURITY.md explains how to report it privately.
This offering is not approved or endorsed by OpenCFD Limited, producer and distributor of the OpenFOAM software via www.openfoam.com, and owner of the OPENFOAM and OpenCFD trademarks.
MIT licensed. Not approved or endorsed by OpenCFD Limited, owner of the OPENFOAM and OpenCFD trademarks.