Molecular modeling often involves repetitive tasks that can consume precious time. Whether it’s selecting specific nodes, running Python scripts, or generating complex visualizations, these operations can disrupt your flow. Enter SAMSON AI Commands, a versatile feature within the SAMSON molecular design platform built to streamline your modeling workflows using natural language commands. In this blog post, we’ll explore how you can leverage these commands to save time and increase efficiency in your molecular modeling projects.
What Can SAMSON AI Commands Do?
SAMSON AI provides tailored commands for executing a variety of tasks. Commands can be typed directly into the AI Assistant’s input field, making them incredibly accessible. Here’s a breakdown of the key commands available:
/do: Execute actions, such as selecting specific areas in your model or adjusting visual properties./script: Generate Python scripts that interact with the molecular design environment using SAMSON’s Python API./select: Select nodes using natural language queries, with automatic execution of the underlying Node Specification Language (NSL)./learn: Ingest data from web links or PDFs, allowing the AI to incorporate new knowledge into your workflow./refer: Query the AI about learned information for quick answers./forget: Remove all previously learned information to reset the AI’s knowledge space.
To see the full list of commands, just type / in the Assistant’s input field, and a list of available commands will appear. Here’s an example of what it looks like:

How to Use the /do Command
The /do command is exceptionally useful for executing specific actions within your molecular model. Instead of navigating through multiple menus, you can simply type a request and let SAMSON AI handle the operation. For instance:
/do zoom to the binding site./do select the ligand and apply a licorice model./do erase all surfaces./do select the gaussian surface and make it light blue.
These examples give a glimpse into the flexibility of the command. Whether you need to refine a visualization, target a specific region of your model, or reset specific elements, /do has you covered. If you prefer voice interaction, you can even speak the command (be sure to enable audio).
SAMSON AI’s use of retrieval-augmented agency (RAA) ensures that it combines its knowledge base with actions specific to your project, empowering dynamic operations that significantly minimize manual work.
Generating Python Scripts with /script
For those who want deeper customization, the /script command enables script generation using SAMSON’s Python API. By combining this with additional Python modules, you can perform high-level tasks like machine learning analyses or trajectory studies. Here are some examples:
/script select all atoms and translate them in the z direction by 1 angstrom./script create a GUI that lets me enter a distance in angstrom, with a 'Move' button./script compute the gyration radius of the receptor.
Rather than writing detailed code from scratch, let SAMSON AI help you kickstart your scripting efforts. By delegating the initial code generation to the AI, you can focus more on analysis and refinement.
Limitations to Keep in Mind
While SAMSON AI commands are powerful, it’s important to use them with an understanding of their limitations:
- The AI’s knowledge may not encompass recent developments or highly specific cases.
- Ambiguities in input can lead to incomplete or less accurate responses. Clear and concise queries deliver better results.
- Generated outputs or actions might require manual validation, especially for critical operations.
By staying aware of these constraints and verifying results as needed, you can maximize your productivity while maintaining confidence in your work.
Conclusion
SAMSON AI Commands offer a modern approach to simplifying repetitive or complex molecular modeling tasks. The ability to leverage natural language input makes the platform intuitive, even for new users, while the flexibility to use script-based solutions caters to advanced workflows. To explore the full functionality of SAMSON AI, refer to the official documentation at this link.
Note: SAMSON and all SAMSON Extensions are free for non-commercial use. You can download SAMSON via this link.
