Crie, explore e entenda suas imagens. Um estúdio para Google Colab com galeria própria e uma wiki integrada em português, personalizado por Pedroltz sobre o Forge Neo.
Captura do Axo Guide em uma prévia local da interface, com os módulos de inferência simulados.
Começar no Colab · Wiki completa · Artes e prompts · Arquitetura · Apresentação no LinkedIn
Gerar imagens envolve muitos controles: modelos, prompts, samplers, steps, CFG e extensões. O Axo Image Studio reúne um ambiente de criação, uma biblioteca para explorar os resultados e um guia que explica esses controles durante o uso.
O projeto também resolve um problema encontrado na galeria no Colab: miniaturas e prévias passavam pela pasta temporária global do Forge e podiam falhar no carregamento. A galeria própria usa arquivos em um cache local separado e prepara o download original somente quando solicitado.
O Forge oferece o motor de geração e suas ferramentas de edição. O Axo adiciona a biblioteca de imagens, o guia em português, a identidade visual e a preparação do ambiente no Colab. O código da galeria e da wiki fica disponível separadamente, além de incorporado ao notebook.
| Área | Recursos |
|---|---|
| Criação | txt2img, img2img e Inpaint do Forge; configuração para SDXL e Anima |
| Axo Studio | Biblioteca com filtros, busca por nome, 24 imagens por página e atualização ao entrar na aba |
| Prévia e download | Prévia reduzida, leitura dos parâmetros, download do arquivo original e exportação da página em ZIP |
| Axo Guide | 29 artigos em português, busca no conteúdo, categorias e navegação anterior/próxima |
| Complementos | Instalação/configuração de ControlNet, ADetailer Neo e CivBrowser |
| Colab | Ambiente Python 3.12 isolado, revisões fixadas e opção de persistência no Google Drive |
A wiki explica cada aba e os conceitos de prompts, pesos, prompt negativo, samplers, schedulers, steps, CFG, seed, resolução, Hires fix, LoRAs e Inpaint. Inclui exemplos e referências às fontes originais.
| Mascote 3D | Fantasia ilustrada | Estilo fotográfico |
|---|---|---|
 |
 |
 |
Essas artes foram geradas com uma ferramenta externa para a apresentação do projeto. Os arquivos e prompts completos estão disponíveis para explorar as ideias no Axo; os resultados dependem do modelo e dos parâmetros.
O uso principal por uma WebUI é restrito em ambientes gratuitos do Colab sem saldo positivo de unidades de computação. Confira os requisitos atuais de execução na FAQ oficial do Colab. GPU e duração da sessão variam conforme disponibilidade e plano.
- Clique em Abrir no Colab.
- Salve uma cópia no seu Drive se quiser guardar as alterações do notebook.
- Selecione Ambiente de execução → Alterar tipo de ambiente de execução → GPU.
- Na célula Install and launch, escolha o idioma, o modelo inicial e a opção de Google Drive.
- Execute a célula e abra o endereço
gradio.liveexibido ao final da inicialização. Mantenha a célula em execução durante o uso. - Confira o UI Preset, o checkpoint e os módulos do modelo. Abra Axo Guide para um primeiro teste e Axo Studio para explorar as imagens.
O notebook é independente: os arquivos da extensão já estão incluídos nele. Não é necessário enviar a pasta do repositório ao Colab.
Você também pode baixar Axo_Image_Studio.ipynb e usar Arquivo → Fazer upload de notebook no Colab.
Os downloads de SDXL e Anima estão habilitados por padrão. Para usar só uma família, desative os downloads da outra e os complementos que não vai utilizar. A primeira execução instala dependências e baixa os modelos; o tempo depende da GPU, da conexão e das opções escolhidas.
Com USE_GOOGLE_DRIVE = True, modelos e imagens ficam em MyDrive/Axo-Image-Studio-Forge. Sem essa opção, ficam no armazenamento temporário da sessão do Colab. O ambiente Python é reconstruído em uma nova sessão.
Se um download do Civitai exigir autenticação, use os Segredos do Colab com o nome CIVITAI_TOKEN.
Para aplicar mudanças do notebook, interrompa o Forge e execute Install and launch novamente. Para reiniciar na mesma instalação, use Restart. Downloads já concluídos são reaproveitados.
| Sintoma | O que conferir |
|---|---|
| Galeria ou prévia mostra erro | Interrompa a célula sem excluir a sessão e execute Diagnosticar galeria no fim do notebook |
| Uma imagem nova não aparece | Clique em Atualizar e confira a pasta de saída configurada no Forge |
| Modelo Anima não carrega corretamente | Confira os módulos Qwen 0.6B e Qwen Image VAE no capítulo de modelos da wiki |
| Falta de memória na GPU | Use batch 1, reduza a resolução, desative Hires fix e mantenha LOW_VRAM ativado |
Aviso de detached symbolic reference no CivBrowser |
Consulte a explicação do aviso; ele se refere à leitura da branch Git de uma revisão fixada |
axo-image-studio/
├── Axo_Image_Studio.ipynb # Notebook pronto para o Colab
├── axo_launcher.py # Fonte da célula de instalação
├── extension/ # Interface, galeria, wiki e identidade visual
│ ├── scripts/
│ ├── javascript/
│ ├── assets/
│ └── style.css
├── docs/ # Wiki, arquitetura, apresentação e prévia
├── tools/build_notebook.py # Incorpora as fontes no notebook
└── tests/ # Verificações locais sem inferência com GPU
Veja CONTRIBUTING.md para editar a interface, atualizar o notebook e executar as verificações. O workflow em .github/workflows/validate.yml executa as verificações no GitHub Actions a cada push e pull request.
A correção da galeria foi confirmada em uso no Colab. Os 21 testes locais verificam carregamento em abas Gradio, filtros, paginação, prévias, metadados, download original, ZIP, busca e navegação da wiki. Também verificam se o notebook contém as mesmas fontes mantidas no repositório. Um teste adicional em JavaScript verifica a atualização ao entrar e retornar à aba.
Os testes locais não geram imagens com GPU. A inferência completa e todas as combinações de modelos/extensões ainda precisam de testes específicos. A referência de pose do Anima é experimental. A captura acima mostra o guia; as imagens usadas nos testes são sintéticas.
Pedroltz — personalização da interface, galeria, integração do notebook e Axo Guide.
A geração de imagens usa o Forge Neo, modelos de terceiros e extensões. Este repositório não contém pesos de modelos. Consulte THIRD_PARTY_NOTICES.md para as referências e revisões utilizadas.
As notas de pesquisa registram as fontes oficiais consultadas e as decisões de apresentação. A compatibilidade do notebook corresponde às revisões fixadas no instalador, e não a todos os recursos das versões mais recentes dos projetos externos.