AI Engineering: Hands-on
Stars
Forks
PRs
Issues
Contributors
License
<img width="2000" height="600" alt="image" src="https://github.com/user-attachments/assets/0c161d9a-3227-4dd7-a416-ad97bc9742a9" />
AI 엔지니어가 되기 위한 완전하고 실습 중심의 가이드입니다.
이 저장소는 여러분이 AI를 기본 원리(first principles)부터 배우고, 실제 신경망을 구축하며, 최신 LLM 시스템을 처음부터 끝까지 이해할 수 있도록 설계되었습니다.
수학, PyTorch, 딥러닝 (deep learning), 트랜스포머 (transformers), RAG, OCR 등을 거치며, 모든 단계에서 직관적이고 깔끔한 Jupyter 노트북이 여러분을 안내합니다.
초보자든 역량을 강화하려는 엔지니어든, 이 저장소는 실제 AI 시스템을 구축하는 데 필요한 명확성, 구조, 그리고 통찰력을 제공할 것입니다.
⭐ 이 저장소에 별표하기 (Star This Repo)
유용한 것을 배우셨다면, 별표를 눌러주시면 감사하겠습니다.
저장소 구조
1. 수학 기초 (Math Fundamentals)
- 수학 함수, 미분(derivatives), 벡터(vectors), 그리고 기울기(gradients)
- 행렬 연산 및 선형 대수학 (linear algebra)
- 확률 및 통계 (Probability and statistics)
2. PyTorch 기본 (PyTorch Basics)
- 텐서(tensors) 생성 및 조작
- 행렬 곱셈, 전치(transposing), 및 재구성(reshaping)
- 인덱싱(indexing), 슬라이싱(slicing), 및 텐서 연결(concatenating)
- 특수 텐서 생성 함수
3. 신경망 (Neural-Network, NN)
- 뉴런, 레이어, 네트워크를 처음부터 구축하기
- 정규화 기법 (RMSNorm)
- 활성화 함수 (Activation functions)
- 옵티마이저 (Adam, Muon) 및 학습률 감소(learning rate decay)
- 어텐션(Attention) 및 셀프-어텐션 메커니즘 (self-attention mechanisms)
- 멀티-헤드 어텐션 (Multi-head attention)
- 디코더 전용 트랜스포머 아키텍처 (Decoder-only transformer architecture)
5. 검색 증강 생성 (Retrieval-Augmented Generation, RAG)
- RAG 파이프라인 처음부터 끝까지 구축하기
- 인덱싱(Indexing), 검색(retrieval), 청킹 전략(chunking strategies)
- 임베딩 모델 및 벡터 스토어와의 통합 (Integrations with embedding models and vector stores)
- 클라우드 LLM 지원: Atlas Cloud (기본값:
deepseek-ai/DeepSeek-V3-0324), MiniMax (M3), OpenAI, 또는 더 풍부한 답변 생성을 위한 모든 OpenAI 호환 API
6. 광학 문자 인식 (OCR)
- OCR 파이프라인 및 유틸리티
- 이미지 전처리 및 텍스트 추출
7. 추가 모듈
번호가 매겨진 학습 트랙 외에도, 이 저장소에는 다음 폴더들이 포함되어 있습니다:
- LLM: LLM 기초, 토큰, 그리고 토큰 임베딩
- Fine-Tuning: LoRA, QLoRA, 및 Unsloth 파인튜닝 노트북
- Basic ML Model Implementation: 고전적인 지도 학습 및 비지도 학습 ML 노트북
- DL: 프로덕션 스타일 서빙(FastAPI / Streamlit)을 갖춘 딥러닝 프로젝트
- Brazil-Ecommerce-Data-Analysis: Olist 데이터셋에 대한 탐색적 데이터 분석
- YoutubeMCP: YouTube 스크립트를 가져오기 위한 최소 MCP 서버
- Interview Prep, Books, Data, Start_here: 지원 리소스 및 샘플 데이터
프로젝트 구조
저장소의 상세 지도:
ai-hands-on/
├── README.md # 이 파일
├── LICENSE # MIT 라이선스
...
폴더 가이드
| 폴더 | 유형 | 내용 |
|---|
Start_here/ | 가이드 | 저장소의 순서대로 진행할 학습 경로 |
| ... | | |
도서
이해도를 높이는 데 추천되는 독서 자료 (포함되어 있지 않음):
- Chip Huyen 저,
AI Engineering
- Aurélien Géron 저,
Hands-On Machine Learning with Scikit-Learn, Keras, and TensorFlow
- Ian Goodfellow, Yoshua Bengio, Aaron Courville 저,
Deep Learning
- Trevor Hastie, Robert Tibshirani, Jerome Friedman 저,
The Elements of Statistical Learning
- Michael Nielsen 저,
Neural Networks and Deep Learning
- Anthony Molinaro 저,
SQL Cookbook
AI/ML 관련 더 많은 책을 원하시면, 제가 이 여기 확인에 다른 저장소를 만들었습니다. 앞으로 며칠/몇 달 동안 훨씬 더 많이 추가할 예정입니다. 만약 책 읽기에 관심이 있으시다면, 이 저장소를 확인해 보세요.
학습 경로
자료들을 단계별로 추천하는 진행 순서는 Learning Path를 참고하세요:
Start_here/learning_path.md
요구사항
다음 명령어로 종속성을 설치하세요:
pip install -r requirements.txt
일부 하위 폴더(예: 5.RAG/ 및 6.OCR/)는 추가적인 종속성을 포함하는 자체 requirements.txt를 가지고 있습니다.
사용법
권장 워크플로우:
- 프로젝트 루트에서 Jupyter를 엽니다:
jupyter lab
또는
jupyter notebook
2. 순서대로 노트북을 진행합니다:
- `1.Math/`
- `2.PyTorch/`
- `3.Neural-Network(NN)/`
- `4.Transformer/`
3. 별도로 실행할 폴더:
- `5.RAG/`
- `6.OCR/`
- `DL/ANN-CNN Prod/`, `DL/RNN-LSTM Prod/`, `DL/RNN-LSTM-GRU/` (각각 자체 README 및 requirements 보유)
- `YoutubeMCP/` (Python 3.12+ 및 `uv` 필요)
4. 리소스
5. 기본 ML 모델 구현 (Supervised + Un-supervised + RL)
- `1.Linear Regression`
- `2.Logistic Regression`
- `3.Decision Tree Model`
- `4.Naive Bayes Classification`
## 머신러닝 프레임워크
| 도구 | 카테고리 | 링크 |
| :--- | :--- | :--- |
| Scikit-learn | 전통적 ML (Traditional ML) | [https://scikit-learn.org/stable/](https://scikit-learn.org/stable/) |
| ... | | |
## 생성형 AI 참고 자료
| 리소스 (Resource) | 초점 영역 (Focus Area) | 링크 (Link) |
| :--- | :--- | :--- |
| Microsoft Generative AI for Beginners | GenAI 입문 (Intro to GenAI) | [https://github.com/microsoft/generative-ai-for-beginners](https://github.com/microsoft/generative-ai-for-beginners) |
| ... | | |
| Understanding Reasoning LLMs | 추론 이론 (Reasoning theory) | [https://magazine.sebastianraschka.com/p/understanding-reasoning-llms](https://magazine.sebastianraschka.com/p/understanding-reasoning-llms) |
| Understanding Multimodal LLMs | 비전 + 텍스트 모델 (Vision + text models) | [https://magazine.sebastianraschka.com/p/understanding-multimodal-llms](https://magazine.sebastianraschka.com/p/understanding-multimodal-llms) |
| LLM 미세 조정 (Finetuning LLMs) | 모델 훈련 (Model training) | [https://magazine.sebastianraschka.com/p/finetuning-large-language-models](https://magazine.sebastianraschka.com/p/finetuning-large-language-models) |
| Transformer LLM 작동 방식 (How Transformer LLMs Work) | 아키텍처 (Architecture) | [https://www.deeplearning.ai/short-courses/how-transformer-llms-work/](https://www.deeplearning.ai/short-courses/how-transformer-llms-work/) |
| GPT를 처음부터 구축하기 (Build GPT from Scratch) | 실습 (Hands-on) | [https://www.youtube.com/watch?v=kCc8FmEb1nY](https://www.youtube.com/watch?v=kCc8FmEb1nY) |
| ... |
## 기여하기
기여를 환영합니다!
다음 사항을 확인해 주세요:
- Notebooks는 깨끗하게 유지합니다 (커밋 전 재시작 및 전체 실행).
- 기존 구조 및 명명 규칙을 따릅니다.
- PR(Pull Request)은 초점을 맞추고, 읽기 쉬우며, 문서화되어야 합니다.
- RAG나 OCR 같은 폴더에서는 정리된 구조를 유지해 주십시오.
- 새로운 폴더를 추가하려면 적절한 구조 방식을 사용하십시오.
## 라이선스 (License)
- 이 프로젝트는 MIT License 하에 라이선스가 부여됩니다. 자세한 내용은 `LICENSE` 파일을 참조하십시오.
## 저와 연결하기 (Connect with me)
[](https://x.com/techwith_ram)
[](https://instagram.com/techwith.ram)
[](https://github.com/Ramakm)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60