איך להקים פרויקט Python מהיר וניתן לשחזור עם uv

כשאתם מפנים סוכן קידוד מבוסס בינה מלאכותית כמו Claude Code או Codex אל פרויקט Python, מחצית מהחיכוך אינה קשורה כלל למודל. היא נובעת מהסביבה: חבילות חסרות, גרסת Python שגויה, virtualenv שהסוכן שכח להפעיל, או חבר צוות ש"אצלי זה עובד". התיקון הוא פרויקט שהוא ניתן לשחזור כברירת מחדל, והדרך המהירה ביותר להשיג כזה כיום היא uv, שרשרת הכלים של Python המבוססת על Rust מבית Astral.

uv מחליפה את pip, venv, pip-tools ו-pyenv בפקודה מהירה אחת, והיא כותבת lockfile כך שאותו עץ תלויות בדיוק מותקן בכל מקום. המדריך הזה לוקח אתכם מאפס לפרויקט נעול ובר-הרצה תוך כמה דקות.

למה הסביבה חשובה לסוכן

סוכן בינה מלאכותית מריץ פקודות ב-shell שלכם וקורא את השגיאות שחוזרות. אם בפרויקט שלכם אין תלויות מוצהרות ואין גרסת Python מקובעת, הסוכן צריך לנחש — וניחוש שגוי שולח אותו למסע מתיש של התקנת חבילות גלובלית או עריכת המפרש השגוי. פרויקט עם pyproject.toml ועם uv.lock מעניק לסוכן מקור אמת יחיד: הוא יכול להריץ uv sync, לקבל את החבילות הנכונות ולהמשיך הלאה. אתם משקיעים את זמן הבדיקה שלכם בלוגיקה, ולא בארכיאולוגיה של סביבות.

התקנת uv

ב-macOS או ב-Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

ב-Windows (PowerShell):

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

uv היא קובץ בינארי יחיד ועצמאי, כך שאין שום דבר נוסף להגדיר.

פתיחת פרויקט בפקודה אחת

uv init weather-cli
cd weather-cli

זה מקים פרויקט עובד: pyproject.toml עבור מטא-נתונים ותלויות, קובץ .python-version, קובץ main.py להתחלה, README.md ו-.gitignore. אתם לא יוצרים או מפעילים virtualenv ידנית — uv מנהלת עבורכם .venv ברגע שאתם זקוקים לו.

הוספת תלויות (ולמה ה-lockfile חשוב)

uv add requests

זה עושה שלושה דברים בבת אחת: רושם את requests ב-pyproject.toml, פותר את עץ התלויות המלא, וכותב את uv.lock עם גרסאות מקובעות מדויקות וחוצות-פלטפורמות. ניתן לקבע גם בזמן ההוספה:

uv add 'requests==2.31.0'

בצעו commit ל-uv.lock ב-Git. זהו ההבדל בין "התקן את גרסת requests האחרונה" (שמתקדמת ומשתנה עם הזמן) לבין "התקן בדיוק את העץ שבדקנו". כשהסוכן שלכם — או ה-CI שלכם, או חבר צוות חדש — מריץ uv sync, הם מקבלים סביבה זהה בית-אחר-בית.

הרצת קוד בלי להפעיל שום דבר

uv run main.py

uv run מוודא שהסביבה מסונכרנת, ואז מריץ בתוכה — בלי ריקוד של source .venv/bin/activate. זה חשוב במיוחד לסוכנים: כל קריאת כלי היא לרוב shell חדש, כך ש"הפעל ואז הרץ" נשבר לעיתים קרובות, בעוד ש-uv run יחיד תמיד עובד. אפשר לעטוף כל פקודה:

uv run -- pytest -q
uv run -- flask run -p 3000

קיבוע גרסת Python כדי שהסוכן וה-CI יסכימו

uv python pin 3.12

זה כותב את הגרסה לתוך .python-version, ו-uv תוריד ותשתמש במפרש הזה אוטומטית — בלי צורך ב-Python מערכתי. כעת הגרסה שאתם מפתחים מולה היא הגרסה שהסוכן שלכם, חברי הצוות שלכם וה-CI שלכם משתמשים בה כולם.

דוגמה קצרה ומעובדת

נניח שאתם מבקשים מסוכן "להוסיף פקודה שמביאה את מזג האוויר של היום". כש-uv במקום, כל הלולאה נקייה:

uv init weather-cli && cd weather-cli
uv add requests
uv python pin 3.12
# the agent edits main.py to call an API...
uv run main.py

הסוכן לעולם אינו צריך להסיק איזה מפרש פעיל או האם requests מותקן — העובדות האלה מוצהרות בקבצים שהוא יכול לקרוא. אם הוא מכניס תלות חדשה, הוא מריץ uv add וה-lockfile מתעדכן. אם משהו נשבר ב-CI, uv sync משחזר את הסביבה המדויקת באופן מקומי כדי שתוכלו לנפות אותה.

לאן uv צועדת

uv וכלי האחות שלה ruff (linter/formatter) ו-ty (type checker) מאומצים בהיקף רחב — uv לבדה רואה הרבה יותר מ-100 מיליון הורדות בחודש. במרץ 2026, OpenAI הסכימה לרכוש את Astral, החברה שמאחוריהם, כדי לקפל את שרשרת הכלים לתוך פלטפורמת Codex שלה, תוך התחייבות לשמור על הכלים בעלי רישיון ה-MIT כקוד פתוח (OpenAI, Simon Willison). לעת עתה המסקנה המעשית אינה משתנה: uv היא הנתיב המהיר ביותר לפרויקט Python שסוכן הבינה המלאכותית שלכם יכול לבנות עליו בלי לנחש.

הפניה מהירה

משימה	פקודה
יצירת פרויקט	uv init <name>
הוספת תלות	uv add <package>
קיבוע Python	uv python pin 3.12
הרצת קוד	uv run <file or command>
שחזור הסביבה	uv sync
עדכון ה-lockfile	uv lock --upgrade-package <pkg>