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ớ:

  1. Tiết kiệm thường xuyên (git commit(văn)
  2. Nhấn lên điều khiển từ xa (git push(văn)
  3. 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

bashgit 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

bashgit 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

bashgit 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:

bashgit 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:

CommandWhen
git cloneGet the course repo
git add + git commitSave your work
git pushBack it up to GitHub
git checkout -bTry something without breaking main
git log --onelineSee 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

  1. 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ó
  2. 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)
  3. 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

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

TermWhat people sayWhat 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.