SOMA

Name: SOMA
Author: Kai-Jungsthoefel

Pending

Desktop app for designing parametric 3D models in CadQuery together with the coding agent of your choice

72stars

3forks

TypeScript

Installation

# Add to your Claude Code skills
git clone https://github.com/Kai-Jungsthoefel/SOMA

Getting Started

Guides for using ai agents skills like SOMA.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Compare with similar skills

See how SOMA compares with popular alternatives.

SOMA vs hermes agent

See comparison

SOMA vs rea

See comparison

SOMA vs ecc

See comparison

README.md

Frequently Asked Questions

What is SOMA?

SOMA is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by Kai-Jungsthoefel. Desktop app for designing parametric 3D models in CadQuery together with the coding agent of your choice. It has 72 GitHub stars.

Is SOMA safe to use?

SOMA's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.

How do I install SOMA?

Clone the repository with "git clone https://github.com/Kai-Jungsthoefel/SOMA" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is SOMA written in?

SOMA is primarily written in TypeScript. It is open-source under Kai-Jungsthoefel on GitHub, so you can review or fork the full source.

Are there alternatives to SOMA?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh SOMA against similar tools.

AI Courses · Agentic AI, LLM Engineering & MCP

Beginner to professional · First lesson free · Lifetime access

20% off

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

ECC

by affaan-m

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

279,703

OrcaPromptVault brainoutside

SOMA

Solid Object Modeling with Agents. A desktop app for designing parametric 3D models together with a coding agent.

https://github.com/user-attachments/assets/3294d1e4-1f06-477d-9770-c91f3470330d

You tell the agent what you need. It writes the model as Python code with CadQuery, SOMA builds it and shows the result. You look at it, measure it, point at what is wrong, and the agent changes the code.

What it is

It's vibe coding, but for CAD. Made for makers and tinkerers who need a case, a bracket or a mount for their project and don't want to spend hours in a CAD program to get it. Describe or sketch the part, check the result, export it, print it. You don't have to know CadQuery. The code is there if you want to change a dimension yourself.

SOMA is not an agent of its own. Any CLI agent that can read files and run commands works: Claude Code, OpenCode, Codex CLI, Gemini CLI or whatever comes next. It runs in a normal terminal inside the model folder, SOMA detects the common ones and can start them. You install and log in to them yourself, so your subscription, your model choice and your permission settings stay yours. SOMA gives the agent a command line tool (soma build, soma analyze, soma render …) and an AGENTS.md with the rules of the project.

Install

Download the package for your system from the releases: an installer for Windows, an AppImage or tar.gz for Linux, a dmg for macOS (Apple Silicon). Python, CadQuery, Git and CalculiX are included.

You need a CLI agent installed and logged in, for example Claude Code, OpenCode, Codex CLI or Gemini CLI. SOMA does not bring one
The installed app takes over 1 GB of disk space, most of it for Python, CadQuery and OpenCascade
The packages are not signed yet. On Windows, SmartScreen warns on the first start ("More info" > "Run anyway"). On macOS, open the app the first time with right-click > Open
Linux needs glibc 2.31 or newer
There is no automatic update. Download a new version from the releases page

Quick start

Start SOMA and click New model on the start page. It starts from a small example, a box with a lid.
Start your agent with the + above the terminal on the right. SOMA lists the agents it found on your computer.
Tell the agent what you need, for example "A case for a Raspberry Pi 5 with vents in the lid, printed in PETG". SOMA builds the model on every change and shows it.
Click parts, measure, or draw on the view and send it to the agent until it fits. Then export it from the menu, for example as STL or 3MF.

Press F1 in the app for a short guide with numbered screenshots. The agent knows the same guide, so you can also just ask it how something works.

Features

Models as code: Python with CadQuery, rebuilt on every change
One file per model: a .soma file holds code, result and history, like a CAD file
Point, measure, draw: click a part, measure exactly or sketch on the view, and send it to the agent
Parameters: change the values the agent made adjustable, without touching the code
History: every step of the agent on a timeline, preview and restore old states
Skills: rule sets for the agent, such as 3D printing, CNC, laser cutting, sheet metal and tolerances, switched on per model. Edit them or add your own
Analysis and animation: overhangs, wall thickness, strength with FEM, animations as video
Export: STEP, STL, 3MF, DXF and more, technical drawings as PDF

Screenshots

Explode: take your assembly apart. SOMA works out in which direction each part comes off.

Exploded view of the rover

Animate: bring your models to life. Animations are created by your agent and rendered to video.

Animation of a Strandbeest with its steps and the playback bar

Draw: technical drawings from the model. The agent writes them in Python, with views, sections and dimensions measured on the model, as PDF and DXF.

Technical drawing of a wardrobe next to the 3D model

Status

Early prototype, version 0.8.0. See CHANGELOG.md.

Developed and mainly tested on Windows. The packages also run on Linux (Kubuntu) and macOS (Apple Silicon), but have seen much less use there
Mostly tested with Claude Code and Claude Opus 5.5 as the agent's model, with very good results. Other agents and models work too
File formats and the soma API may still change between 0.x versions

Note: SOMA itself is vibe coded. Most of the code was written by coding agents (mainly Claude Code) under human direction and review. It has tests, but expect rough edges.

Feedback

Bug reports, ideas and experiences with different agents are very welcome as issues. Pull requests are not accepted for now, see CONTRIBUTING.md.

Running from source

For development. The setup script is for Windows only. Requirements: Windows, Node.js 22, Python 3.12 and uv.

powershell -File python/scripts/setup_env.ps1
cd app
npm install
npm start

License

SOMA is free software under the GNU General Public License v3.0 or any later version. You can use, change and share it. If you distribute a changed version, its source code has to be open under the same license.

What you design with SOMA is yours. The SOMA Model Exception lets you license your model files under any terms you like, even though they import soma. Exported files like STEP or STL are not affected by the GPL at all.

Third-party components keep their own licenses, see THIRD_PARTY_NOTICES.md.