What do you want to do?
5 use cases
-
Design a printable case from a plain description
Describe a case or bracket in words and get a CadQuery model you can check and export for printing.
- SOMA
- Software and DevOps
- Intermediate
View prompt
In the SOMA model folder for <model name>, write a CadQuery model for <part description> in the model file, then run `soma build` to rebuild it. Report the final overall dimensions in millimeters and confirm the build finishes without errors.
-
Make a model's dimensions adjustable without code
Have the agent expose key values as parameters so you can change a size without touching the code.
- SOMA
- Software and DevOps
- Beginner
View prompt
In the SOMA model folder for <model name>, make the values <dimension list> in the model file into adjustable parameters, run `soma build`, and confirm that the build succeeds. Verify that each parameter is listed in SOMA and that changing one value changes the model size.
-
Check a part for overhangs and thin walls
Run the analysis tools on a model to find overhangs, thin walls and weak spots before printing.
- SOMA
- Software and DevOps
- Intermediate
View prompt
In the SOMA model folder for <model name>, run `soma analyze` on the model and list every overhang and wall thinner than <minimum wall thickness> millimeters. Propose code changes for each issue, then run `soma build` and confirm the build still succeeds.
-
Render a moving mechanism as a video
Describe a motion in Python and render the animation of a model to video.
- SOMA
- Software and DevOps
- Intermediate
View prompt
In the SOMA model folder for <model name>, write an animation in Python that moves <part name> through <motion description>, then run `soma render` to produce a video. Report the output file path and confirm the rendered video shows the expected motion.
-
Move an existing CadQuery script into SOMA
Open a CadQuery script in SOMA, let the agent extend it, and export it back as a script.
- SOMA
- Software and DevOps
- Advanced
View prompt
In the SOMA model folder for <model name>, import the CadQuery script at <script path> into the model, make the change <change description>, run `soma build`, and report whether the build succeeds. Verify that the exported script still produces the same part geometry.
How to use SOMA
- Check you have what it needs: Windows, Linux, or macOS (Apple Silicon) with a SOMA package downloaded from somacad.app/download or the releases page; A CLI agent such as Claude Code, OpenCode, Codex CLI or Gemini CLI, installed and logged in by you; About 1 GB of free disk space for the installed app.
- Open Kai-Jungsthoefel/SOMA on GitHub and read the README and license.
- Download the SOMA package for your system from somacad.app/download and install it.
- Install and log in to a CLI agent such as Claude Code, Codex CLI or Gemini CLI.
- Start SOMA, click New model, then start your agent with the + above the terminal.
- Describe the part, its size and the printing material, then click parts or measure in the view and send feedback to the agent.
These steps come from our top use case, Design a printable case from a plain description, which also has a copy-paste agent prompt.
Get 5 new use cases every morning. Free, one short email, unsubscribe anytime.
Get them freeAbout this repo
- Who it is forMakers and tinkerers who need a case, bracket or mount for a project, and developers who want an agent to write CadQuery models.
- Why it is hot
- LanguageTypeScript
- Sourcegithub.com/Kai-Jungsthoefel/SOMA · Back to Hot repos
Requirements
- Windows, Linux, or macOS (Apple Silicon) with a SOMA package downloaded from somacad.app/download or the releases page
- A CLI agent such as Claude Code, OpenCode, Codex CLI or Gemini CLI, installed and logged in by you
- About 1 GB of free disk space for the installed app
Maintain SOMA? Add the Featured on Deduped badge
Paste this into your README:
[](https://dedupedai.com/use-cases/kai-jungsthoefel-soma/?ref=badge)
Questions about SOMA
What is SOMA?
SOMA is a desktop app for designing parametric 3D models in CadQuery Python code, built together with a CLI coding agent of your choice. It is an open-source project on GitHub: https://github.com/Kai-Jungsthoefel/SOMA.
Who is SOMA for?
Makers and tinkerers who need a case, bracket or mount for a project, and developers who want an agent to write CadQuery models.
What can I do with SOMA?
5 use cases so far, for example: Design a printable case from a plain description; Make a model's dimensions adjustable without code; Check a part for overhangs and thin walls. Each has steps and a copy-paste agent prompt.
What do I need to run SOMA?
Windows, Linux, or macOS (Apple Silicon) with a SOMA package downloaded from somacad.app/download or the releases page; A CLI agent such as Claude Code, OpenCode, Codex CLI or Gemini CLI, installed and logged in by you; About 1 GB of free disk space for the installed app.
What are alternatives to SOMA?
Other hot AI repos in Software and DevOps: Harness2, iFixAi, Orca, Diagram Design, AI Memory.
Is SOMA safe to run?
Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.