StoneTag

Aplicativo desktop para processar fotos de etiquetas técnicas, corrigir a orientação e salvar cada imagem com o código identificado na própria etiqueta.

Recursos

• Seleção de várias fotos pela interface.
• Correção automática de orientação.
• Extração do código da etiqueta com LlamaCloud.
• Renomeação padronizada das imagens.
• Prevenção de sobrescrita com nome (2).jpg.
• Controle de duplicatas por código durante o lote.
• Barra de progresso e contador de fotos processadas.
• Build para Windows com PyInstaller.

Requisitos

• Python 3.11+
• Tesseract OCR
• Chave da API da LlamaCloud

Instalação

pip install -r requirements.txt

Crie o arquivo .env a partir do exemplo:

copy .env.example .env

Preencha:

LLAMA_CLOUD_API_KEY=sua_chave_aqui

Uso

Abra a interface:

abrir_interface.bat

Ou rode diretamente:

python interface.py

Fluxo na interface:

1. Selecione as fotos.
2. Escolha a pasta de saída.
3. Clique em Processar.
4. Abra a pasta final em Abrir resultado.

Terminal

Também é possível executar o fluxo antigo por terminal:

python main.py

Nesse modo, o projeto usa:

imagens/
rotacionadas/
renomeadas/

Executável

Instale as dependências de desenvolvimento:

pip install -r requirements-dev.txt

Gere o .exe:

build_exe.bat

Saída:

dist/StoneTag.exe

O build atual empacota o Tesseract local, o ícone do aplicativo e o .env da máquina usada no build.

Não distribua publicamente um .exe gerado com uma chave real de API embutida.

Ícone

Para trocar o ícone:

assets/icone.svg

Depois rode:

python converter_png_para_ico.py

O build usa:

assets/icone.ico

Estrutura

StoneTag/
  assets/
  interface.py
  main.py
  renomeia_imagem.py
  rotaciona_imagem.py
  converter_png_para_ico.py
  build_exe.bat
  abrir_interface.bat
  requirements.txt
  requirements-dev.txt
  .env.example

Validação

python -m py_compile interface.py main.py renomeia_imagem.py rotaciona_imagem.py converter_png_para_ico.py

Próximos Passos

• Solicitar a chave da API na primeira execução.
• Salvar configuração local em %APPDATA%\StoneTag.
• Separar builds de teste e distribuição.