התקנת Pi והגדרת OmniProxy

Pi הוא עוזר טרמינל קטן—תוכנית שמשוחחת איתך ישירות בשורת הפקודה, קוראת קבצים ומשלימה משימות. יש לו הנחיית מערכת קצרה ורק כמה כלים כברירת מחדל. אם אתה צריך פקודות, תהליכי עבודה או ממשקים אחרים, תוכל להוסיף אותם מאוחר יותר דרך תוספים. תוספים הם רכיבים שמוסיפים יכולות ל-Pi, ותוכל לשתף אותם עם אחרים לאחר יצירתם.

סוכני משנה מאצילים חלק ממשימה לעוזר אחר, בעוד שמצב תכנון מארגן את השלבים לפני תחילת הביצוע. אף תכונה אינה כלולה כברירת מחדל, אך תוכל לבקש מ-Pi לבנות אותן או להתקין חבילות ששותפו על ידי אחרים.

לפני שמתחילים

macOS ו-Linux משתמשים בסקריפט התקנה—פקודה אחת שמורידה ומתקינה את Pi באופן אוטומטי. ב-Windows, השתמש בפקודת PowerShell המסופקת בדף הבית של Pi. PowerShell היא סביבת שורת הפקודה הכלולה ב-Windows. ניתן גם להתקין את Pi ב-WSL, סביבת ה-Linux הזמינה בתוך Windows.

אם תבחר להתקין עם npm, אתה צריך Node.js 22.19 ומעלה. npm הוא מנהל החבילות המשמש עם Node.js ויכול להתקין את Pi משורת הפקודה.

macOS Linux

install.sh

• curl הסקריפט הרשמי
• המתקין מצמיד את התלויות
• עדכן עם pi update

Windows

install.ps1

• פקודת PowerShell רשמית
• Git for Windows מספק Bash
• ניתן גם להשתמש ב-WSL

Node כבר מותקן

npm

• דורש Node 22.19+
• שם החבילה הוא pi-coding-agent
• הוסף --ignore-scripts

התקנה והפעלה של Pi בפעם הראשונה

ב-macOS או Linux, פתח טרמינל והרץ:

curl -fsSL https://pi.dev/install.sh | sh

ב-Windows, פתח PowerShell והרץ:

powershell -c "irm https://pi.dev/install.ps1 | iex"

אם Node.js 22.19 ומעלה כבר מותקן, ניתן להשתמש גם בפקודה החלופית מה-Quickstart:

npm install -g --ignore-scripts @earendil-works/pi-coding-agent

סקריפט ההתקנה עשוי לעצור כדי לשאול שאלות בטרמינל אינטראקטיבי. עקוב אחר ההנחיות על המסך כדי להמשיך. אם כבר יש לך גרסה תואמת של Node, פקודת npm זו לא תשאל שאלות. כדי להתקין את Pi בספרייה אחרת, הוסף --prefix /your/directory. ב-09-10-2026, זה התקין את Pi 1.1.0.

התקנת npm רגילה אינה דורשת סקריפטים של מחזור חיים של תלויות, שהם סקריפטים שחבילות מריצות באופן אוטומטי במהלך ההתקנה. סקריפט ההתקנה מצמיד תלויות; לאחר מכן, עדכן את Pi עם pi update. עבור התקנת npm, השתמש בשיטת העדכון המסופקת על ידי מנהל החבילות שלך. משתמשי Nix צריכים להתקין מה-flake של Pi. flake הוא הגדרת Nix המתארת תוכנה ותלויותיה, ו- pi update אינו יכול לעדכן התקנת Nix.

לאחר ההתקנה, ראשית ודא שהטרמינל שלך יכול למצוא את Pi:

pi --version

ב-Windows, אם ברצונך שמודלים יבצעו פקודות Bash, התקנת Git for Windows מומלצת לרוב המשתמשים המקומיים. Bash היא סביבת הפקודה ש-Pi משתמש בה כדי להריץ פקודות מסוימות. Pi בודק את shellPath ההגדרה ב- ~/.pi/agent/settings.json, Git Bash תחת Program Files, ולאחר מכן bash.exe ב-PATH, לפי סדר זה. shellPath מציין את המיקום של Bash, בעוד ש-PATH הוא רשימת הספריות שהמערכת מחפשת בהן פקודות.

לאחר הפעלת Pi, ניתן להזין !printf 'Bash is working\n' כדי לבדוק אותו. אם הקבצים והכלים שלך כבר נמצאים ב-WSL, התקן את Pi בסביבת Linux זו על ידי ביצוע ה-Quickstart.

לאחר מכן, היכנס לתיקייה שברצונך ש-Pi יבדוק או יעבוד עליה, ולאחר מכן הפעל אותו:

cd /path/to/folder
pi

תיקייה זו הופכת להיקף העבודה הנוכחי של Pi. Pi משתמש בה כדי לגלות קבצים והגדרות וכדי לקבץ הפעלות.

קבלת ערכי חיבור מ-OmniProxy

ראשית, השג את שלושת הערכים הללו מ-OmniProxy:

baseUrl: https://your-omniproxy-origin.example/v1
apiKey:  <YOUR_OMNIPROXY_API_KEY>
Model ID: Copy the full ID from the current OmniProxy model list

baseUrl הוא נקודת הקצה של ה-API שאליה Pi שולח בקשות, והוא חייב לכלול /v1. apiKey הוא המפתח המשמש לגישה ל-API. Model ID הוא שם המודל לקריאה וחייב להיות מועתק במלואו מרשימת המודלים הנוכחית של OmniProxy.

הגדר את api ל- openai-completions, כפי שמוצג בדוגמת ה-API התואם. שדה זה אומר ל-Pi באיזה פורמט API להשתמש בעת שליחת בקשות.

העתק את מזהה המודל המלא, כולל לוכסנים בשם. ב-09-10-2026, שני מזהי ההפניה בתיעוד הספק היו gemini-3.8-flash ו- grok-4.7. אל תעתיק שם שאינו קיים ברשימה.

הזנת הגדרת הכלי

הגדרת המודל המותאם אישית ברמת המשתמש של Pi נשמרת ב- models.json. קובץ זה ממוקם בספריית הסוכן, שברירת המחדל שלה היא ~/.pi/agent, לכן הנתיב המלא שלו הוא ~/.pi/agent/models.json. אם משתנה הסביבה PI_CODING_AGENT_DIR מוגדר, Pi משתמש בספרייה שצוינה על ידי משתנה זה במקום זאת. משתנה סביבה הוא ערך הגדרה המסופק על ידי המערכת עבור תוכניות לקריאה.

הזן את ההגדרה כפי שמוצג בדוגמת ה-API התואם:

{
  "providers": {
    "omniproxy": {
      "baseUrl": "https://your-omniproxy-origin.example/v1",
      "api": "openai-completions",
      "apiKey": "<YOUR_OMNIPROXY_API_KEY>",
      "models": [
        { "id": "gemini-3.8-flash", "input": ["text"] },
        { "id": "grok-4.7", "input": ["text"] }
      ]
    }
  }
}

providers מפרט את השירותים המחוברים, בעוד ש- models מפרט את המודלים שניתן לבחור. לכל מודל id חייב להתאים למזהה המודל המלא ברשימת המודלים הנוכחית של OmniProxy. input מציין שהמודל מוגדר כאן עבור קלט טקסט.

apiKey ניתן להזין כערך מילולי, או כ- $NAME או ${NAME} כך ש-Pi יקרא אותו ממשתנה סביבה. ערך המתחיל ב- ! מטופל כפקודה ומבוצע עבור כל בקשה. אל תשלח מפתח אמיתי למאגר קוד. אם ה-gateway אינו מאמת מפתחות, ניתן להזין מחרוזת מציין מיקום המשמשת רק במחשב המקומי שלך. ב-09-10-2026, Pi קרא בהצלחה את הקובץ עם הגדרה זו.

פתיחת /model טוענת מחדש קובץ זה. /model הוא הממשק ב-Pi לצפייה ובחירת מודלים. מודלים מותאמים אישית אינם מופיעים ב- /model עד ש-Pi יכול לפתור את האישורים שלהם. לאחר בחירת מודל, לחץ על Ctrl+S כדי לשמור אותו כמודל ברירת המחדל עבור הפעלות חדשות.

קובץ

models.json

• ספריית ברירת מחדל: ~/.pi/agent
• הוסף רשומה תחת providers
• הגדר api ל-completions

כתובת

baseUrl

• כלול /v1
• apiKey יכול להפנות למשתנה
• מזהה המודל חייב להיות מדויק

בחר

/model

• פתיחתו טוענת מחדש את הקובץ
• בחר את המודל שהוספת זה עתה
• Ctrl+S שומר אותו כברירת מחדל

אימות עם משימה אמיתית

לאחר השלמת ההגדרה, ניתן לבצע בדיקה לא אינטראקטיבית בספרייה המכילה קבצים. מצב לא אינטראקטיבי אומר ש-Pi משלים משימה יחידה זו ולאחר מכן יוצא במקום להיכנס לשיחה מתמשכת. החלף את הערך אחרי --model במזהה המלא מרשימת OmniProxy הנוכחית:

pi -p --provider omniproxy --model gemini-3.8-flash --tools read "Read the first line of the file you specify. Do not modify the file."

כאן, --tools read מאפשר רק את כלי הקריאה, והמשימה גם מורה במפורש ל-Pi לא לשנות את הקובץ. ב-09-10-2026, Pi 1.1.0 קרא את תוכן הקובץ בהצלחה. התגובה הראשונה לקחה כשתי דקות.

ניתן גם להשתמש במצב אינטראקטיבי: היכנס לספרייה, הרץ pi, ולאחר מכן בחר מודל עם /model. משימה לדוגמה ב-Quickstart מבקשת מ-Pi להסביר כיצד המאגר מאורגן וכיצד להריץ את הבדיקות שלו. שים לב האם הוא קורא את הקבצים ומספק הסבר, לאחר מכן אשר את המקור ומזהה המודל ביומני הבקשות של OmniProxy.

הפעלה

pi מופעל

• ראשית cd לתיקייה
• pi --version מפיק פלט
• שם המודל מופיע בתחתית הממשק

משימה

הוא קרא את הספרייה

• שאל כיצד המאגר מאורגן
• סקור את הקבצים שהוא מפרט
• אל תסתמך רק על שמירת הגדרה מוצלחת

יומנים

גלוי ב-gateway

• המקור הוא Pi
• מזהה המודל תואם
• שמור את המפתח במחשב המקומי

שגיאות נפוצות

• pi לא ניתן למצוא: פתח מחדש את הטרמינל ונסה את pi --version שוב. עבור התקנת npm, ודא שספריית ה-bin הגלובלית נמצאת ב-PATH.
• המודלים המותאמים אישית אינם מופיעים ב- /model: ודא ש- models.json נמצא ב- ~/.pi/agent/, ודא ש- apiKey ניתן לפתרון, ולאחר מכן פתח מחדש את /model.
• Windows מדווח שלא ניתן למצוא את Bash: התקן את Git for Windows, או הגדר את shellPath ב- ~/.pi/agent/settings.json. לוכסנים ב-JSON חייבים להיכתב פעמיים.
• הבקשה נדחית: בדוק ש- api הוא openai-completions ושה- baseUrl מסתיים ב- /v1. אל תפעיל אפשרויות תאימות נוספות רק בגלל שהשירות מתאר את עצמו כתואם.
• מזהה המודל אינו חוקי: העתק אותו שוב מרשימת OmniProxy הנוכחית.

הפניות רשמיות

עבור פקודות התקנה, ראה את Pi website ו-Quickstart. עבור קובץ המודל, ראה Choose a Model ו-Configuration. עבור סביבת הפקודה של Windows, ראה Run Pi on Windows. עבור מזהי המודלים המשמשים בדוגמאות, ראה את Gemini model list ו-xAI models page.

החלף כל מקום לשימוש בערכים מההגדרה שלך ב-OmniProxy. לעולם לא פרסם מפתח אמיתי.

תוצאה שמורה או HTTP 200 בלבד אינם מוכיחים תאימות מלאה של הסוכן. בדוק את המקור והמודל ברשומת הקריאה של OmniProxy.

מקורות רשמיים · Pi ↗