Skip to main content

Workshop

Accessing the Workshop​

Open the Workshop in your browser at https://workshop.kotharcomputing.com. For quicker access you can install it as a standalone application:

  • Google Chrome / Microsoft Edge (desktop): open the site, select the three-dot menu, choose Save and share → Install site (Chrome) or Apps → Install this site as an app (Edge), then follow the prompts.
  • Safari on macOS: open the site, choose File → Add to Dock…, confirm the name, and click Add.
  • Firefox (desktop): open the site, select the three-line menu, choose More tools → Install site as app.

Each installed app launches in its own window and keeps you signed in using the browser profile that created it.

Layout Overview​

The Workshop arranges tools across five coordinated areas:

  • Main Area hosts editors, viewers, and simulators inside tabbed panes. Tabs can be dragged to reorganize content, and the view can be split for side-by-side comparison.
  • Primary Sidebar sits on the left and surfaces views you reference frequently while developing a project.
  • Panel spans the bottom of the window and provides extra room for traces, logs, or output inspectors without leaving the Main Area.
  • Activity Bar runs along the top, giving you access to layout shortcuts, commands, and documentation.
  • Status Bar at the bottom reports the current Workshop, API, and Aleph versions detected in your session.

You can resize the Primary Sidebar and Panel by dragging their edges. The Workshop remembers open views and pane sizes in your browser, restoring them on the next visit. Use the Reset layout command at any time to return to the default arrangement.

Essential Views​

  • Source code editor: delivers syntax highlighting and inline diagnostics for Aleph and supporting formats. Changes are preserved locally as you type. Unsaved edits show a blue dot next to the filename and persist even if you refresh the page by mistake.

  • Files: browse and manage every asset in your workspace from a single tree. Source code, notebooks, generated datasets, and supporting media share version history, sync across browser sessions once you save, and support drag-and-drop upload or download for offline review. The Files view understands the HDF5 data model and file format maintained by the HDF Group, so you can upload existing HDF5 data or generate it directly from scripts running inside the Forge.

  • Search: locate symbols or text across your files.

  • File viewer: open supported formats—including HDF5 datasets—in the Main Area to inspect contents. Built-in visualization widgets help you explore tables, scalar fields, and multidimensional arrays without leaving the browser.

  • Jobs: review a catalog of past and active jobs, including status, and the agents assigned to them.

  • Job viewer: drill into an individual job to study execution metadata and captured logs.

  • Agents: check which agents are connected to your workspace, their resource capacities, and any workloads they are currently executing (Executions, Jobs, and more).

  • Output: follow the live stream of direct script executions. Each run appears as its own session, selectable from a dropdown in the Panel so you can compare results.

Typical Workflow​

  1. Author Aleph programs or supporting assets inside the Files view using the editors.
  2. Connect one or more agents to make compute resources available to your workspace.
  3. Choose an agent and run the active file to validate a hypothesis or test work in progress.
  4. Promote a trusted script to a scheduled job, targeting an appropriate agent, and collect the resulting artifacts.
  5. Open generated datasets—including HDF5 outputs—in the viewer to analyze results, visualize trends, and confirm the model.
  6. Download final job outputs and associated files locally when you need to post-process them outside the Forge.

Tips for Working Efficiently​

  • Context menus: right-click in trees, editors, or tabs to access advanced or less frequently used options.
  • Keyboard shortcuts: common actions display their shortcuts in tooltips. Review the full list via the keyboard icon in the Activity Bar’s top-right corner.
  • Command menu: open the command bar from the Activity Bar’s sparkle icon or press Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (macOS), then start typing an action such as Reset layout, Run on agent, or Open data viewer. Commands let you trigger functionality without leaving the keyboard.
  • User account: click your avatar in the lower-left corner to update profile details, monitor active sessions, review subscription information, and check storage usage for the current workspace.