[WIP] Agentic-Hypnotoad: AI agent that generates meshes

[bendudson]

Plug Hypnotoad into your favorite LLM. What could possibly go wrong?

from hypnotoad import agent

geqdsk_file = "/path/to/geqdsk.file"
ENDPOINT_URL = "https://llm.server/v1"
API_KEY = "abdefghijklmnopqrstuvwxyz"
MODEL = "gpt-5-mini"

hypnotoad_agent = agent.HypnotoadAgent(geqdsk_file, base_url=ENDPOINT_URL,
                                           api_key=API_KEY, model=MODEL)

Console / script interface:

hypnotoad_agent.chat("Generate a mesh, adjusting settings until a mesh is successfully generated.")

Jupyter notebook wrapper for nicer output:

hypnotoad_agent.chat_nb("Generate a mesh, adjusting settings until a mesh is successfully generated.")

Plot last mesh:

hypnotoad_agent.plot_last_mesh()

• Tests added
• Updated manual
• Updated doc/whats-new.md with a summary of the changes