USER  →  AI Planner  →  CAD MCP Server  →  Orchestration (Executor / Tx / Recovery)  →  CATIA V5
                                       →  native Sketches / Pads / Shafts / Holes / Fillets / Patterns
                                       →  save → reopen → update → validate

git clone https://github.com/kVeyra/catia-ai
cd catia-ai
pip install -r requirements.txt        # or pip install -e .
# Windows: pip install pywin32

# 1. Inspect environment
python scripts/detect_catia.py
catia-ai --inspect              # same via CLI

# 2. Milestone 1 – block
catia-ai "Create a 100 x 50 x 20 mm rectangular block."
# → output/Block_100x50x20.CATPart

# 3. Shaft (acceptance test)
catia-ai "Create a parametric shaft with: diameter 50 mm, length 300 mm, central bore 20 mm, four mounting holes, and 5 mm fillets."

# 4. Radial engine
catia-ai "Create a 9-cylinder radial engine with 90 mm bore, 100 mm stroke, master connecting rod, 8 articulating rods, cylinders arranged radially around the crankshaft, parametric cooling fins, pistons, crankshaft, and assemble everything."

# 5. Mock tests (work on Linux)
pytest -q

{
  "mcpServers": {
    "catia": {
      "command": "python",
      "args": ["src/mcp/server.py"],
      "cwd": "/path/to/catia-ai"
    }
  }
}

{
  "mcpServers": {
    "catia": {
      "command": "python",
      "args": ["-m", "src.mcp.server"],
      "cwd": "/path/to/catia-ai"
    }
  }
}

# Rule-based offline (default – no LLM needed)
export CATIA_AI_PROVIDER=local

# Ollama
export CATIA_AI_PROVIDER=ollama
export OLLAMA_URL=http://localhost:11434
export OLLAMA_MODEL=llama3

# LM Studio / any OpenAI-compatible
export CATIA_AI_PROVIDER=openai
export OPENAI_BASE_URL=http://localhost:1234/v1
export OPENAI_API_KEY=lm-studio

catia-ai/
├── src/agent/          # planner, specification (semantic IR), reasoning (AI provider)
├── src/catia/          # connection, documents, parameters, sketches, features, assemblies, validation
├── src/orchestration/  # executor, transactions, recovery
├── src/mcp/            # server.py + tools
├── src/knowledge/      # mechanical components/features/assemblies library
├── src/validation/     # geometry & assembly checks
├── scripts/            # detect_catia, test_connection, test_part_creation
├── examples/           # simple_box, shaft, radial_engine.json, conveyor.json
├── tests/              # pytest suite (mock-capable)
├── output/             # CATPart/CATProduct output
└── logs/