Telegram Cloud Storage

A high-performance Telegram Cloud Storage solution using Teldrive. Turns Telegram into an unlimited cloud drive with a local API/UI.

Security Scan

The skill is internally consistent with its stated purpose (wrapping Teldrive) and installs a Teldrive binary from GitHub; there are a few small mismatches and operational caveats you should review before installing.

Purpose & Capability

Name/description match the files and scripts: the skill bundles a Teldrive binary installer, setup, management scripts, and a Python client to talk to a local Teldrive server. The declared need for a database and Telegram API credentials is appropriate for Teldrive.

Instruction Scope

Runtime instructions operate on the skill directory (create config, install binary, start/stop service) and the Python client talks only to localhost:8080. The SKILL.md and client reference TELDRIVE_TOKEN and TELDRIVE_SESSION_HASH for operations, but these env vars are not listed in registry metadata. setup.sh is interactive and uses sed replacements (fragile for inputs with special chars). No instructions request unrelated system files or external endpoints other than the GitHub release URL and localhost API.

Install Mechanism

Install uses an exec script that downloads a tarball from a GitHub releases URL (https://github.com/tgdrive/teldrive/releases/...). This is a common/traceable source and the script extracts and installs a binary into the skill's bin/ directory. Minor inconsistency: the installer hardcodes VERSION=1.8.0 while the skill registry version is 1.8.2.

Credentials

The skill legitimately requires Telegram App ID/Hash, a Postgres connection string, and a JWT secret (all collected by setup.sh). The client uses TELDRIVE_TOKEN and TELDRIVE_SESSION_HASH, but the registry lists no required env vars — this mismatch should be corrected so users know which secrets are needed. Requested credentials are proportional to the functionality (they are necessary for Teldrive operation).

Persistence & Privilege

The skill does not request always:true and does not modify other skills or system-wide agent settings. It writes files within its own directory (bin/, config/, logs/, pidfile) and starts the Teldrive process; this is expected behavior for a self-contained service.

Assessment

This package appears to be a straightforward wrapper around Teldrive, but review these before installing: (1) Trust the binary source — the installer downloads a GitHub release; confirm the release and checksum if you need assurance. (2) Expect to provide Telegram App ID/Hash, a Postgres connection string, and a JWT secret — those are required for operation. (3) The Python client reads TELDRIVE_TOKEN and TELDRIVE_SESSION_HASH from env or token files; the registry metadata doesn't declare these env vars, so be aware of where tokens/sessions will be stored (config/token.txt and the DB). (4) setup.sh is interactive and uses simple sed substitutions that may break or mangle inputs containing special characters — avoid pasting complex secrets with newlines or problematic characters, or edit config/config.toml by hand. (5) Check how the server binds (network exposure) and ensure you do not expose the service publicly without authentication and a strong JWT secret. (6) If you have low trust in the publisher, run the skill in an isolated environment (container/VM) and inspect the downloaded teldrive release before running.

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

1. PostgreSQL Database: Version 17+ recommended.
2. pgroonga Extension: Required for file search within Postgres.
3. 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.