Trilogy Ecosystem
Sovereign storage engine

Your files.
Your server.

Upload, search, tag, organize, stream, and AI-analyze any file. Self-hosted, zero cloud dependency. The storage spine for the Trilogy pipeline.

$ npm install fallcube-api
$ npx fallcube-api
POST

Upload

/upload
Upload a file with optional tags and folder. Returns metadata with ID, hash, category, and size. Batch: POST /upload/batch (up to 20 files).
GET

List & Filter

/files
List all files. Filter by category, extension, folder, starred, tag. Sort by name, date, size. Paginate with limit/offset.
GET

Search

/search?q=...
Full-text search across filenames, extensions, tags, and folders. Relevance-ranked results with fuzzy matching.
POST

AI Analyze

/files/:id/analyze
Run AI analysis on any document, image, or code file. Returns structured summary, entities, insights, and suggested tags. Multi-provider.
GET

Download / Stream

/files/:id/download
Download or stream files. Range request support for media. Inline mode at /files/:id/stream for browser playback.
PATCH

Organize

/files/:id
Rename, star, tag, move to folder. Bulk operations: /files/move, /files/delete-batch, /files/:id/duplicate.

One API. Every file operation.

🔒

Sovereign

Self-hosted. Your disk. Your keys. No cloud dependency whatsoever.

🔍

Search

Full-text search with relevance scoring across names, tags, and folders.

🧠

AI Analysis

Claude, GPT, or Gemini analyze any document, image, or code file.

🎛

Streaming

Range request support. Stream video, audio, and large files natively.

📁

Organize

Folders, tags, stars, categories. Automatic file type detection.

Batch Ops

Upload, move, delete, tag in bulk. Up to 20 files per batch request.

📈

Stats

Storage analytics, category breakdown, upload trends, extension distribution.

🔗

Pipeline Ready

Slots into Trilogy Framework as the storage spine between DocMind, Deep, and Flux.

The Storage Spine

Input
DocMind
Store
FallCube
Intelligence
Deep
Store
FallCube
Output
Flux

FallCube sits between every stage. Parse a receipt with DocMind, store it. Research with Deep, store the findings. Generate a report with Flux, archive it. Persistent, searchable, sovereign.