Teleloom

Seu Telegram, pronto para agentes.
Um kit de ferramentas para Telegram com habilidades portáteis para agentes, um servidor MCP e uma CLI.

Comece agora · Русский · Clientes · Exemplos de tarefas · Para agentes

O Teleloom conecta suas contas e bots do Telegram ao agente que você já usa. Encontre mensagens em vários chats, acompanhe discussões, crie resumos com links para as fontes, inspecione documentos e prepare ações que você pode revisar antes de executá-las.

Um proprietário local gerencia conexões e estado. Vários clientes de agente compartilham isso; você escolhe os chats acessíveis e as permissões para cada conta.

O que você pode fazer

Tarefa	O que o Teleloom oferece
Acompanhar	Ler histórico, pesquisar mensagens e autores, seguir respostas e tópicos, revisar mensagens não lidas
Pesquisar vários chats	Trabalhos de coleta limitados, originais congelados, contadores, trechos, exportações e lacunas de cobertura explícitas
Escrever um resumo verificável	Referências de evidência estáveis, links para fontes, validação de alegações/revisões e instruções portáteis de resumo
Trabalhar com mídia	Fotos, texto rico, documentos/PDF, OCR opcional e transcrição opcional
Agir com controle	Visualizar e confirmar mensagens, respostas, mídia, transmissões limitadas e alterações suportadas de conta/grupo
Manter o contexto gerenciável	Seleção de campos reutilizável, visualizações compactas, orçamentos de saída e acesso aos originais exatos

67 ferramentas MCP e seis habilidades portáteis: conectar, ler, caixa de entrada, resumo, enviar e transmitir. Consulte a referência de ferramentas para contratos e limites exatos.

Início rápido

Requer Git, uv e Python 3.12–3.14. Contas de usuário precisam do seu próprio ID/hash da API do Telegram em my.telegram.org. Bots usam um token de bot. As credenciais são inseridas localmente, fora de uma conversa com o agente.

git clone --single-branch https://github.com/starsinc1708/teleloom.git
cd teleloom
uv sync --frozen
uv run teleloom init
uv run teleloom auth user --profile personal --ui browser
uv run teleloom profile list

No seu telefone, abra Telegram → Configurações → Dispositivos → Vincular dispositivo de desktop e escaneie o QR. Um armazenamento de credenciais do sistema operacional funcional é necessário para salvar a sessão. Para hosts sem interface gráfica, bots, restrições de leitura e solução de problemas no primeiro uso, siga o guia em inglês ou o guia em russo.

Conecte um cliente e instale suas habilidades:

uv run teleloom config client --client codex
uv run teleloom skills install --client codex

Mescle o fragmento impresso na configuração existente do cliente e reconecte o MCP. Use claude, opencode (v2), opencode-v1, hermes ou pi para outros clientes. As habilidades existentes são preservadas, a menos que você solicite explicitamente a substituição. Caminhos de clientes e verificações de descoberta.

Para OpenCode 2 ou Hermes, registre o MCP por meio da CLI do cliente instalado:

uv run teleloom config client --client opencode --install
uv run teleloom skills install --client opencode
uv run teleloom config client --client hermes --install
uv run teleloom skills install --client hermes

Escolha o par para o seu cliente e reconecte o MCP (opencode reload para um serviço OpenCode em execução). --install está disponível no checkout atual do código-fonte; a v0.5.0 apenas imprime fragmentos. Uma conexão idêntica é preservada; uma entrada teleloom conflitante requer revisão manual. As habilidades do Hermes seguem hermes config path, incluindo seu perfil ativo e HERMES_HOME.

Experimente isto primeiro:

Verifique o status do servidor e liste os perfis. Peça para selecionar um perfil e um chat. Leia as últimas 20 mensagens sem marcá-las como lidas. Resuma os principais tópicos com links para as mensagens e indique qualquer contexto ausente. Não envie mensagens nem altere configurações ou permissões.

Controle e privacidade

• Novos perfis podem ler todos os chats acessíveis à conta. Use a política de leitura selecionada para restringir o acesso; o guia de configuração explica os portões independentes de ferramentas e chats.
• Envio e outras alterações externas exigem permissões próprias e uma visualização imutável mais confirmação. Uma entrega incerta é registrada como desconhecida e nunca é reenviada automaticamente.
• Uma instrução humana explícita para enviar a destinatários exatos pode autorizar esse envio visualizado e arquivos locais selecionados por meio de owner_authorized=true. Listas de permissão permanentes e raízes de arquivos permanecem inalteradas. Autorização de plano.
• As credenciais do Telegram permanecem no chaveiro do sistema operacional ou no ambiente fornecido. Estado e exportações permanecem no seu diretório de dados local. Seu provedor de agente/modelo escolhido recebe as evidências que você solicitar; análise externa opcional é explícita.
• A leitura não confirma mensagens. O histórico de bots cobre observações coletadas, e os resultados de pesquisa/resumo divulgam seu escopo e lacunas.

O sinalizador de confirmação é uma entrada confiável do seu cliente de agente; não é uma prova independente de aprovação humana. Todos os clientes locais compartilham um proprietário de sistema operacional confiável. Modelo de segurança e relato de vulnerabilidades.

Clientes e recursos opcionais

Cliente	Integração
Codex	Stdio MCP e seis habilidades portáteis
Claude Code	Stdio MCP e seis habilidades portáteis
OpenCode 2 / 1	Configuração MCP nativa; alvos de versão separados
Hermes	Configuração e habilidades nativas de mcp_servers
Pi	Configuração e habilidades nativas de mcpServers
Claude Desktop	Configuração MCP; comportamento da GUI permanece não verificado
Outros hosts MCP	Stdio ou Streamable HTTP autenticado em loopback

Extras opcionais: pdf, ocr, transcription e jev. Comece com a instalação base; habilite apenas os mecanismos que você precisa. Mídia, anexos, implantação. Observações nativas de conexão e limites de teste estão registradas em aceitação; a descoberta não estabelece qualidade de fluxo de trabalho do modelo.

Desenvolva e contribua

Relate bugs reproduzíveis e proponha fluxos de trabalho em Issues. Leia CONTRIBUTING; agentes de codificação começam com AGENTS.md. Execute verificações para o comportamento que você alterar. Um lançamento substancial recebe uma execução completa, uma compilação canônica e verificação de identidade dos artefatos.

O Teleloom v0.5.0 é o primeiro lançamento público, publicado com um histórico Git novo. O pacote Python, módulo, CLI e servidor MCP são nomeados teleloom; as habilidades de runtime usam o prefixo teleloom-. Instale a partir deste repositório ou de seus artefatos de lançamento; nenhuma distribuição PyPI é reivindicada. Changelog · Documentação.

Licenciado sob MIT. Inspirado por chigwell/telegram-mcp, implementado de forma independente. O Teleloom é um projeto independente, sem afiliação com o Telegram.