Pemasangan Pi dan Konfigurasi OmniProxy

Pi ialah pembantu terminal yang kecil, iaitu program yang berinteraksi dengan anda terus melalui baris perintah, membaca fail dan menyelesaikan tugasan. Gesaan sistemnya ringkas dan alat lalainya juga tidak banyak; jika anda memerlukan arahan, aliran kerja atau antara muka lain, anda boleh menambahnya kemudian melalui sambungan. Sambungan boleh dianggap sebagai komponen yang menambahkan keupayaan kepada Pi dan boleh dikongsi dengan orang lain selepas siap.

Subagen menyerahkan sebahagian tugasan kepada pembantu lain, manakala mod perancangan menyusun langkah terlebih dahulu sebelum pelaksanaan bermula. Kedua-duanya tidak disertakan dalam fungsi lalai. Anda boleh meminta Pi membinanya sendiri atau memasang pakej yang dikongsi oleh orang lain.

Persediaan sebelum pemasangan

macOS dan Linux menggunakan skrip pemasangan, iaitu satu arahan yang memuat turun dan memasang secara automatik. Windows menggunakan arahan PowerShell yang disediakan pada halaman utama Pi; PowerShell ialah persekitaran baris perintah terbina dalam Windows. Anda juga boleh memasang Pi dalam WSL, iaitu persekitaran Linux dalam Windows.

Jika memilih pemasangan melalui npm, anda perlu menyediakan Node.js 22.19 atau versi yang lebih baharu terlebih dahulu. npm ialah pengurus pakej yang digunakan bersama Node.js dan boleh memasang Pi melalui baris perintah.

macOS Linux

install.sh

• Gunakan curl dengan skrip rasmi
• Kebergantungan ditetapkan oleh pemasang
• Gunakan pi update untuk mengemas kini

Windows

install.ps1

• Perintah PowerShell daripada laman rasmi
• Git for Windows menyediakan Bash
• WSL juga boleh digunakan

Node sudah tersedia

npm

• Memerlukan Node 22.19+
• Nama pakej ialah pi-coding-agent
• Tambahkan --ignore-scripts

Pasang dan lancarkan buat kali pertama

Buka terminal pada macOS atau Linux, kemudian jalankan:

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

Buka PowerShell pada Windows, kemudian jalankan:

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

Jika Node.js 22.19 atau versi yang lebih baharu sudah dipasang, anda juga boleh menggunakan arahan alternatif daripada Quickstart:

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

Skrip pemasangan mungkin berhenti untuk mengemukakan soalan dalam terminal interaktif. Teruskan mengikut arahan yang dipaparkan. Jika versi Node yang memenuhi syarat sudah tersedia, arahan npm ini tidak akan mengemukakan soalan. Untuk memasang ke direktori lain, tambahkan --prefix /direktori/anda. Pada 2026-10-09, kaedah ini memasang Pi 1.1.0.

Pemasangan npm biasa tidak memerlukan skrip kitar hayat kebergantungan, iaitu skrip yang dijalankan secara automatik oleh pakej semasa proses pemasangan. Skrip pemasangan akan menetapkan versi kebergantungan dan kemas kini seterusnya dilakukan menggunakan pi update. Bagi pemasangan npm, kaedah kemas kini bergantung pada pengurus pakej yang anda gunakan. Pengguna Nix perlu memasang daripada flake Pi; flake ialah konfigurasi Nix untuk menerangkan perisian dan kebergantungan, dan pi update tidak boleh mengemas kini pemasangan Nix.

Selepas pemasangan selesai, pastikan terminal dapat menemukan Pi:

pi --version

Pada Windows, jika anda mahu model menjalankan arahan Bash, kebanyakan pengguna setempat disarankan memasang Git for Windows. Bash ialah persekitaran arahan yang digunakan oleh Pi untuk menjalankan sesetengah arahan. Pi akan mencari shellPath dalam ~/.pi/agent/settings.json, kemudian Git Bash dalam Program Files, dan selepas itu bash.exe dalam PATH. shellPath digunakan untuk menentukan lokasi Bash, manakala PATH ialah senarai direktori yang digunakan oleh sistem untuk mencari arahan.

Selepas dilancarkan, anda boleh memasukkan !printf 'Bash is working\n' untuk membuat pemeriksaan. Jika fail dan alat anda sudah berada dalam WSL, pasang Pi dalam persekitaran Linux tersebut mengikut Quickstart.

Seterusnya, buka folder yang anda mahu Pi periksa atau proses, kemudian lancarkannya:

cd /path/to/folder
pi

Folder ini akan menjadi skop kerja semasa Pi untuk menemukan fail dan konfigurasi, serta digunakan untuk mengumpulkan sesi.

Dapatkan parameter sambungan daripada OmniProxy

Sediakan tiga perkara berikut daripada OmniProxy terlebih dahulu:

baseUrl: https://your-omniproxy-origin.example/v1
apiKey:  <YOUR_OMNIPROXY_API_KEY>
Model ID: salin ID penuh daripada senarai model OmniProxy semasa

baseUrl ialah alamat antara muka yang digunakan Pi untuk menghantar permintaan dan mesti berakhir dengan /v1. apiKey ialah kunci yang digunakan untuk mengakses antara muka tersebut. Model ID ialah nama model yang akan dipanggil dan perlu disalin sepenuhnya daripada senarai model OmniProxy semasa.

Isi api dengan openai-completions seperti dalam contoh antara muka serasi. Medan ini memberitahu Pi format antara muka yang perlu digunakan untuk menghantar permintaan.

Salin keseluruhan ID model dan kekalkan garis miring dalam namanya. Pada 2026-10-09, dua ID rujukan dalam dokumentasi penyedia ialah gemini-3.8-flash dan grok-4.7. Jangan salin nama yang tidak terdapat dalam senarai.

Isi konfigurasi alat

Konfigurasi model tersuai peringkat pengguna Pi ditulis dalam models.json. Fail ini terletak dalam direktori agent, dengan direktori lalai ~/.pi/agent, maka lokasi penuhnya ialah ~/.pi/agent/models.json. Jika pemboleh ubah persekitaran PI_CODING_AGENT_DIR ditetapkan, Pi akan menggunakan direktori yang ditentukan oleh pemboleh ubah tersebut. Pemboleh ubah persekitaran boleh difahami sebagai nilai konfigurasi yang disediakan oleh sistem untuk dibaca oleh program.

Isi konfigurasi mengikut contoh antara muka serasi:

{
  "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 digunakan untuk menyenaraikan perkhidmatan yang disambungkan, manakala models digunakan untuk menyenaraikan model yang boleh dipilih. id bagi setiap model mesti sepadan dengan Model ID penuh dalam senarai model OmniProxy semasa. input pula menunjukkan bahawa konfigurasi ini menggunakan input teks.

apiKey boleh ditulis terus sebagai nilai literal atau sebagai $NAME atau ${NAME} supaya Pi membacanya daripada pemboleh ubah persekitaran. Nilai yang bermula dengan ! akan dianggap sebagai arahan dan dijalankan bagi setiap permintaan. Jangan komitkan kunci sebenar ke dalam repositori. Jika get laluan tidak mengesahkan kunci, anda boleh mengisi rentetan pemegang tempat yang hanya digunakan pada komputer setempat. Pada 2026-10-09, fail tersebut berjaya dibaca dengan cara ini.

Membuka /model akan memuatkan semula fail ini. /model ialah tempat untuk melihat dan memilih model dalam Pi. Model tersuai tidak akan muncul dalam /model sehingga Pi dapat mentafsir bukti kelayakan. Selepas memilih model, tekan Ctrl+S untuk menyimpannya sebagai model lalai bagi sesi baharu.

Fail

models.json

• Direktori lalai ialah ~/.pi/agent
• Tambahkan satu entri dalam providers
• Gunakan completions untuk api

Alamat

baseUrl

• Akhiri dengan /v1
• apiKey boleh menggunakan pemboleh ubah
• id model mesti tepat

Pemilihan

/model

• Fail akan dimuatkan semula selepas dibuka
• Pilih model yang baru ditambahkan
• Ctrl+S boleh menyimpan sebagai lalai

Sahkan dengan tugasan sebenar

Selepas konfigurasi selesai, anda boleh membuat pemeriksaan bukan interaktif dalam direktori yang mengandungi fail. Bukan interaktif bermaksud Pi tidak memasuki perbualan berterusan dan akan tamat selepas menyelesaikan tugasan ini. Gantikan kandungan selepas --model dengan ID penuh daripada senarai OmniProxy semasa:

pi -p --provider omniproxy --model gemini-3.8-flash --tools read "Baca baris pertama fail yang saya tentukan dan jangan ubah fail tersebut."

Di sini, --tools read hanya membenarkan alat membaca, dan kandungan tugasan juga menyatakan dengan jelas supaya fail tidak diubah. Pada 2026-10-09, Pi 1.1.0 berjaya membaca kandungan fail. Respons pertama mengambil masa kira-kira dua minit.

Anda juga boleh menggunakan kaedah interaktif: buka direktori, jalankan pi, kemudian pilih model melalui /model. Salah satu contoh tugasan dalam Quickstart meminta Pi menerangkan cara repositori ini disusun dan cara menjalankan pemeriksaan. Perhatikan sama ada Pi membaca fail dan memberikan penerangan, kemudian semak sumber dan ID model dalam rekod panggilan OmniProxy.

Permulaan

pi boleh dibuka

• Gunakan cd untuk masuk ke folder dahulu
• pi --version menghasilkan output
• Nama model dipaparkan di bahagian bawah antara muka

Tugas

Ia telah membaca direktori

• Tanya cara repositori disusun
• Lihat fail yang disenaraikannya
• Jangan hanya melihat bahawa konfigurasi telah disimpan

Rekod

Kelihatan dalam get laluan

• Sumbernya ialah Pi
• ID model sepadan
• Simpan kunci pada komputer setempat

Ralat lazim

• pi tidak ditemukan: buka semula terminal, kemudian cuba pi --version. Untuk pemasangan npm, pastikan direktori bin global berada dalam PATH.
• Model tersuai tidak muncul dalam /model: pastikan models.json berada dalam ~/.pi/agent/, apiKey boleh ditafsir, kemudian buka semula /model.
• Windows melaporkan bahawa Bash tidak ditemukan: pasang Git for Windows atau tetapkan shellPath dalam ~/.pi/agent/settings.json. Garis sendeng terbalik dalam JSON perlu ditulis dua kali.
• Permintaan ditolak: pastikan api ialah openai-completions dan baseUrl berakhir dengan /v1. Jangan hidupkan suis keserasian tambahan hanya kerana pihak lain menyatakan bahawa perkhidmatan mereka serasi.
• ID model tidak sah: salin semula ID daripada senarai OmniProxy semasa.

Rujukan rasmi

Arahan pemasangan tersedia di laman web Pi dan Quickstart. Maklumat fail model tersedia dalam Choose a Model dan Configuration. Maklumat persekitaran arahan Windows tersedia dalam Run Pi on Windows. ID model yang digunakan sebagai contoh boleh dirujuk dalam senarai model Gemini dan halaman model xAI.

Gantikan setiap penanda tempat dengan nilai dari konfigurasi OmniProxy anda sendiri. Jangan pernah terbitkan kunci sebenar.

Hasil tersimpan atau HTTP 200 sahaja tidak membuktikan keserasian Agen penuh. Semak sumber dan model dalam rekod panggilan OmniProxy.

Sumber rasmi · Pi ↗