Por Que Perder Horas Codando Se um AI Agent Faz Tudo Por Você?

Já imaginou ter um assistente digital que cria seu site de portfólio, configura deploy automático e até comita alterações com mensagens semânticas? 🤯 Pois é! Neste artigo, vou te mostrar como usar um projeto open-source que automatiza 100% do processo de criação de portfólios profissionais, usando Python, GitHub Actions e um toque de IA.

Tópicos que você vai dominar:

1. Como clonar e configurar o projeto em 2 cliques.
2. Executar o "mágico" main.py para gerar seu site + pipeline de CI/CD.
3. Fazer alterações no site e commitar sem digitar uma linha de código.
4. Publicar no GitHub Pages como um PRO.

Pronto para economizar 10 horas de trabalho manual? Vamos lá!

Passo 1: Clone o Projeto e Prepare o Ambiente

Estrutura do Repositório

Seu futuro portfólio está organizado assim:

artigo-site-portifolio/  
├── src/                # Códigos Python (os agentes!)  
├── img/                # Gifs e screenshots do projeto  
├── .github/workflows/  # GitHub Actions (criado automaticamente)  
├── site/               # Seu site gerado (HTML/CSS/JS)  
└── requirements.txt    # Dependências do projeto  

Configure Tudo em 3 Comandos

git clone https://github.com/Jcnok/artigo-site-portifolio  
cd artigo-site-portifolio  

# Crie um ambiente virtual (evita conflitos de bibliotecas)  
python -m venv .venv  
source .venv/bin/activate  # No Windows: .venv\Scripts\activate  

# Instale as dependências  
pip install -r requirements.txt  

⚠️ Dica Pro: Nunca exponha suas chaves de API! Crie um arquivo .env na raiz e adicione:

# .env  
AZURE_OPENAI_API_KEY="sua_chave_aqui"  
GITHUB_TOKEN="ghp_sua_chave"  
GITHUB_USERNAME="SeuUser"  
GITHUB_EMAIL="seu@email.com"  

👉 Obtenha a chave da Azure OpenAI aqui.

Passo 2: Execute o Script Mágico e Assista a IA Trabalhar

python src/main.py  

O que acontece?

1. Criação do Site: O SiteCreatorAgent gera:

• site/index.html (HTML semântico e responsivo).
• site/css/style.css (estilos modernos).
• site/js/main.js (scroll suave e interações).

1. Configuração DevOps: O DevOpsAgent:

• Cria um workflow em .github/workflows/deploy.yml.
• Faz commit automático com mensagem semântica (ex: feat(ui): atualização 20240605).
• Envia tudo para a branch main do GitHub.

1. Deploy Automático: O GitHub Actions detecta o push e faz deploy para a branch gh-pages.

🎉 Pronto! Seu site já está no ar em:

https://seu-usuario.github.io/artigo-site-portifolio/

Passo 3: Faça Alterações no Site Sem Suar

Exemplo: Adicione um Novo Projeto

1. Edite site/index.html manualmente (ou use seu editor favorito).
2. Commite Automaticamente:

python src/commit.py  # Usa o CommitChangesTool!  

1. 👉 O script detecta mudanças, gera uma mensagem semântica e faz push para o GitHub.

Resultado:

• O GitHub Actions atualiza o site em segundos.
• Nada de git add ., git commit -m "...", git push manual!

Dicas de Ouro Para Turbinar Seu Portfólio

1. Personalize o CSS

• Edite site/css/style.css para mudar cores, fontes ou animações.
• Use variáveis CSS para temas claros/escuros:

:root {  
--primary-color: #2A2A2A;  
--secondary-color: #F5F5F5;  
}  

2. Adicione Imagens e GIFs

• Coloque assets em img/ e referencie no HTML:

<img src="img/seu-projeto.gif" alt="Demo do projeto">  

3. Ative o SEO

• Edite as meta tags no index.html:

<meta name="description" content="Portfólio de [Seu Nome] - Especialista em Python e IA">  

Configurações Pós-Deploy (Essenciais!)

1. Ative o GitHub Pages:

• Acesse: https://github.com/seu-usuario/artigo-site-portifolio/settings/pages
• Selecione a branch gh-pages como fonte.

1. Libere as Permissões do Workflow:

• Vá em: https://github.com/seu-usuario/artigo-site-portifolio/settings/actions
• Em "Workflow permissions", marque: Read and write permissions.

Por Que Esse Projeto é um Tiro Certo Para Sua Carreira?

• Economia de Tempo: Crie um portfólio profissional em minutos, não horas.
• Best Practices Inclusas: SEO, responsividade, commits semânticos e CI/CD.
• Facilidade de Manutenção: Altere o site e commite como um ninja com commit.py.
• Portfólio = Vitrine: Mostre suas habilidades em IA, DevOps e automação!

Conclusão: Seu Futuro Profissional Começa Agora!

Este projeto não é só um gerador de portfólios – é um case prático de como Python e IA podem automatizar workflows complexos. E o melhor: você pode adaptá-lo para criar sites para clientes, projetos pessoais ou até mesmo um blog técnico!

Quer se Destacar na Competição?

• Engaje: Compartilhe este artigo e peça feedback nos comentários!
• Inove: Adicione novas features ao projeto (ex: tema escuro/claro automático).
• Colabore: Faça um fork no GitHub e contribua com a comunidade!

🔗 Links Úteis:

• Repositório do Projeto
• Documentação do GitHub Pages
• Community Week: AI Agents

💬 Deixe nos comentários: Qual parte do projeto mais te surpreendeu? Vamos debater!

Com 💙 por Julio Okuda, Dev Python e entusiasta de IA.