Source Code

Telegram Cloud Storage (Teldrive Edition)

This skill runs Teldrive, a powerful utility that organizes Telegram files and provides a high-speed API/UI for accessing them.

Features

Unlimited Storage: Uses Telegram as a backend.
High Performance: Written in Go, optimized for speed.
UI & API: Includes a web interface and REST API.
AI-Native Client: Includes client.py for agent-based file operations.

Credits

This skill is a wrapper for Teldrive by divyam234. All credit for the core engine goes to the original authors.

Requirements

PostgreSQL Database: Version 17+ recommended.
pgroonga Extension: Required for file search within Postgres.
Telegram API: App ID and Hash from my.telegram.org.

Installation

1. Database Setup

Ensure Postgres is running and the pgroonga extension is installed.

CREATE DATABASE teldrive;
\c teldrive
CREATE EXTENSION IF NOT EXISTS pgroonga;

2. Configure

Run the setup script to generate config/config.toml:

./scripts/setup.sh

3. Start Server

./scripts/manage.sh start

Agent Usage

The skill includes a Python client for programmatic access.

Environment Variables

TELDRIVE_TOKEN: Your JWT token (get this from the UI or config/token.txt after login).
TELDRIVE_SESSION_HASH: Your Telegram session hash (found in the teldrive.sessions table).

Commands

# List files
python3 scripts/client.py list /

# Upload a file
python3 scripts/client.py upload local_file.txt /remote/path

# Download a file
python3 scripts/client.py download <file_id> local_save_path

Directory Structure

bin/: Teldrive binary.
config/: Configuration templates and generated config.
scripts/: Setup, management, and client scripts.
logs/: Application logs.

telegram-cloud-storage