terraquery.ai
Section 03

Assets

The Assets page lists every file in a project and lets you upload, process, download and delete files.

The Assets page showing a GeoJSON file marked ready and an orthomosaic TIFF marked uploaded, with an Analyze button
The Assets page — files are grouped by type. Note the ready / uploaded status badges and the purple Analyze button, top-right.

Upload files

Supported formats:

FormatExtensionUse
GeoJSON.geojson, .jsonVector annotations — enables chat & search
Shapefile.zipAuto-converted to GeoJSON on upload
Orthomosaic.tif, .tiffRaster imagery — rendered on the map
Image.png, .jpg, .jpegRaster imagery

Steps:

  1. Click Upload files (top-right of the Assets page).
  2. Drag files onto the drop zone, or click to browse.
  3. Progress is shown per file. Wait for all files to show done.
  4. Click Done to close the upload modal.

Files upload directly to object storage — large TIFFs (multi-GB) are supported. The API server is not a bottleneck.

Process a GeoJSON (embedding pipeline)

Before you can chat about a GeoJSON file, it must be processed. Unprocessed files show status uploaded.

  1. Find the GeoJSON file in the list. It shows a Process button.
  2. Click Process — a modal opens showing live pipeline logs.
  3. The pipeline runs through: Detecting domain → Chunking features → Embedding chunks → Loading into DB.
  4. When the status shows Complete, close the modal.

The file status changes to ready (green). You can now query it in chat.

Re-processing is possible at any time by clicking Process again on an error or uploaded file.

Analyze a project (shortcut)

The Analyze button (purple, top-right) is a one-click shortcut that:

Use this when you just uploaded a fresh set of files and want to jump straight to analysis.

Download a file

Every file in the list has a download icon (↓) to the right of its action buttons. Click it to download the original file directly from storage.

Delete a file

Click the trash icon next to a file. A confirmation modal appears.

File statuses

StatusMeaning
uploadedFile is in storage but not yet processed
processingEmbedding pipeline is currently running
readyProcessed and available for chat queries
errorPipeline failed — click Process to retry