Deploy tFMb
Railway

Deploy tFMb

tigraoFM versão com lastfm conectado

Deploy tFMb

Just deployed

tigredis

redis:8.2.1

Just deployed

/data

Com certeza. Como estamos subindo a versão 2.0 (a "Branch Last.fm"), o deploy precisa ser tão limpo quanto a nova arquitetura assíncrona que estruturamos. Aqui está a documentação pronta para o seu README ou guia de implantação:

Deploy and Host tFMb on Railway

tFMb (TigrãoFM) é um bot musical avançado para Telegram construído com Python 3.10+ e AsyncIO. Ele atua como um cliente assíncrono puro da API do Last.fm, oferecendo status em tempo real, radares de grupo, dossiês de artistas e geração visual de "Stories" para redes sociais com cache inteligente via Redis.

About Hosting tFMb

Hospedar o tFMb envolve configurar um ambiente que suporte execução assíncrona contínua e processamento de imagem on-the-fly. O bot utiliza aiohttp para comunicações não bloqueantes com o Last.fm e a biblioteca python-telegram-bot v20+ para gerenciar eventos do Telegram. O deploy requer uma instância de Redis para persistência de vínculos de usuários e um sistema de arquivos (ou volume) para o cache de imagens geradas pelo comando /story. Como o bot lida com I/O intensivo e renderização de fontes (Pillow), o host precisa de uma stack estável onde variáveis de ambiente gerenciem segredos de API com segurança.

Common Use Cases

  • Radar de Grupo: Identifica em tempo real quais membros de um chat estão ouvindo música simultaneamente via Last.fm.
  • Geração de Stories: Cria cards visuais estilizados (Modo Claro/Escuro) de faixas musicais para compartilhamento rápido em redes sociais.
  • Dossiê Musical Inline: Permite consultar estatísticas de artistas, álbuns e faixas atuais diretamente de qualquer conversa via modo Inline.

Dependencies for tFMb Hosting

  • Redis (v6.0+): Essencial para o mapeamento de usuários lastfm_user:{id} e controle de concorrência de instâncias (Lock).
  • Last.fm API Key: Credencial necessária para que o módulo lastfm_core.py realize o fetch de metadados e capas de álbuns.

Deployment Dependencies

  • Railway Platform — Hospedagem da aplicação e do banco Redis.
  • Telegram BotFather — Obtenção do TELEGRAM_TOKEN.
  • Last.fm API Account — Obtenção da LASTFM_API_KEY.

Implementation Details

O deploy no Railway utiliza as seguintes variáveis de ambiente críticas para o funcionamento da Branch 2.0:

VariávelDescrição
TELEGRAM_TOKENToken oficial do seu bot gerado pelo BotFather.
REDIS_URLURL de conexão (ex: redis://user:pass@host:port).
LASTFM_API_KEYChave de acesso à API do Last.fm.
STORY_CACHE_DIRCaminho para salvar os JPEGs gerados (ex: /app/cache).

Why Deploy tFMb on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it. By deploying tFMb on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway. Como Arquiteto, recomendo fortemente que, ao configurar o Railway, você utilize um Volume Montado para a pasta de cache do /story. Isso evita que as imagens geradas sumam a cada novo deploy (rebuild da imagem Docker). Precisa de ajuda com o Dockerfile ou com a configuração do Volume para esse cache?


Template Content

tigredis

redis:8.2.1

More templates in this category

View Template
calm-fair
GitHub PR lifecycle tracker for Slack: reviews, reactions, cleanup

Yogen P
View Template
Telegram JavaScript Bot
A template for Telegram bot in JavaScript using grammY

Agampreet Singh
View Template
Cobalt Tools [Updated Apr ’26]
Cobalt Tools [Apr ’26] (Media Downloader, Converter & Automation) Self Host

shinyduo