Skip to main content

CADFLOW 0.1.0 · ALPHA

CadFlow

Python-first CAD infrastructure for programmatic modeling and geometry-grounded agents.

Start buildingInstall CadFlow

CadFlow is a Python-first CAD SDK for programmatic modeling and geometry-grounded agents. Its public Python frontend drives a handle-oriented C++17 runtime, keeping OpenCascade geometry native while exposing predictable operations, JSON-safe diagnostics, inspection tools, and portable artifacts.

CadFlow is not a text-to-3D model or an LLM application. It is the deterministic CAD layer underneath those systems: a program or agent describes modeling intent, CadFlow constructs and measures the geometry, and the result comes back with evidence that software can act on.

New to CadFlowInstall from source, then build and validate your first part in ten minutes.Read docs →Modeling workflowsLearn profiles, features, booleans, transforms, and dependable export.Read docs →Building for agentsUse structured diagnostics, preflight checks, replay, and focused CAD skills.Read docs →API referenceFind stable public entry points organized by core object and domain.Read docs →

What you can build​

AreaIncluded capabilities
Solid modelingPrimitives, profiles, extrusion, revolution, loft, sweep, fillet, chamfer, shell, and exact booleans
Curves and surfacesLines, arcs, splines, helices, Bezier and B-spline surfaces, ruled/filling/Gordon surfaces, and twisted sweeps
SketchingImmutable coordinate frames, workplanes, declarative sketches, constraints, and py-slvs solving
Flexible geometryControl-grid panels, periodic thin shells, multi-panel composition, and OBJ/STL/JSON export
InspectionMass properties, distance, bounds, topology, normals, curvature, free boundaries, and BREP comparison
DeliverySTEP, STL, GLB preview, Model JSON, strict replay, and validated Scene archives
Product structureAssemblies, connectors, constraints, semantic tags, source mapping, materials, and standard parts

Pick the right API layer​

CadFlow intentionally offers a small modern frontend and a larger compatibility surface.

Start withUse it for
cadflow.Model and cadflow.ShapeInteractive construction, measurement, validation, and export
cadflow.GraphCompact typed operation batches executed through one native call
Public domain modulesSketches, assemblies, inspection, serialization, Scene archives, and standard parts
cadflow.compatThe complete compatibility API while native migration continues

New integrations should begin with Model or Graph. Use public domain modules for higher-level workflows and keep application code independent of cadflow._engine, OpenCascade objects, private handles, and direct C++ library loading.

Alpha status

CadFlow 0.1.0 is an alpha release. The full OCCT-backed source build is currently tested on Linux x86-64. Public geometry paths are moving from the bundled compatibility engine into the native session one domain at a time; check the native compatibility boundary before making deployment assumptions.

Where to go next​

  • Follow Installation for a reproducible OCCT-backed source build.
  • Complete the Quickstart to create, validate, and export a part.
  • Learn the stable mental model in Architecture.
  • Use the API overview to find the public surface for a domain.