# Cadaclysm

> Cadaclysm reads CAD files (STEP, IGES, IFC, Rhino 3dm, ACIS SAT, OpenCASCADE BREP, OpenSCAD
> and more) into a scene of nodes, meshes and exact surfaces, and builds exact B-rep solids
> with its modelling kernel, the blacksmith: extrude, revolve, loft, sweep, booleans, fillets,
> chamfers, shells -- and plans their machining, written as G-code. One C ABI, wrapped for Python, C#, Go, Java, Node.js, Rust, Swift, LuaJIT,
> Godot and C++, and built for WebAssembly.

To write code that builds parts with the kernel, read the modelling guide first: it is one
self-contained Markdown file with the conventions, worked examples and the Python API,
machining (CAM) included.

## Modelling guide

- [Modelling guide for language models](https://cadaclysm.blitter.studio/llms-full.txt): everything a model needs to write Python that builds solids with the blacksmith and machines them to G-code
- [Using an LLM with cadaclysm](https://cadaclysm.blitter.studio/docs/llm.html): how to give the guide to ChatGPT, Gemini or Claude, and a prompt to start from

## Docs

- [Concepts](https://cadaclysm.blitter.studio/docs/concepts.html): the object model every wrapper shares
- [Python API](https://cadaclysm.blitter.studio/docs/python.html): every type and call of the Python wrappers
- [Getting started](https://cadaclysm.blitter.studio/docs/start.html): the SDK, the licence, a first program in each language
- [Examples](https://cadaclysm.blitter.studio/examples.html): nine parts, the code that built each in every language

## Optional

- [Python notebook](https://cadaclysm.blitter.studio/notebook/): the kernel in the browser, over WebAssembly
- [Formats](https://cadaclysm.blitter.studio/formats.html): what the reader opens and the writers write
- [Query language](https://cadaclysm.blitter.studio/filter.html): the filter expressions `Scene.query` takes