Skip to content

Chat / AI assistant

NumaSim has a built-in chat panel that can read your circuit, propose edits, and explain what's going on. It's powered by a language model and uses the same tool surface the app does — every edit it suggests goes through the same validation as your own clicks.

Opening the chat

Click the chat icon in the toolbar (or use View > Chat). A panel opens on the right with a message box and a transcript.

What you can ask

Anything you'd reasonably type to a knowledgeable lab partner:

  • "Add a 1 µF capacitor across R2." — the assistant proposes the edit; you click Apply to commit it.
  • "What does this circuit do?" — it summarizes the schematic.
  • "Why is v_mid flat?" — it inspects the latest run and explains.
  • "Convert this to use a Subsystem with N=10 around the switching block." — it refactors and explains the change.

How it works

The chat doesn't directly mutate your canvas. Instead it:

  1. Reads a compact description of your circuit (signals, components, wires).
  2. Proposes a diff using the same operation primitives the GUI uses (addComponent, wirePorts, setParameter, ...).
  3. Shows you the proposed diff. You can accept, reject, or refine.

This means every assistant edit is reviewable and reversible — the undo/redo history tracks it just like a manual edit.

Privacy

The chat needs to send your circuit description to the model provider to answer. Sensitive circuits should not be shared with the chat. See the app settings for which provider is configured.

Configuring a provider

Open the settings dialog and pick a model provider (OpenAI, an OpenAI-compatible endpoint, or a local model). The chat is disabled until a provider is configured.

See also

Released under the MIT License.