Guide

Add Memory via File Upload

Overview

Hyperspell's Sandbox feature allows you to test and develop AI applications with your own data by uploading memory files. Memory files serve as a knowledge base or context that your AI models can reference during interactions. By uploading a file through the Sandbox, you can quickly populate your application with structured data—such as customer lists, product catalogs, or documentation—without manual entry. This is essential for setting up a working environment before deploying to production.

Before you begin

  • An active Hyperspell account with access to app.hyperspell.com
  • A CSV or supported memory file prepared and saved locally (e.g., companies-list.csv)
  • Permission to access the Sandbox feature within your Hyperspell account

Step by step

1
ClickSandbox

Select the Sandbox environment by clicking on the Sandbox option. The Sandbox is where you test and develop AI applications with your own data in an isolated, non-production setting.

Tip. The Sandbox is ideal for development and testing before deploying to a live environment. You can safely experiment with different files and configurations here.
Step 1
2
ClickUpload File

Click on the Upload File tab to access the file upload interface. This tab switches your view to the file upload panel where you can select and prepare your memory file.

Tip. The Upload File tab is typically located alongside other configuration options in the Sandbox. If you see multiple tabs, ensure you're on the Upload File tab specifically.
Step 2
3
upload

Select and upload your memory file (companies-list.csv in this example) by clicking the upload field and choosing the file from your local system. This file will be sent to Hyperspell's index and processed to create a resource that your AI can reference.

Tip. Most common formats (CSV, JSON, TXT) are supported. For best results, ensure your file is well-formatted and contains clean, structured data. Larger files may take longer to process.
4
ClickUpload Memory

Click the Upload Memory button to finalize and submit your file for processing. Hyperspell will process the file, assign it a resource_id, and make it available for use in your Sandbox application.

Tip. After clicking Upload Memory, allow a few seconds for the file to be processed. You can monitor progress or check the resource_id in your Sandbox dashboard.
Step 4

Confirm it worked

  1. 1The Sandbox option is selected in the interface and visible in the current context
  2. 2The Upload File tab is displayed and active, ready to accept file input
  3. 3The file (companies-list.csv) appears in the upload field or file picker
  4. 4An Upload Memory button is present and clickable, and upon clicking it, you receive confirmation that the file has been successfully processed and assigned a resource_id

Common issues

Keep reading