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.