🐍 My ML/IA Journey

Um repositório pessoal de aprendizado e prática em Python, Machine Learning e IA.
Documenta minha jornada completa — dos fundamentos ao desenvolvimento de projetos reais.

🎯 Objetivos

• 🎓 Criar uma base sólida em programação Python e em IA/ML, entendendo cada conceito de forma prática e progressiva.
• 💼 Adquirir as competências necessárias para aplicar em estágios na área de IA/ML.
• 🌟 Compartilhar esse caminho para inspirar outras pessoas.

📌 Sumário Rápido

• 🏗️ Estrutura do repositório
• 🛠️ Instalação
• 🧪 Comandos úteis
• 📖 Progresso e estudos
• 🤝 Contribuindo

🏗️ Estrutura do Repositório

ml-ai-journey/
│
├── .github/ # Configurações do GitHub
│ ├── workflows/
│ │ └── python-tests.yml
│ └── ISSUE_TEMPLATE.md
│
├── config/ # Arquivos de configuração (YAML)
│ ├── model_config.yaml
│ └── training_config.yaml
│
├── docs/ # Anotações e materiais de estudo
│ ├── annotations/
│ │ ├── python_fluente/
│ │ │ └── README.md
│ │ └── python_tutorial/
│ │ └── README.md
│ └── progress_log.md
│
├── learning/ # Exercícios resolvidos
│ └── exercises/
│ ├── beecrowd/
│ │ └── beginner/
│ │ └── README.md
│ └── exercise_template.py
│
├── notebooks/ # Análises e explorações em Jupyter
│
├── src/ # Código-fonte dos módulos e scripts
│ ├── data_processing/
│ │ ├── init.py
│ │ └── clean_data.py
│ ├── models/
│ │ ├── init.py
│ │ ├── predict.py
│ │ └── train.py
│ └── utils/
│ ├── init.py
│ └── helpers.py
│
├── tests/ # Testes automatizados
│ ├── integration/
│ └── unit/
│
├── .flake8
├── .gitignore
├── .pre-commit-config.yaml
├── CONTRIBUTING.md
├── LICENSE
├── Makefile
├── pyproject.toml
├── README.md
├── requirements.txt
└── setup.py

🛠️ Instalação

git clone https://github.com/joaohgp-dev/ml-ia-journey.git
cd ml-ia-journey
make install

🧪 Comandos Úteis

make test        # Executa os testes com pytest
make lint        # Roda o linter flake8
make train       # Executa o script de treino com config
make notebook    # Abre o Jupyter Notebook

📖 Progresso e Estudos

Veja o diário completo em docs/progress_log.md. As anotações de estudos estão em:

• docs/annotations/python_tutorial/
• docs/annotations/python_fluente/

🤝 Contribuindo

Este projeto é pessoal, mas sugestões são bem-vindas!

• Faça um fork.
• Crie sua branch: git checkout -b minha-contribuição.
• Commit e push.
• Envie um Pull Request.

Consulte CONTRIBUTING.md para mais detalhes.

Feito com foco em aprendizado real, experimentação e evolução contínua.