Yungle
Envie arquivos para pessoas a partir de um assistente de IA: compartilhe arquivos como links de download, liste transferências e leia recibos de download. Transferência de arquivos privada e hospedada na UE (servidores na Alemanha). Login via OAuth, sem necessidade de colar chave; enviar e-mail a um destinatário exige sua confirmação a cada envio.
Servidor MCP hospedado
npx add-mcp 'https://yungle.co/mcp'Instala no Claude Code, Codex, Cursor e outros
Documentação
Yungle para desenvolvedores
Envie arquivos grandes do seu terminal, dos seus scripts e do seu assistente de IA.
Transferência de arquivos privada e sustentável: uma alternativa ao WeTransfer com CLI, servidor MCP, SDKs tipados e webhooks.
Website · Docs · Referência da API · CLI · MCP · TypeScript · Python
npm install -g yungle-cli
yungle login # opens your browser, once
yungle send ./render.mov # uploads resumably, prints the link
Quer que o Yungle envie o link por e-mail para você? Entre com uma chave de API (yungle login --key) e adicione
--to client@example.com. Um login pelo navegador cria links, mas nunca envia e-mails para ninguém, então um
código de login obtido por phishing não pode ser usado para enviar mensagens a estranhos.
O que tem aqui
| Instalação | Para que serve | |
|---|---|---|
| CLI | npm i -g yungle-clibrew install heindewilde/yungle/yungle | Envie, receba e sincronize arquivos de um terminal ou CI — nos dois sentidos, pastas preservadas, checksums verificados. Retoma após uma conexão cair ou o laptop fechar |
| Servidor MCP | No diretório do Claudehttps://yungle.co/mcp | Conecte Claude, Cursor ou qualquer cliente MCP com um único login: pergunte o que chegou, compartilhe arquivos grandes (o Yungle pode buscá-los de uma URL), baixe o que foi enviado para você, aprove cada envio |
| SDK TypeScript | npm i yungle-client | Toda a API, tipada e sem dependências, com uploads retomáveis de qualquer Blob. Node, Bun, Deno, runtimes de edge |
| SDK Python | pip install yungle | A API a partir do Python, com uma chamada única send() que cuida do upload |
| GitHub Action | uses: heindewilde/yungle-send-action@v1 | Envie artefatos de build para um cliente a partir do CI e receba o link de volta como saída |
| Exemplos | GitHub Actions, relatórios noturnos e mais em docs.yungle.co/guides/send-from-ci |
Tudo isso fala com a mesma API REST pública (OpenAPI 3.1), contra a qual os checks de CI testam esses clientes a cada mudança.
A CLI
Feita para ser agradável para uma pessoa e previsível para um script. Bonita em um terminal, apenas o
link quando canalizada, JSON com --json.
yungle send ~/Shoot --to anna@studio.nl --message "Final selects" # send a folder
yungle send dist/ --json | jq -r .url # in a script
yungle get https://yungle.co/t/emerald-palm-a5mt # download, no account needed
yungle send --from-url "https://bucket.s3.eu-central-1.amazonaws.com/render.mov?…" # Yungle fetches it
yungle pull --collection 01J8Z3M9Q0W4 # your collection, to disk
yungle status # who downloaded what
yungle watch ~/Renders --collection 01J8Z3M9Q0W4 # upload new files as they land
yungle webhooks listen --forward-to http://localhost:8080/hooks # test webhooks locally
- Uploads grandes e retomáveis. Interrompa
yungle send, execute novamente, e ela continua a partir da última parte confirmada em vez de recomeçar do zero. - Orientação quando você omite algo.
yungle sendsozinho pergunta o que enviar e para quem. Nunca em CI, nunca com--jsonou--yes: um script não pode travar em uma pergunta. - Erros dizem a solução. Cada falha termina com o único comando que resolve o problema, e um erro de digitação recebe um você quis dizer.
- Autocompletar por tab para zsh, bash e fish:
yungle completion zsh.
Referência completa: apps/cli · docs.yungle.co/cli
Conecte seu assistente de IA
No Claude: adicione o Yungle pelo diretório de conectores do Claude e faça login.
Em qualquer outro lugar (Cursor, VS Code, qualquer cliente MCP): adicione o Yungle como servidor MCP remoto e faça login uma vez. Sem chave para copiar.
https://yungle.co/mcp
Depois pergunte coisas como "A Anna baixou o conjunto final?", "Quais entregas expiram esta
semana?", "Compartilhe estes três arquivos com o cliente.", "Envie ao cliente o render no nosso bucket S3." ou
"O que tem no link que a Anna me enviou?" Um chat não pode carregar um arquivo de 40 GB, então o assistente não carrega:
o Yungle o busca de onde ele já está, ou o assistente executa um comando de um arquivo npx yungle-cli put
no shell dele. O assistente prepara; você aprova cada envio antes de um e-mail sair. Não existe ferramenta que exclua, revogue ou convide, e
tudo o que o servidor retorna é rotulado como dado não confiável, porque um nome de arquivo pode carregar
uma injeção de prompt.
Prefere um servidor local com chave de API? yungle mcp install escreve a configuração para o Claude
Desktop, Claude Code, Cursor ou Windsurf. Detalhes: packages/mcp-server.
Os SDKs
import { YungleClient } from 'yungle-client';
const yungle = new YungleClient({ apiKey: process.env.YUNGLE_API_KEY! });
for await (const t of yungle.allTransfers()) console.log(t.title, t.downloadCount);
from yungle import Yungle
sent = Yungle().send(["render.mov"], to=["client@example.com"], message="Final cut")
print(sent["url"])
Ambos tentam novamente o que é seguro tentar, colocam um Idempotency-Key em cada POST para que uma nova tentativa nunca
crie uma segunda cópia, seguem a paginação por cursor para você e verificam assinaturas de webhook.
Webhooks
Seja avisado em vez de fazer polling: transfer.ready, transfer.downloaded, transfer.expiring,
transfer.expired, e em planos pagos collection.file_uploaded. Cada entrega é assinada com
HMAC-SHA256 e tentada novamente com backoff. Sem URL pública? Deixe de fora e puxe os eventos em vez disso.
import { verifyWebhook } from 'yungle-client';
const ok = await verifyWebhook(rawBody, req.headers['yungle-signature'], process.env.YUNGLE_WEBHOOK_SECRET!);
Planos e limites
Toda conta pode usar a API, a CLI e o servidor MCP, incluindo o plano gratuito: transferências de até 10 GB, contatos, webhooks e download de qualquer link. Coleções e arquivos que nunca expiram vêm com um plano pago. Os primeiros 10 GB de uploads de API por mês são gratuitos, depois €0,02/GB de crédito pré-pago. Preços
Por que Yungle
- Na Europa, operado por uma empresa europeia. Seus arquivos são armazenados e servidos a partir de infraestrutura da UE.
- Sempre criptografado. Cada arquivo tem sua própria chave, e transferências podem ser criptografadas de ponta a ponta no navegador quando você precisar.
- Sustentável. Hidroeletricidade renovável, em um data center com PUE de 1,13. O que isso significa e o que não significa.
Não acessível daqui: seu cofre e transferências criptografadas de ponta a ponta. As chaves deles são derivadas no seu navegador e nunca enviadas ao Yungle, então nenhuma API pode lê-las. Veja o que a API não pode fazer.
Contribuindo
pnpm install
pnpm typecheck && pnpm lint && pnpm test && pnpm build
pnpm contract # check the clients (operations and types) against the live OpenAPI spec
Este repositório é onde os clientes são desenvolvidos; o serviço Yungle em si não é open source. Issues e pull requests são bem-vindos, veja CONTRIBUTING.md. Relatórios de segurança passam por security.txt.
MIT
