AI assistant¶
EasyDiffraction is ready for AI assistants. The desktop app has an assistant built in, which works in your open project. ChatGPT or Claude, in their desktop apps or command-line tools, can write a notebook or a project for you from your own files: a structure and a measured pattern become a fit set up in stages, which you then run, check and change.
| Where | Built-in assistant | Your own assistant | Notes |
|---|---|---|---|
| Desktop app | The built-in assistant is an optional part of the desktop app and needs a ChatGPT account. | ||
| Web app | The browser has no built-in assistant; open the project your own assistant writes. | ||
| Python | Your own assistant writes a Jupyter notebook ready to run. | ||
| Command line | Your own assistant writes a project ready for edi fit. |
Built-in assistant (desktop app)¶
The desktop app's assistant can explain a fit, suggest which parameters to fit next, and carry out supported actions in your open project. The Fit with the AI assistant tutorial follows one run.
The assistant after it fitted La₀.₅Ba₀.₅CoO₃ on HRPT (the tutorial).
Install and connect¶
- Select AI assistant in the desktop installer. To add it to an existing installation, open Preferences → Updates → Open Maintenance Tool and add AI assistant, then restart the application.
- Open a project workflow page and select the robot button in the toolbar.
- Select Connect ChatGPT and complete the OpenAI sign-in if prompted. The assistant needs an internet connection and a ChatGPT account with access to a compatible Codex model.
The assistant uses your ChatGPT plan’s Codex allowance. Model access and usage limits depend on the plan and workspace settings. OpenAI offers limited Codex access on some free accounts. Your account’s model access determines whether you need a paid subscription. OpenAI plans and usage limits
In the web app the robot button opens a note about the desktop app instead: the browser has no built-in assistant.
Work with your project¶
Ask a question about the open project or describe the result you want. For example, ask which parameters to fit first and why, or ask the assistant to fit the background and inspect the residual before fitting the peak profile.
When EasyDiffraction asks for approval to share project information or attached files, review the selection before continuing. Use Stop to interrupt ongoing work.
Inspect the resulting pattern and fitted parameters before relying on the result. The fit quality guide explains how to assess a fit.
Show actions¶
Show actions, in the chat's composer, shows each action the assistant takes in the app as it works, on the control it uses. Off, the assistant works in the background and reports in the chat.
Your own assistant¶
ChatGPT or Claude, in their desktop apps or command-line tools, can write what each interface uses, given the documentation, the tutorials and your files:
- a Jupyter notebook ready to run: the Python AI assistant tutorial;
- a project to fit with
edi fit: the Command line AI assistant tutorial; - a project to open in the desktop or web app, as an alternative to the built-in assistant or in its place: the same Command line prompt.
Open a project it returns in the app:
On Project, choose Open project…, then Folder and select the project folder. You can also drop the folder or its project.edi file onto the window.
On Project, choose Open project…, then Folder, or zip the project folder first and choose Zip archive. Where the project is kept afterwards depends on the browser; see Open and save files.