Phase 00: Setup & Tooling

Git & Collaboration

Việc kiểm soát phiên bản không phải là tùy chọn, mỗi thí nghiệm, mỗi mô hình, mỗi bài học mà bạn tạo ra ở đây đều được theo dõi.

Type: Learn

Languages: --

Prerequisites: Phase 0, Lesson 01

Time: ~30 minutes

Mục tiêu học tập

Thiết lập kit nhận dạng và sử dụng dòng công việc hàng ngày của thêm, tham gia, và đẩy
Tạo và hợp nhất các chi nhánh cho các thí nghiệm riêng biệt mà không phá vỡ chính
Hãy viết một .gitignorekhông bao gồm các điểm kiểm soát mô hình và các tệp nhị phân lớn
Di chuyển lịch sử tham gia với git logđể hiểu sự phát triển của dự án

Vấn đề

Bạn sắp viết hàng trăm tập tin mã trên 20 giai đoạn mà nếu không có kiểm soát phiên bản bạn sẽ mất công việc, phá vỡ những thứ bạn không thể hủy bỏ và không có cách để hợp tác với người khác.

Git là công cụ. GitHub là nơi mà mã sống. Bài học này bao gồm những gì bạn cần cho khóa học này và không có gì hơn thế.

Khái niệm

sequenceDiagram
    participant WD as Working Directory
    participant SA as Staging Area
    participant LR as Local Repo
    participant R as Remote (GitHub)
    WD->>SA: git add
    SA->>LR: git commit
    LR->>R: git push
    R->>LR: git fetch
    LR->>WD: git pull

Ba điều cần nhớ:

Tiết kiệm thường xuyên (git commit(văn)
Nhấn lên điều khiển từ xa (git push(văn)
Chi nhánh cho thí nghiệm (git checkout -b experiment(văn)

Hãy xây dựng nó

Bước 1: Cài đặt git

bash

git config --global user.name "Your Name"
git config --global user.email "you@example.com"

Bước 2: Phương trình làm việc hàng ngày

bash

git status
git add file.py
git commit -m "Add perceptron implementation"
git push origin main

Bước 3: Nhóm phân nhánh cho các thí nghiệm

bash

git checkout -b experiment/new-optimizer

# ... make changes, commit ...

git checkout main
git merge experiment/new-optimizer

Bước 4: Làm việc với khóa học repo này

Bạn không thể đẩy đến khóa học repo chính nó chỉ có người bảo trì có quyền truy cập viết. Nhập nó trên GitHub trước (phím nhập, bên phải trên) vì vậy originĐiểm trong bản sao của bạn:

bash

git clone https://github.com/YOUR-USERNAME/ai-engineering-from-scratch.git
cd ai-engineering-from-scratch

git checkout -b my-progress
# work through lessons, commit your code
git push origin my-progress

Sử dụng nó

Để thực hiện khóa học này, bạn cần những lệnh này:

Command	When
`git clone`	Get the course repo
`git add` + `git commit`	Save your work
`git push`	Back it up to GitHub
`git checkout -b`	Try something without breaking main
`git log --oneline`	See what you've done

Đó là tất cả, không cần rebase, cherry-pick, hoặc submodules cho khóa học này.

Các bài tập

Cửa ra cái repo này, nhân bản chiếc cành của bạn, tạo ra một nhánh tên là my-progress, tạo một tập tin, tham gia nó, đẩy nó
Tạo ra một .gitignoreKhông bao gồm các tập tin kiểm soát mẫu (.pt- .pth- .safetensors(văn)
Nhìn vào lịch sử tham gia của repo này với git log --onelinevà đọc những bài học được thêm vào

Những gợi ý

Exercise 1.Nhấp vào Fork trên GitHub, sau đó git cloneURL của fork của bạn.git push -u origin my-progress, mở fork của bạn trên GitHub và xác nhận rằng danh sách chi nhánh hiển thị my-progressvới hồ sơ của anh.

Exercise 2.Thêm một mẫu cho mỗi mở rộng, ví dụ như *.pt, đến một .gitignorefile trong nguồn kho. tạo một file trống với mỗi phần mở rộng và chạy git status; không có một trong số đó có thể xuất hiện trong danh sách các tệp không theo dõi.

Exercise 3.Đi chạygit log --onelineVà sau đógit log --oneline -- phases/00-setup-and-toolingchỉ hiển thị các commit đã thay đổi giai đoạn này. chọn một commit và chạygit show --stat <hash>để xem nó thêm vào những tập tin bài học nào.

Các điều khoản chính

Term	What people say	What it actually means
Commit	"Saving"	A snapshot of your entire project at a point in time
Branch	"A copy"	A pointer to a commit that moves forward as you work
Merge	"Combining code"	Taking changes from one branch and applying them to another
Remote	"The cloud"	A copy of your repo hosted somewhere else (GitHub, GitLab)

This free lesson is part of the AI Engineering from Scratch curriculum. Read the full explanation, run the lesson code, and verify the result in the interactive reader or from the repository source.

Browse the complete course catalog or open this lesson on GitHub.