Delete Model

Overview

Flow ID: delete-model
Category: Model Management
Estimated Duration: < 10 seconds
User Role: Admin
Complexity: Simple

Purpose: Remove large model files (often 5-20GB) to free up disk space.

Trigger

What initiates this flow:

• User manually initiates

Specific trigger: Trash Icon in the Chat Models or Embedding Models list.

Step-by-Step Flow

Main Path (Happy Path)

Step 1: Locate Model

• User Action: Go to Settings. Find model.

Step 2: Delete

• User Action: Click Trash Icon.

Step 3: Confirm

• System Response: “Delete [ModelName]? This cannot be undone.”
• User Action: Confirm.

Step 4: Cleanup

• System Response:
  • File deleted from disk.
  • Entry removed from DB.
  • Space reclaimed immediately.

Error States & Recovery

Error 1: Model is Active

Cause: Trying to delete the currently loaded model.
User Experience: “Cannot delete active model.”
Recovery: Select another model first.

Related Flows

• LLM Model Upload

Technical References

• src/handlers/file-system.js (unlink)