README.md

metadata

title: Sonic Vault Heavy Lifter
emoji: 🚀
colorFrom: blue
colorTo: indigo
sdk: docker
app_port: 7860
pinned: false

Sonic Vault Heavy Lifter

This is the high-concurrency media vaulting engine for the Sonic API. It handles large media downloads and uploads to Telegram using MTProto for maximum performance and to avoid Cloudflare Worker timeout limitations.

Role

• Receives vaulting requests from the Sonic API Worker.
• Downloads media using high-speed external streamers.
• Uploads to Telegram using Pyrogram (MTProto).
• Synchronizes metadata back to the API via a secure callback.

Technical Details

• Framework: FastAPI (Asynchronous)
• Engine: Pyrogram (MTProto)
• Deployment: Docker (Standard HF Port 7860)

Required Secrets

To run this Space, you must configure the following secrets in the Space Settings:

Secret	Description
SECRET_TOKEN	Shared secret for authentication with the main API.
TELEGRAM_API_ID	Your API ID from my.telegram.org.
TELEGRAM_API_HASH	Your API Hash from my.telegram.org.
TELEGRAM_BOT_TOKEN	Your Telegram Bot token.
TELEGRAM_CHAT_ID	The numeric ID of the storage chat.

Local Testing

You can test the logic locally using run_local_test.py. Ensure your .env is configured correctly.