ido-agent 0.1.11

Requires Python 3.11+ and your own OpenAI-compatible API key.

pipx install ido-agent
ido

On first run, idō prompts for your API key, validates it with a tiny real API request, saves it in your user config directory, then starts the terminal CAD agent. Future runs use the saved local key:

ido

Useful setup commands:

ido login
ido login --provider openai --model gpt-4o-mini
ido login --provider openrouter --base-url https://openrouter.ai/api/v1 --model <model>
ido doctor --api
ido config
ido config set model <model>
ido logout

Credentials are stored outside the repo with platformdirs, for example ~/Library/Application Support/ido/config.json on macOS. ido config only prints a masked key.

cd adapters/blender
zip -r ../../ido_blender.zip ido_blender
cd ../..

ido serve

In Blender:

1. Open Edit -> Preferences -> Add-ons
2. Install ido_blender.zip
3. Press N in the 3D View
4. Open the idō tab
5. Use http://127.0.0.1:8010 as the backend

Prompt from the CLI:

ido prompt --tool blender "make a small cabin"

Install OpenSCAD and make sure openscad is on your PATH

ido open openscad
ido prompt --tool openscad "make a bracket with two mounting holes"

Outputs are written to your user data directory, for example ~/Library/Application Support/ido/projects/default on macOS.

ido                 # terminal OpenSCAD CAD agent
ido login           # replace the saved local API key
ido logout          # delete the saved local API key
ido doctor --api    # real minimal API validation
ido config          # show config path, provider, model, masked key
ido serve           # run the API
ido status          # check runtime status
ido reset           # clear generated files