Explore a documentação »
Contribuir
·
Ver exemplos
·
Guia de contribuição
IA4Noobs é um guia introdutório de Inteligência Artificial para pessoas que estão começando e querem entender, sem enrolação, como as IAs modernas funcionam e como usá-las bem no dia a dia e em projetos.
A proposta é sair do "eu uso o ChatGPT, mas não sei o que acontece por trás" para um entendimento prático: o que são tokens e contexto, como escrever bons prompts, o que são embeddings, RAG, agents, tools e MCP, e o que muda quando você leva uma aplicação de IA para produção.
Este guia foca em conceitos e prática, não em matemática pesada. Você não precisa saber cálculo nem treinar modelos para aproveitar.
Este material foi pensado para quem:
- usa (ou quer usar) ferramentas como ChatGPT, Claude ou Gemini e quer entender o que está acontecendo;
- é desenvolvedor(a) e quer começar a construir aplicações com IA;
- ouviu falar de "prompt engineering", "RAG", "agents" e "MCP", mas se perde nos termos;
- quer uma base sólida em português antes de partir para conteúdos mais avançados.
Antes de começar, é útil ter:
- curiosidade e vontade de testar as coisas;
- uma conta em alguma ferramenta de IA (ChatGPT, Claude, Gemini ou similar);
- noções básicas de programação para os módulos 4, 5 e 6 (os primeiros não exigem código);
- um editor de código, se quiser rodar os exemplos.
Não precisa ser especialista. A ideia é aprender errando, testando e perguntando.
O guia é dividido em 7 módulos. Você pode ler na ordem ou pular para o que mais interessa.
- 00 - Introdução
- 01 - O que é Inteligência Artificial
- 02 - O que é IA Generativa
- 03 - IA Multimodal
- 04 - Como o ChatGPT funciona
- 05 - O que são Tokens
- 06 - O que é Janela de Contexto
- 07 - Escolhendo o modelo certo
- 08 - O que é Prompt Engineering
- 09 - Como fazer perguntas melhores
- 10 - Few-shot e Chain-of-Thought
- 11 - Como estruturar respostas
- 12 - Principais erros ao usar IA
- 16 - O que é um Agent
- 17 - O que é uma Tool
- 18 - O que são Skills
- 19 - Arquitetura básica de Agents
- 20 - Multi-Agent Systems
- 24 - Rodando modelos localmente
- 25 - Como criar aplicações com IA
- 26 - Segurança em IA
- 27 - Como avaliar respostas de IA
- 28 - Custos e Escalabilidade
Este repositório também traz exemplos pequenos para praticar:
- Prompts: ruim vs bom — comparando prompts e por que alguns funcionam melhor.
- Sua primeira chamada de API — o "Hello World" de falar com um LLM via código.
- Few-shot na prática — zero-shot vs few-shot na mesma tarefa, lado a lado.
- Rodando um modelo local — chamando um LLM na sua máquina com Ollama, sem chave de API.
- RAG mínimo em Python — busca por similaridade explicada com código comentado.
- Servidor MCP "Hello World" — um MCP server mínimo para entender a estrutura.
Uma sugestão simples:
- Leia um capítulo.
- Teste o conceito em uma ferramenta de IA real.
- Mude algo pequeno no prompt ou no exemplo.
- Repare no que mudou na resposta.
- Explique o conceito com suas próprias palavras.
IA se aprende conversando com ela. Tenha uma janela de chat aberta enquanto lê.
Terminou o guia e quer ir mais fundo? Alguns materiais gratuitos e de qualidade:
- CS50's Introduction to Artificial Intelligence with Python (Harvard) — curso gratuito e clássico sobre os fundamentos da IA (busca, otimização, machine learning) com projetos em Python. É mais técnico e matemático que este guia, então é um ótimo próximo passo depois daqui.
- Documentação da Anthropic e da OpenAI — referências oficiais para construir aplicações, com guias de prompt, agents e boas práticas.
- Índice do 4noobs — guias de várias linguagens e tecnologias da comunidade HE4RT para fortalecer sua base.
Contribuições fazem com que a comunidade open source seja um lugar incrível para aprender, inspirar e criar. Todas contribuições são extremamente apreciadas — e este guia tem espaço de sobra para a sua.
- Realize um Fork do projeto
- Crie um branch com a sua contribuição (
git checkout -b feature/featureBraba) - Realize o Commit (
git commit -m 'Adicionado conteudo brabo') - Realize o Push no Branch (
git push origin feature/featureBraba) - Abra um Pull Request
Quer o passo a passo detalhado, padrões de escrita e ideias do que fazer? Leia o CONTRIBUTING.md. Não sabe por onde começar? Procure as issues com a label good first issue ou abra uma usando os nossos templates de issue.
Quando o guia estiver revisado e publicado no GitHub, use o arquivo PUBLISHING.md para preparar a entrada no índice principal do he4rt/4noobs.
- Elves S. - Autor - @sirelves
- IA4Noobs contributors - Comunidade
