1. Foto, bio e pin de projetos
Recrutadores de tech abrem o GitHub em segundos. Se a página parecer abandonada ou confusa, a chance de avançar cai. O bom é que dá para melhorar isso em um fim de semana.
- Foto profissional (mesmo que casual e bem iluminada)
- Bio com o que você faz + o que busca (ex.: “Dev Python · automações e APIs · aberto a oportunidades remotas”)
- Pin 4–6 repositórios que mostram variedade e profundidade
2. README do perfil (profile README)
Crie um repositório com o mesmo nome do seu usuário. O README vira a capa do perfil. Inclua: quem você é, stack, 2–3 projetos em destaque com link e uma seção “como entrar em contato”.
3. Cada projeto precisa de README de verdade
Não basta o código. Todo repositório público sério deve ter:
- O que o projeto faz (1 parágrafo)
- Como rodar localmente (comandos copiáveis)
- Stack e pré-requisitos
- Screenshot ou GIF se for interface
- Licença (MIT é o mínimo comum)
4. Commits legíveis
Evite “update” e “fix”. Prefira mensagens no estilo: feat: validar CPF no formulário de cadastro. Histórico limpo mostra profissionalismo.
5. Projetos que impressionam (sem inventar)
- API com autenticação e documentação (OpenAPI/Swagger)
- Automação que resolve um problema real (planilha, e-mail, scraping ético)
- Deploy público (Vercel, Railway, VPS) com URL no README
Checklist rápido
[ ] Bio e localização preenchidas
[ ] 4+ repos pinados com README completo
[ ] Profile README com stack e contato
[ ] Pelo menos 1 projeto deployado
[ ] Activity recente (commits nos últimos 30 dias)Quer base técnica para montar esses projetos? Veja os cursos gratuitos de Python, Docker e Linux.
6. Modelo de README para cada projeto
# Nome do projeto
Uma frase: o que faz e para quem.
## Como rodar
git clone https://github.com/usuario/projeto.git
cd projeto
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python app.py
## Stack
Python 3.12, FastAPI, SQLite
## Licença
MIT| Comando | O que faz |
|---|---|
git clone <url> | copia o repositório para a sua máquina |
cd projeto | entra na pasta do projeto |
python3 -m venv .venv && source .venv/bin/activate | cria e ativa o ambiente isolado; o && só ativa se a criação der certo |
pip install -r requirements.txt | instala as dependências do projeto |
python app.py | inicia a aplicação |
Com esses comandos no README, quem chega ao seu repositório consegue rodar o projeto em minutos, e isso conta a seu favor.
7. Commits: antes e depois
| Mensagem fraca | Mensagem clara |
|---|---|
update | feat: validar CPF no formulário de cadastro |
fix | fix: corrigir cálculo de frete acima de R$ 200 |
ajustes | docs: incluir instruções de instalação no README |
| Prefixo | Quando usar |
|---|---|
feat | nova funcionalidade |
fix | correção de erro |
docs | documentação |
chore | manutenção sem mudar o comportamento |
8. O que cada projeto mostra
| Projeto | O que demonstra | Onde aprender |
|---|---|---|
| API com autenticação e documentação | backend, segurança e organização | curso-python-modulo-6 e o artigo de APIs de IA |
| Automação que resolve um problema real | lógica e autonomia | curso-python-modulo-8 |
| Aplicação com deploy público | entrega e operação básica | curso-docker-modulo-6 e GitHub Actions |
O perfil também tem um README próprio: crie um repositório com o mesmo nome do seu usuário (por exemplo, github.com/usuario/usuario) e o arquivo README.md dele vira a capa do perfil.