Skip to content

Repository files navigation

BunnyFy

Media in. Power out.
Uma camada de processamento de mídia, IA e experiências visuais pensada para produtos que precisam fazer mais com menos acoplamento.

TypeScript Fastify Media processing AI gateway Public showcase

Produto  •  Capacidades  •  Arquitetura  •  Código público  •  Segurança


Important

Este repositório é uma vitrine comercial e técnica da BunnyFy. Ele contém documentação, contratos, exemplos e partes selecionadas da implementação para demonstrar arquitetura e qualidade de engenharia. O backend operacional completo, infraestrutura, credenciais, configuração de produção e mecanismos privados de operação não são distribuídos por este repositório.

✦ O que é a BunnyFy

A BunnyFy concentra tarefas que normalmente acabam espalhadas entre bots, scripts, serviços externos e credenciais difíceis de governar. Em vez de cada consumidor conhecer detalhes de provedores, formatos e subprocessos, ele conversa com uma superfície única e recebe contratos previsíveis.

O produto foi desenhado em torno de quatro ideias:

  • uma API, várias capacidades de mídia e IA;
  • provedores ficam atrás da plataforma, não dentro dos clientes;
  • falhas de uma capacidade não derrubam o restante;
  • contratos estáveis permitem trocar implementação sem reescrever consumidores.

Em uma frase

Entrada: mídia, prompt ou intenção.

BunnyFy: valida, roteia, processa, observa.

Saída: artefato pronto para consumo.


Media in. Power out.


◈ Capacidades

🎞️ Media Pipeline

Download, normalização e transformação de mídia por uma camada que esconde peculiaridades dos provedores e mantém erros previsíveis para os consumidores.

🖼️ Social Canvas

Renderização de cards e superfícies visuais para experiências sociais, perfis, jogos e respostas ricas sem obrigar o cliente a carregar um motor gráfico próprio.

🧠 AI Gateway

Uma fronteira única para capacidades de IA. Modelo, provedor e credencial pertencem à plataforma; o cliente depende do contrato, não da marca por trás dele.

🎙️ Áudio & Transcrição

Preparação de áudio e transcrição como capacidade isolada, com indisponibilidade localizada quando uma ferramenta específica não está pronta.

✨ Image Routing

Roteamento de geração e processamento visual por intenção, com possibilidade de fallback e evolução de provedores sem expor essa dança ao consumidor.

🔐 Access Layer

Autenticação, escopos, limites e observabilidade fazem parte da superfície da API. A integração não precisa carregar segredos dos provedores que a BunnyFy utiliza.

⬡ Arquitetura

flowchart LR
    C[Produtos consumidores] -->|contrato BunnyFy| A[BunnyFy API]
    A --> V[Validação e acesso]
    V --> R[Roteamento de capacidades]
    R --> M[Mídia]
    R --> I[IA]
    R --> S[Social Canvas]
    R --> T[Transcrição]
    M --> P[Adaptadores privados]
    I --> P
    T --> P
    S --> O[Renderização local]
    A --> X[Saúde · métricas · erros estáveis]
Loading

A linha que importa é simples: consumidores conhecem a BunnyFy; a BunnyFy conhece os provedores. Isso reduz credenciais espalhadas, dependência direta de terceiros e mudanças em cascata quando um fornecedor muda o próprio contrato numa terça-feira qualquer, como fornecedores adoram fazer.


◎ O que este repositório mostra

O snapshot público existe para tornar a engenharia observável sem transformar o produto em uma distribuição reproduzível da operação.

Superfície pública O que demonstra
contratos e tipos formato esperado entre consumidor e API
rotas selecionadas organização da superfície HTTP
bibliotecas escolhidas tratamento de mídia, erros e capacidades
testes selecionados invariantes e comportamento esperado
documentação técnica decisões de arquitetura e integração
exemplos visuais direção do Social Canvas e experiências da plataforma

O que fica fora

Não fazem parte da distribuição pública: topologia operacional completa, credenciais, segredos, configuração real de produção, mecanismos internos de deploy, material necessário para reproduzir o serviço integral e componentes que constituem vantagem operacional da plataforma.

Note

Encontrar código neste repositório não significa que exista aqui um pacote de instalação da BunnyFy. Não há promessa de clone → npm start → serviço completo. A finalidade é avaliação técnica e apresentação do produto.


⇄ Relação com consumidores

A BunnyFy nasceu para servir aplicações reais, não para ser uma coleção abstrata de endpoints. O SHOGUN é um dos consumidores do ecossistema e usa a API como camada para capacidades que não deveriam ficar embutidas no processo do bot.

sequenceDiagram
    participant App as Aplicação
    participant B as BunnyFy
    participant Cap as Capacidade
    App->>B: requisição autenticada
    B->>B: valida escopo e contrato
    B->>Cap: executa ou roteia
    Cap-->>B: resultado normalizado
    B-->>App: resposta BunnyFy
Loading

O consumidor não precisa receber token de provedor, interpretar envelopes diferentes para cada fornecedor ou saber qual backend executou uma capacidade específica.


⛨ Segurança e isolamento

A arquitetura separa credenciais da plataforma de credenciais dos consumidores. Provedores externos permanecem atrás da BunnyFy; clientes recebem apenas o nível de acesso necessário ao contrato autorizado.

Falhas de ferramentas e dependências são tratadas por capacidade sempre que possível. Uma função indisponível deve produzir um erro estável e observável, não transformar a API inteira numa pilha fumegante de 500 sem contexto.

O repositório público também é tratado como uma superfície de exposição: segredos, sessões, cookies, URLs assinadas e configuração operacional real não pertencem ao snapshot público.


◉ Estado do projeto

A BunnyFy segue em desenvolvimento ativo. O repositório público acompanha recortes selecionados da evolução técnica e visual do produto, não necessariamente cada detalhe do runtime privado no instante em que ele muda.

API
contratos tipados
Mídia
pipeline modular
IA
gateway desacoplado
Visual
Social Canvas

Para avaliação técnica ou integração

Este espaço é o cartão técnico da BunnyFy: arquitetura, contratos, decisões de engenharia e exemplos suficientes para entender o que a plataforma resolve e como ela pensa, sem publicar o mapa completo da sala de máquinas.

BunnyFy
Media in. Power out.

About

API de mídia e automação: download de vídeos, remoção de fundo, transcrição de áudio, geração de imagens e renderização de jogos, tudo em uma única plataforma.

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages