Skip to content

Introduction to Satori

Satori is an API-powered platform for secure information enclaves. It provides intelligent file chat, seamless document generation, and powerful knowledge management capabilities. This guide will help you understand the core concepts of Satori.

Try the Demo

Before diving into the details, you can explore Satori through our demo project:

https://web-demo.satorivault.com/

Note: The demo requires a Satori account. To get started, either:

  • Self-onboard through the Satori Portal to create your account, or
  • Contact your Tryal Accelerator site administrator to request direct Satori access

Once you have an account, the demo allows you to see basic usage of the system and add your own API keys to test your setup.

Core Concepts

Tenants

A tenant represents your organization account. You have one tenant that:

  • Contains all your enclaves (workspaces)
  • Has API tokens for authentication
  • Maintains complete data isolation from other users

Create your account through the Satori Portal to get your tenant ID and API tokens. Alternatively, contact your Satori administrator for direct access.

Information Enclaves

An information enclave is an isolated workspace within your tenant for secure document processing and intelligent file chat. Think of it as a project or domain-specific container where your information is securely stored and processed.

Each enclave has:

  • Its own vector collection for semantic search
  • Isolated file storage and processing pipeline
  • Custom settings and configuration
  • Independent query and search context
  • Secure boundaries for your information

Example Use Cases:

  • One enclave per project or client
  • Separate enclaves for different document types (legal, medical, technical)
  • Different research projects in separate enclaves
  • Organizing documents by department or team

Files

Files are documents uploaded to an enclave. Satori supports:

  • Documents: PDF, Word, Excel, PowerPoint, text files
  • Images: JPEG, PNG, GIF, WebP, SVG, TIFF, BMP
  • Video: MP4, MPEG, AVI, MOV, WMV, WebM, MKV, FLV (with transcription)
  • Audio: MP3, WAV, OGG, M4A, AAC, MIDI (with transcription)
  • Archives: ZIP, RAR, 7Z, TAR, GZIP

Files go through a processing pipeline:

  1. Upload → Validation
  2. Processing → Content extraction
  3. Vector embeddings → Semantic search preparation
  4. Ready → Available for queries

Tokens

Tokens are API keys used for authentication. Each token:

  • Belongs to a specific tenant
  • Can be scoped to specific operations
  • Can have expiration dates
  • Uses JWT format for secure authentication

How It Works

Intelligent File Chat

Satori's intelligent file chat enables you to have natural conversations with your documents:

  1. Upload Files: Securely upload documents to your information enclave
  2. Processing: Content is extracted and made searchable (text from PDFs, OCR from images, transcription from audio/video)
  3. Ask Questions: Use natural language to query your documents
  4. Get Intelligent Answers: Receive accurate, context-aware responses with source citations

Seamless Document Generation

Satori provides seamless document generation and text processing:

  • Summarization: Condense long documents into key points
  • Expansion: Add detail and context to brief text
  • Improvement: Enhance writing quality and clarity
  • Custom Processing: Apply your own instructions to transform text

All powered by Satori's API, enabling seamless integration into your workflows.

API Overview

Satori's powerful API is organized around secure information enclaves:

  • Enclave Endpoints (/api/tenants/{tenant_id}/enclaves/{enclave_id}/*): Work with documents in your information enclaves
  • Tenant Endpoints (/api/tenants/{tenant_id}/*): Manage your organization's resources
  • Admin Endpoints (/api/admin/*): Administrative operations (requires master key)

Key API Capabilities

  • Information Enclaves: Create and manage secure workspaces for your documents
  • Intelligent File Chat: Query and chat with your documents using natural language
  • File Management: Upload and process documents (PDFs, images, videos, audio)
  • Document Generation: Seamless text processing (summarize, expand, improve, etc.)
  • Tokens: Generate API keys for authentication
  • Search: Semantic search across your document collection

For complete API documentation, see the Interactive API Reference.

Authentication

Satori uses JWT (JSON Web Tokens) for secure API authentication:

  1. Get a token: Create an API token through the Satori Portal or via API
  2. Include in requests: Add the token to every API request: Authorization: Bearer <your-jwt-token>
  3. Automatic validation: Your token is validated on every request
  4. Secure access: Tokens are scoped to your tenant, ensuring data isolation

See the Authentication Guide for detailed information about token management.

Secure Information Enclaves

Satori ensures your information is secure and isolated through API-powered enclaves:

  • Tenant-level: Your organization's data is completely separate from other users
  • Enclave-level: You can create separate secure information enclaves for different projects or clients within your tenant
  • Token-level: Each API token only has access to your tenant's data

This multi-level isolation ensures that your documents, queries, and data remain private and secure within your information enclaves.

Next Steps

Now that you understand the core concepts: