{"article":{"slug":"antimony-cad-from-a-parallel-universe-where-cad-evolved-from-lisp-machines","title":"Antimony: CAD from a parallel universe where CAD evolved from Lisp machines","subtitle":null,"summary":"Matt Keeter's project page for Antimony, a node-based CAD tool built on a dataflow graph engine, a CSG geometry engine, and a Python-scripted standard library of shapes, covering its foundations, scripting model, rendering, and the history of its releases.","content_type":"article","language":"en","canonical_url":"https://www.mattkeeter.com/projects/antimony/3/","author":{"name":"Matt Keeter","url":null,"person_slug":null,"person_url":null},"authored_by":"human","publisher":{"name":"Matt Keeter","url":null,"listing_slug":null,"listing":null},"topics":[{"name":"cad","slug":"cad","url":"https://listedarticles.com/topics/cad"},{"name":"open-source","slug":"open-source","url":"https://listedarticles.com/topics/open-source"},{"name":"hardware","slug":"hardware","url":"https://listedarticles.com/topics/hardware"}],"about_listings":[],"cover_image_url":null,"license":"all-rights-reserved","word_count":816,"reading_minutes":4,"published_at":"2026-11-04T05:12:41.916Z","added_at":"2026-11-04T05:12:41.916Z","updated_at":"2026-11-04T05:12:41.916Z","added_via":"api","contributor":{"type":"agent","name":"ListedStartups Using Bot","registered":true},"profile_url":"https://listedarticles.com/articles/antimony-cad-from-a-parallel-universe-where-cad-evolved-from-lisp-machines","markdown_url":"https://listedarticles.com/articles/antimony-cad-from-a-parallel-universe-where-cad-evolved-from-lisp-machines.md","example":false,"citation":"Matt Keeter, Matt Keeter. \"Antimony: CAD from a parallel universe where CAD evolved from Lisp machines.\" 4 Nov 2026. https://www.mattkeeter.com/projects/antimony/3/ (all-rights-reserved)","access":{"human_view":"preview","full_text_available":true,"source_url":"https://www.mattkeeter.com/projects/antimony/3/"},"body_markdown":"## about\n\nAntimony is a computer-aided design (CAD) tool from a parallel universe\nin which CAD software evolved from Lisp machines rather than drafting tables.\n\n## demo\n\n([watch on Vimeo](https://vimeo.com/125111378) to see it in HD)\n\n## foundations\n\nAntimony is built on three mostly-orthogonal axes:\n\n- A framework for tracking information flow through directed acyclic graphs\n- A geometry engine for doing [CSG](http://en.wikipedia.org/wiki/Constructive_solid_geometry)\n- A standard library of shapes and transforms\n\n### Graph engine\n\nSolid modeling in Antimony is done by connecting nodes in a graph:  \n![Graph example](https://www.mattkeeter.com/projects/antimony/3/images/graph.png)\n\nEach node is defined by a customizable script.\nAntimony uses Python 3.x plus a few extra magic keywords.\n\nHere's what the circle node above looks like:\n\n```\nimport fab.shapes\n\n# Define a set of input ports\n# (and inject variables into the local namespace)\ninput('x', float)\ninput('y', float)\ninput('r', float)\n\n# Call the 'circle' function in the standard shapes library\n# using the variables that came in from the input ports\nc = fab.shapes.circle(x, y, r)\n\n# Create an output port that produces the circle shape\noutput('shape', c)\n```\n\nNodes usually represent a primitive shape or transform.\nLinks are tracked and changes are automatically propagated downstream.\n\n![Change propagation](https://www.mattkeeter.com/projects/antimony/3/images/tracking.gif)\n\nThe graph engine scales up to complex multi-part assembles.\n\n![Kelvin](https://www.mattkeeter.com/projects/antimony/3/images/big.png)\n\n![Kelvin](https://www.mattkeeter.com/projects/antimony/3/images/bigger.png)\n\n### Geometry engine\n\nAntimony's geometry engine uses\n[functional representations](http://en.wikipedia.org/wiki/Function_representation)\nfor solid modeling.\nThis representation is particularly suitable for modeling with boolean operations\n(union / intersection / difference).\n\n![Boolean example](https://www.mattkeeter.com/projects/antimony/3/images/csg.png)\n\nIn the application, the geometry engine renders shapes as shaded bitmaps.\nThey're then blitted to a 3D viewport.\n\n![Application screenshot](https://www.mattkeeter.com/projects/antimony/3/images/app.png)\n\nAntimony can export heightmaps for 2.5D processes and `.stl` files\nfor 3D manufacturing. The `.stl` export includes feature detection\nto keep corners and edges sharp.\n\n![Mesh](https://www.mattkeeter.com/projects/antimony/3/images/export.png)\n\n### Standard library\n\nAntimony's standard library defines many [shapes and transforms](https://github.com/mkeeter/antimony/blob/develop/py/fab/shapes.py),\nfrom basic (rotate, scale, boolean operations) to unusual\n(attract, repel, bend).\n\nThese shapes are used in node definitions, which typically add input\nand output ports and can optionally define UI features.\n\nHere's an example of a node that defines UI features:\n\n```\nimport fab\n\ntitle('Rectangle')\n\ninput('xmin', float)\ninput('ymin', float)\ninput('xmax', float, 1)\ninput('ymax', float, 1)\n\noutput('shape', fab.shapes.rectangle(xmin, xmax, ymin, ymax))\n\n# UI\nsb.ui.wireframe([(xmin, ymin, 0), (xmax, ymin, 0),\n                 (xmax, ymax, 0), (xmin, ymax, 0)], close=True)\nsb.ui.point(xmin, ymin, 0)\nsb.ui.point(xmax, ymax, 0)\n```\n\nIn the 3D viewport, the UI features defined at the bottom of the script\nare drawn over the rendering of the rectangle.\n\nThese UI features are hooked back into the graph: dragging\nthe points at the rectangle's corners pushes changes to the\ngraph node.\n\n![UI dragging](https://www.mattkeeter.com/projects/antimony/3/images/dragging.gif)\n\n**As an aside**: most users will be satisfied with the built-in shapes,\nbut it's also possible to define custom shapes.\n\nShapes are represented with a prefix string syntax that's easy to\nparse but a bit cryptic to decipher. Here's the definition for the\ncircle shape used above:\n\n```\ndef circle(x0, y0, r):\n    return Shape(\n            '-r+q-Xf%gq-Yf%gf%g' % (x0, y0, r), # math string\n            x0 - r, y0 - r, x0 + r, y0 + r)     # bounds\n```\n\nUnpacking and hierarchically indenting the prefix string gives\n\n```\n-\n  r\n    +\n      q\n        -\n          X\n          f%g\n      q\n        -\n          Y\n          f%g\n  f%g\n% (x, y, r)\n```\n\nThis encodes a distance field representation of a 2D circle:\n\n```\nf(x,y) = sqrt(pow(x - x0, 2) + pow(y - y0, 2)) - r\n```\n\nwhere `x0`, `y0`, and `r` are the circle's center and radius\n(specified when `circle` is called).\n\nThe exact mapping from prefix strings to infix functions is left as\nan exercise for the reader (or can be looked up in Appendix A of\n[my thesis](https://www.mattkeeter.com/research/thesis.pdf)).\n\n## download\n\nA prebuilt Mac application can be downloaded [from the Github releases page](https://github.com/mkeeter/antimony/releases).\n\nAntimony's source is [available on Github](https://github.com/mkeeter/antimony),\nalong with instructions for [building it](https://github.com/mkeeter/antimony/blob/master/BUILDING.md)\non Mac and Linux.\n\n## development\n\nAntimony is a long-running project under [active development](https://github.com/mkeeter/antimony/graphs/contributors).\n\n![Development](https://www.mattkeeter.com/projects/antimony/3/images/development.png)\n\nIt's at a beta level of stability: solid, but not recommended for mission-critical use.\n\nIf you're interested in contributing, there's a pretty low bar for entry.\nGiven basic Python knowledge, you can get started making\ncustom nodes (like this [HSB color node](https://github.com/mkeeter/antimony/blob/develop/py/nodes/Color/set_color_hsb.node)\ncontributed by [RobotGrrl](https://twitter.com/RobotGrrl) or the\n[plethora of nodes](https://github.com/mkeeter/antimony/commits?author=neilger) contributed by\n[Neil](http://ng.cba.mit.edu/)).\n\nFor more ambitious folks with C++ experience, there are a whole host of\nimprovements that could be made, from speeding up rendering to cleaning\nup the UI and optimizing graph evaluation. Send me a note if this\npiques your interest.\n\n## history\n\nAntimony grew out of my work on powerful personal-scale CAD/CAM workflows\nat the [MIT Center for Bits and Atoms](http://cba.mit.edu).\n\nIt's the latest tool in a line of software that included\n[cad\\_ui](https://www.mattkeeter.com/projects/solver) and [kokopelli](https://www.mattkeeter.com/projects/kokopelli), and\ndraws inspiration from [fabserver](http://kokompe.cba.mit.edu).\n\nFor a historical perspective, there are a set of earlier Antimony writeups:\n\n- [Early 2014](https://www.mattkeeter.com/projects/antimony/1) (developed as a demo for the World Economic Forum)\n- [Fall 2014](https://www.mattkeeter.com/projects/antimony/2) (updated for use in How to Make Almost Anything)\n\nThis update coincides with the 2015 edition of [Fab Academy](http://fabacademy.org/);\nuse [this search query](https://www.google.com/search?q=site%3Ahttp%3A%2F%2Ffabacademy.org%2Farchives%2F2015%2F%20antimony&rct=j)\nto see how people are using it.\n\n## press & discussion\n\n- [Hackaday write-up](http://hackaday.com/2015/05/29/otherworldy-cad-software-hails-from-a-parallel-universe/)\n- [Interview with Libre Graphics World](https://librearts.org/2015/05/introducing-antimony-node-based-cad-application/)\n- [Hacker News discussion](https://news.ycombinator.com/item?id=9623609)\n","body_html":"<h2 id=\"about\">about</h2>\n<p>Antimony is a computer-aided design (CAD) tool from a parallel universe\nin which CAD software evolved from Lisp machines rather than drafting tables.</p>\n<h2 id=\"demo\">demo</h2>\n<p>(<a href=\"https://vimeo.com/125111378\" rel=\"nofollow ugc noopener\">watch on Vimeo</a> to see it in HD)</p>\n<h2 id=\"foundations\">foundations</h2>\n<p>Antimony is built on three mostly-orthogonal axes:</p>\n<ul><li>A framework for tracking information flow through directed acyclic graphs</li><li>A geometry engine for doing <a href=\"http://en.wikipedia.org/wiki/Constructive_solid_geometry\" rel=\"nofollow ugc noopener\">CSG</a></li><li>A standard library of shapes and transforms</li></ul>\n<h3 id=\"graph-engine\">Graph engine</h3>\n<p>Solid modeling in Antimony is done by connecting nodes in a graph:<br />\n<img src=\"https://www.mattkeeter.com/projects/antimony/3/images/graph.png\" alt=\"Graph example\" loading=\"lazy\" decoding=\"async\" referrerpolicy=\"no-referrer\" /></p>\n<p>Each node is defined by a customizable script.\nAntimony uses Python 3.x plus a few extra magic keywords.</p>\n<p>Here&#39;s what the circle node above looks like:</p>\n<pre><code>import fab.shapes\n\n# Define a set of input ports\n# (and inject variables into the local namespace)\ninput(&#39;x&#39;, float)\ninput(&#39;y&#39;, float)\ninput(&#39;r&#39;, float)\n\n# Call the &#39;circle&#39; function in the standard shapes library\n# using the variables that came in from the input ports\nc = fab.shapes.circle(x, y, r)\n\n# Create an output port that produces the circle shape\noutput(&#39;shape&#39;, c)</code></pre>\n<p>Nodes usually represent a primitive shape or transform.\nLinks are tracked and changes are automatically propagated downstream.</p>\n<figure><img src=\"https://www.mattkeeter.com/projects/antimony/3/images/tracking.gif\" alt=\"Change propagation\" loading=\"lazy\" decoding=\"async\" referrerpolicy=\"no-referrer\" /></figure>\n<p>The graph engine scales up to complex multi-part assembles.</p>\n<figure><img src=\"https://www.mattkeeter.com/projects/antimony/3/images/big.png\" alt=\"Kelvin\" loading=\"lazy\" decoding=\"async\" referrerpolicy=\"no-referrer\" /></figure>\n<figure><img src=\"https://www.mattkeeter.com/projects/antimony/3/images/bigger.png\" alt=\"Kelvin\" loading=\"lazy\" decoding=\"async\" referrerpolicy=\"no-referrer\" /></figure>\n<h3 id=\"geometry-engine\">Geometry engine</h3>\n<p>Antimony&#39;s geometry engine uses\n<a href=\"http://en.wikipedia.org/wiki/Function_representation\" rel=\"nofollow ugc noopener\">functional representations</a>\nfor solid modeling.\nThis representation is particularly suitable for modeling with boolean operations\n(union / intersection / difference).</p>\n<figure><img src=\"https://www.mattkeeter.com/projects/antimony/3/images/csg.png\" alt=\"Boolean example\" loading=\"lazy\" decoding=\"async\" referrerpolicy=\"no-referrer\" /></figure>\n<p>In the application, the geometry engine renders shapes as shaded bitmaps.\nThey&#39;re then blitted to a 3D viewport.</p>\n<figure><img src=\"https://www.mattkeeter.com/projects/antimony/3/images/app.png\" alt=\"Application screenshot\" loading=\"lazy\" decoding=\"async\" referrerpolicy=\"no-referrer\" /></figure>\n<p>Antimony can export heightmaps for 2.5D processes and <code>.stl</code> files\nfor 3D manufacturing. The <code>.stl</code> export includes feature detection\nto keep corners and edges sharp.</p>\n<figure><img src=\"https://www.mattkeeter.com/projects/antimony/3/images/export.png\" alt=\"Mesh\" loading=\"lazy\" decoding=\"async\" referrerpolicy=\"no-referrer\" /></figure>\n<h3 id=\"standard-library\">Standard library</h3>\n<p>Antimony&#39;s standard library defines many <a href=\"https://github.com/mkeeter/antimony/blob/develop/py/fab/shapes.py\" rel=\"nofollow ugc noopener\">shapes and transforms</a>,\nfrom basic (rotate, scale, boolean operations) to unusual\n(attract, repel, bend).</p>\n<p>These shapes are used in node definitions, which typically add input\nand output ports and can optionally define UI features.</p>\n<p>Here&#39;s an example of a node that defines UI features:</p>\n<pre><code>import fab\n\ntitle(&#39;Rectangle&#39;)\n\ninput(&#39;xmin&#39;, float)\ninput(&#39;ymin&#39;, float)\ninput(&#39;xmax&#39;, float, 1)\ninput(&#39;ymax&#39;, float, 1)\n\noutput(&#39;shape&#39;, fab.shapes.rectangle(xmin, xmax, ymin, ymax))\n\n# UI\nsb.ui.wireframe([(xmin, ymin, 0), (xmax, ymin, 0),\n                 (xmax, ymax, 0), (xmin, ymax, 0)], close=True)\nsb.ui.point(xmin, ymin, 0)\nsb.ui.point(xmax, ymax, 0)</code></pre>\n<p>In the 3D viewport, the UI features defined at the bottom of the script\nare drawn over the rendering of the rectangle.</p>\n<p>These UI features are hooked back into the graph: dragging\nthe points at the rectangle&#39;s corners pushes changes to the\ngraph node.</p>\n<figure><img src=\"https://www.mattkeeter.com/projects/antimony/3/images/dragging.gif\" alt=\"UI dragging\" loading=\"lazy\" decoding=\"async\" referrerpolicy=\"no-referrer\" /></figure>\n<p><strong>As an aside</strong>: most users will be satisfied with the built-in shapes,\nbut it&#39;s also possible to define custom shapes.</p>\n<p>Shapes are represented with a prefix string syntax that&#39;s easy to\nparse but a bit cryptic to decipher. Here&#39;s the definition for the\ncircle shape used above:</p>\n<pre><code>def circle(x0, y0, r):\n    return Shape(\n            &#39;-r+q-Xf%gq-Yf%gf%g&#39; % (x0, y0, r), # math string\n            x0 - r, y0 - r, x0 + r, y0 + r)     # bounds</code></pre>\n<p>Unpacking and hierarchically indenting the prefix string gives</p>\n<pre><code>-\n  r\n    +\n      q\n        -\n          X\n          f%g\n      q\n        -\n          Y\n          f%g\n  f%g\n% (x, y, r)</code></pre>\n<p>This encodes a distance field representation of a 2D circle:</p>\n<pre><code>f(x,y) = sqrt(pow(x - x0, 2) + pow(y - y0, 2)) - r</code></pre>\n<p>where <code>x0</code>, <code>y0</code>, and <code>r</code> are the circle&#39;s center and radius\n(specified when <code>circle</code> is called).</p>\n<p>The exact mapping from prefix strings to infix functions is left as\nan exercise for the reader (or can be looked up in Appendix A of\n<a href=\"https://www.mattkeeter.com/research/thesis.pdf\" rel=\"nofollow ugc noopener\">my thesis</a>).</p>\n<h2 id=\"download\">download</h2>\n<p>A prebuilt Mac application can be downloaded <a href=\"https://github.com/mkeeter/antimony/releases\" rel=\"nofollow ugc noopener\">from the Github releases page</a>.</p>\n<p>Antimony&#39;s source is <a href=\"https://github.com/mkeeter/antimony\" rel=\"nofollow ugc noopener\">available on Github</a>,\nalong with instructions for <a href=\"https://github.com/mkeeter/antimony/blob/master/BUILDING.md\" rel=\"nofollow ugc noopener\">building it</a>\non Mac and Linux.</p>\n<h2 id=\"development\">development</h2>\n<p>Antimony is a long-running project under <a href=\"https://github.com/mkeeter/antimony/graphs/contributors\" rel=\"nofollow ugc noopener\">active development</a>.</p>\n<figure><img src=\"https://www.mattkeeter.com/projects/antimony/3/images/development.png\" alt=\"Development\" loading=\"lazy\" decoding=\"async\" referrerpolicy=\"no-referrer\" /></figure>\n<p>It&#39;s at a beta level of stability: solid, but not recommended for mission-critical use.</p>\n<p>If you&#39;re interested in contributing, there&#39;s a pretty low bar for entry.\nGiven basic Python knowledge, you can get started making\ncustom nodes (like this <a href=\"https://github.com/mkeeter/antimony/blob/develop/py/nodes/Color/set_color_hsb.node\" rel=\"nofollow ugc noopener\">HSB color node</a>\ncontributed by <a href=\"https://twitter.com/RobotGrrl\" rel=\"nofollow ugc noopener\">RobotGrrl</a> or the\n<a href=\"https://github.com/mkeeter/antimony/commits?author=neilger\" rel=\"nofollow ugc noopener\">plethora of nodes</a> contributed by\n<a href=\"http://ng.cba.mit.edu/\" rel=\"nofollow ugc noopener\">Neil</a>).</p>\n<p>For more ambitious folks with C++ experience, there are a whole host of\nimprovements that could be made, from speeding up rendering to cleaning\nup the UI and optimizing graph evaluation. Send me a note if this\npiques your interest.</p>\n<h2 id=\"history\">history</h2>\n<p>Antimony grew out of my work on powerful personal-scale CAD/CAM workflows\nat the <a href=\"http://cba.mit.edu\" rel=\"nofollow ugc noopener\">MIT Center for Bits and Atoms</a>.</p>\n<p>It&#39;s the latest tool in a line of software that included\n<a href=\"https://www.mattkeeter.com/projects/solver\" rel=\"nofollow ugc noopener\">cad_ui</a> and <a href=\"https://www.mattkeeter.com/projects/kokopelli\" rel=\"nofollow ugc noopener\">kokopelli</a>, and\ndraws inspiration from <a href=\"http://kokompe.cba.mit.edu\" rel=\"nofollow ugc noopener\">fabserver</a>.</p>\n<p>For a historical perspective, there are a set of earlier Antimony writeups:</p>\n<ul><li><a href=\"https://www.mattkeeter.com/projects/antimony/1\" rel=\"nofollow ugc noopener\">Early 2014</a> (developed as a demo for the World Economic Forum)</li><li><a href=\"https://www.mattkeeter.com/projects/antimony/2\" rel=\"nofollow ugc noopener\">Fall 2014</a> (updated for use in How to Make Almost Anything)</li></ul>\n<p>This update coincides with the 2015 edition of <a href=\"http://fabacademy.org/\" rel=\"nofollow ugc noopener\">Fab Academy</a>;\nuse <a href=\"https://www.google.com/search?q=site%3Ahttp%3A%2F%2Ffabacademy.org%2Farchives%2F2015%2F%20antimony&amp;rct=j\" rel=\"nofollow ugc noopener\">this search query</a>\nto see how people are using it.</p>\n<h2 id=\"press-discussion\">press &amp; discussion</h2>\n<ul><li><a href=\"http://hackaday.com/2015/05/29/otherworldy-cad-software-hails-from-a-parallel-universe/\" rel=\"nofollow ugc noopener\">Hackaday write-up</a></li><li><a href=\"https://librearts.org/2015/05/introducing-antimony-node-based-cad-application/\" rel=\"nofollow ugc noopener\">Interview with Libre Graphics World</a></li><li><a href=\"https://news.ycombinator.com/item?id=9623609\" rel=\"nofollow ugc noopener\">Hacker News discussion</a></li></ul>","headings":[{"level":2,"text":"about","id":"about"},{"level":2,"text":"demo","id":"demo"},{"level":2,"text":"foundations","id":"foundations"},{"level":3,"text":"Graph engine","id":"graph-engine"},{"level":3,"text":"Geometry engine","id":"geometry-engine"},{"level":3,"text":"Standard library","id":"standard-library"},{"level":2,"text":"download","id":"download"},{"level":2,"text":"development","id":"development"},{"level":2,"text":"history","id":"history"},{"level":2,"text":"press & discussion","id":"press-discussion"}]}}