OpenTraceOpentraceDocs
Dashboard
DocsUser GuideUploading Documents

Uploading Documents

Build your knowledge base by uploading files to a project. Opentrace supports multiple file formats and provides a seamless upload experience.

Supported Formats

FormatExtensionNotes
PDF.pdfSupported including scanned PDFs via OCR
Word Document.docxMicrosoft Word format
HTML.html, .htmStatic HTML files

How to Upload

1
Open the Knowledge Base

Navigate to your project and click the Knowledge Base tab to see the documents panel.

2
Drag and drop or browse

You have two options:

  • Drag and drop — drag files directly onto the upload area
  • Click to browse — click the upload zone to open your system's file picker
3
Wait for processing

After upload, the file is sent to S3 via a presigned URL and queued for processing. Watch the status badge as it progresses through the pipeline stages.

Upload Flow (Behind the Scenes)

  1. The frontend requests a presigned S3 URL from the backend
  2. The file is uploaded directly to S3 from the browser (fast, no server bandwidth)
  3. The frontend confirms the upload, which triggers a Celery task
  4. The backend downloads the file from S3 and runs the ingestion pipeline
  5. Status updates are written to the database after each stage
  6. The frontend polls for status every 2 seconds during processing
Tip

You can upload multiple files at once — each will be processed independently as a separate Celery task.

Warning

Very large files (100+ pages) may take several minutes to process due to partitioning and embedding steps. The status indicator will keep you informed of progress.

Was this page helpful?
PreviousManaging Projects