Repolode
ahujasid

ahujasid/camera-to-blender

Fotografe um objeto real com o celular e gere um modelo 3D importado diretamente no Blender.

Estrelas
1,395
Forks
162
Issues abertas
1
Último commit
há 2 meses

O que é?

Camera to 3D é um pipeline que transforma a foto de um objeto real, tirada com o celular, em um modelo 3D dentro do Blender. Opcionalmente, a foto passa por uma remoção do fundo, é enviada à API do Tripo3D para gerar o modelo e, em seguida, é encaminhada por uma conexão WebSocket para um add-on do Blender, que o importa automaticamente.

O sistema tem duas partes. Um servidor Python FastAPI é executado no computador com o Blender aberto e cuida das chamadas à API e do encaminhamento. Um app web compatível com dispositivos móveis oferece a interface da câmera. Como os navegadores de celular exigem HTTPS para acessar a câmera, a configuração usa o ngrok para expor o servidor local; depois, a mesma URL é colada no painel WS Import do add-on do Blender.

É necessária uma chave da API do Tripo3D para gerar modelos. Uma chave da API do Gemini é opcional; se o campo ficar vazio, a foto é usada sem remoção do fundo. Também é possível usar a webcam de um laptop em vez do celular, executando o servidor localmente sem o ngrok.

Recursos principais

  • 01Captura fotos pelo navegador do celular ou pela webcam do laptop.
  • 02Remove opcionalmente o fundo da foto usando a API do Gemini.
  • 03Gera modelos 3D por meio da API do Tripo3D.
  • 04Importa automaticamente os modelos prontos para o Blender por meio de um add-on com WebSocket.
  • 05Inclui uma opção de configuração com ngrok para acessar pelo celular via HTTPS.

Casos de uso

  • Digitalizar objetos do dia a dia no Blender para usar como referências ou malhas iniciais.
  • Adicionar rapidamente objetos reais a uma cena 3D para pré-visualização.
  • Prototipar assets 3D sem modelagem manual.

Início rápido

  1. 1

    Instale as dependências do Python

    pip install -r requirements.txt
  2. 2

    Inicie o servidor relay

    uvicorn relay_server:app --host 0.0.0.0 --port 8000
  3. 3

    Em um segundo terminal, exponha o servidor via HTTPS com o ngrok

    ngrok http 8000
  4. 4

    Instale o add-on WS Import no Blender e conecte-o à sua URL do ngrok

Antes de usar

  • É necessária uma chave de API do Tripo3D para gerar os modelos 3D.
  • Para usar no celular, é necessário o ngrok, pois as câmeras dos celulares precisam de HTTPS.
  • As URLs gratuitas do ngrok mudam a cada reinicialização, então é preciso reconectar o Blender todas as vezes.

Em coleções

Tópicos

Perguntas frequentes

O que é camera-to-blender?
Fotografe um objeto real com o celular e gere um modelo 3D importado diretamente no Blender. Camera to 3D é um pipeline que transforma a foto de um objeto real, tirada com o celular, em um modelo 3D dentro do Blender. Opcionalmente, a foto passa por uma remoção do fundo, é enviada à API do Tripo3D para gerar o modelo e, em seguida, é encaminhada por uma conexão WebSocket para um add-on do Blender, que o importa automaticamente.
camera-to-blender é gratuito? Qual é a licença?
camera-to-blender é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
camera-to-blender ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de camera-to-blender foi em 5 de set. de 2026.
Para que posso usar camera-to-blender?
Digitalizar objetos do dia a dia no Blender para usar como referências ou malhas iniciais. Adicionar rapidamente objetos reais a uma cena 3D para pré-visualização. Prototipar assets 3D sem modelagem manual.
Como instalar camera-to-blender?
Instale as dependências do Python: pip install -r requirements.txt Inicie o servidor relay: uvicorn relay_server:app --host 0.0.0.0 --port 8000 Em um segundo terminal, exponha o servidor via HTTPS com o ngrok: ngrok http 8000 Instale o add-on WS Import no Blender e conecte-o à sua URL do ngrok
Onde consigo camera-to-blender?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/ahujasid/camera-to-blender

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados