# csznet/tgState

使用Telegram作为存储的文件外链系统，不限制文件大小和格式。

Repository: https://github.com/csznet/tgState
Canonical: https://ross.abutalabs.com/products/tgstate
Homepage: https://www.csz.net
Language: Go
License: MIT
License Family: permissive
Topics: go, golang, telegram, telegram-bot, file, file-sharing, file-upload, filesystem, images, imageserver, img, storage, storage-api, storage-service, telegram-api, telegram-bot-api, telegrambot, vercel
Last push: 2025-04-13T11:37:39+00:00

## Health v2 (maintenance only)
Score: 25/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 16, release rhythm 8, longevity 76
- inputs: {"age_days": 1066, "days_push": 507, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1044, forks 183 (observed 2026-08-28T04:03:21.207547+00:00)

## What it is
tgState is a self-hosted file hosting and image bed system that uses Telegram as its storage backend, with no limits on file size or format. It supports web uploads, direct Telegram bot uploads, an HTTP API, and deployment via binary, Docker, or Vercel.

## Use cases
- host images on telegram as an image bed
- use telegram as unlimited free cloud storage
- self-host a file sharing service with direct links
- upload files via api to get external urls
- deploy a personal file hosting service on vercel
- share large files without size limits

## When to choose
- you want free, unlimited-size file storage using a Telegram bot
- you need a simple self-hosted image bed with an upload API
- you want to deploy on Vercel, Docker, or a bare binary

## When to avoid
- you need guaranteed long-term storage or privacy, since files live in Telegram
- you need files larger than 5MB on the Vercel deployment
- you require enterprise-grade storage compliance or SLAs

## Facets
- artifact type: application
- maturity: active
- function: file-upload, object-storage, http-server, chatbot
- domain: files, self-hosted, web-development, messaging-platforms
- platform: self-hosted, cli, go
- tags: telegram, image-hosting, file-sharing, cloud-storage, telegram-bot, vercel, imgbed, linux, docker, web-server

## Member repositories
- csznet/tgState (main) score 25

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:21.207547+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:02:12.637091+00:00, confidence not recorded.
  - readme: https://github.com/csznet/tgState (fetched 2026-08-28T04:03:21.207547+00:00, sha 821ec012b291)
  - homepage: https://www.csz.net (fetched 2026-08-29T13:03:09.784234+00:00, sha ad6da3899478)
- Data as of 2026-08-30T08:39:29.467469+00:00.