Skip to main content

Systems Guide

After uploading files to Istari Digital, you can use Systems to organize your work, collaborate with teammates, and manage multi-model versioning.


Creating a System

1. Open the Systems Panel

From the home screen, navigate to All Systems in the left sidebar and click Create System.

All Systems


2. Name Your System

Give your system a name and description. A system serves as a namespace for grouping related models and artifacts. When ready, click Next: Add Config.

Create System


3. Add Your First Configuration

Provide a name for your configuration and add any models or artifacts to include. By default, these files will be tracked, meaning the system will always pull their latest revisions.

Add Files


4. Pin Specific Revisions (Optional)

To lock a file to a specific revision, toggle the tracking setting to specific, and select the desired version. You can update this setting anytime.

Add Files Pinned


5. Review Your System

After clicking Create System, you'll land on the system overview page. Here, you'll see:

  • A list of tracked files, with icons indicating whether each is pinned.
  • Controls for managing Snapshots and Snapshot Tags.

Systems Landing Page

When you create a system, Istari automatically takes an initial snapshot — an immutable record of the current file revisions. If tracked files set to "latest" receive updates, new snapshots can be taken to capture those changes.


6. Upload a New File Revision

Try uploading a new revision of a file set to "latest" in your system. The system will detect the change and offer the option to take a new snapshot.

New Snapshot

Click the button to capture the updated state.

New Snapshot Dropdown


7. Manage Snapshots and Tags

Now that you have multiple snapshots, you can navigate between them and manage Snapshot Tags.

Snapshot tags let you:

  • Mark and communicate validated states
  • Share snapshots easily
  • Mark specific states of the system

Every system starts with a baseline tag (assigned to the first snapshot). This tag is required and cannot be removed, but it can be moved.

Use Manage System Snapshot Tags to add, remove, or move tags.

Manage Tags


8. View System Diffs

Compare two snapshots by clicking View System Diff in the top right.

View a diff

Select a base and a target snapshot. Changes will be displayed directionally.

For example, you might see that an image file was renamed or updated:

Diff Image

Unchanged files will be marked as identical:

Diff Identical


9. Share Your System

To collaborate, click Share System and assign roles (Viewer, Editor, Administrator) to other users.

Note: Sharing a system does not override file-level permissions. Users without access to individual files will see limited information:

No Access

This ensures secure, fine-grained access control within collaborative environments.


Congrats - you've built your first system!