Pi ఇన్‌స్టాలేషన్ మరియు OmniProxy కాన్ఫిగరేషన్

Pi అనేది ఒక చిన్న టెర్మినల్ అసిస్టెంట్—ఇది కమాండ్ లైన్‌లో మీతో నేరుగా మాట్లాడే, ఫైళ్లను చదివే మరియు టాస్క్‌లను పూర్తి చేసే ప్రోగ్రామ్. ఇది చిన్న సిస్టమ్ ప్రాంప్ట్‌ను కలిగి ఉంటుంది మరియు డిఫాల్ట్‌గా కొన్ని టూల్స్‌ను మాత్రమే కలిగి ఉంటుంది. మీకు ఇతర కమాండ్‌లు, వర్క్‌ఫ్లోలు లేదా ఇంటర్‌ఫేస్‌లు అవసరమైతే, మీరు వాటిని తర్వాత ఎక్స్‌టెన్షన్ల ద్వారా జోడించవచ్చు. ఎక్స్‌టెన్షన్లు Piకి సామర్థ్యాలను జోడించే భాగాలు, మరియు మీరు వాటిని సృష్టించిన తర్వాత ఇతరులతో పంచుకోవచ్చు.

సబ్-ఏజెంట్లు టాస్క్‌లో కొంత భాగాన్ని మరొక అసిస్టెంట్‌కు అప్పగిస్తాయి, అయితే ప్లాన్ మోడ్ అమలు ప్రారంభానికి ముందు దశలను నిర్వహిస్తుంది. ఏ ఫీచర్ కూడా డిఫాల్ట్‌గా చేర్చబడలేదు, కానీ మీరు వాటిని నిర్మించమని Piని అడగవచ్చు లేదా ఇతరులు పంచుకున్న ప్యాకేజీలను ఇన్‌స్టాల్ చేయవచ్చు.

ప్రారంభించే ముందు

macOS మరియు Linux ఇన్‌స్టాలేషన్ స్క్రిప్ట్‌ను ఉపయోగిస్తాయి—ఇది Piని స్వయంచాలకంగా డౌన్‌లోడ్ చేసి ఇన్‌స్టాల్ చేసే ఒకే కమాండ్. Windowsలో, Pi హోమ్‌పేజీలో అందించబడిన PowerShell కమాండ్‌ను ఉపయోగించండి. PowerShell అనేది Windowsతో చేర్చబడిన కమాండ్-లైన్ ఎన్విరాన్‌మెంట్. మీరు Piని WSLలో కూడా ఇన్‌స్టాల్ చేయవచ్చు, ఇది Windowsలో అందుబాటులో ఉన్న Linux ఎన్విరాన్‌మెంట్.

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 లేదా ఆ తర్వాత వెర్షన్ ఇప్పటికే ఇన్‌స్టాల్ అయి ఉంటే, మీరు క్విక్ స్టార్ట్ నుండి ప్రత్యామ్నాయ కమాండ్‌ను కూడా ఉపయోగించవచ్చు:

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

ఇన్‌స్టాలేషన్ స్క్రిప్ట్ ఇంటరాక్టివ్ టెర్మినల్‌లో ప్రశ్నలను అడగడానికి పాజ్ చేయవచ్చు. కొనసాగడానికి స్క్రీన్‌పై ఉన్న ప్రాంప్ట్‌లను అనుసరించండి. మీరు ఇప్పటికే Node యొక్క కంపాటబుల్ వెర్షన్‌ను కలిగి ఉంటే, ఈ npm కమాండ్ ప్రశ్నలను అడగదు. Piని మరొక డైరెక్టరీలో ఇన్‌స్టాల్ చేయడానికి, --prefix /your/directoryని జోడించండి. 2026-10-09న, ఇది Pi 1.1.0ని ఇన్‌స్టాల్ చేసింది.

సాధారణ npm ఇన్‌స్టాలేషన్‌కు డిపెండెన్సీ లైఫ్‌సైకిల్ స్క్రిప్ట్‌లు అవసరం లేదు, ఇవి ప్యాకేజీలు ఇన్‌స్టాలేషన్ సమయంలో స్వయంచాలకంగా రన్ చేసే స్క్రిప్ట్‌లు. ఇన్‌స్టాలేషన్ స్క్రిప్ట్ డిపెండెన్సీలను పిన్ చేస్తుంది; ఆ తర్వాత, Piని pi updateతో అప్‌డేట్ చేయండి. npm ఇన్‌స్టాలేషన్ కోసం, మీ ప్యాకేజీ మేనేజర్ అందించిన అప్‌డేట్ పద్ధతిని ఉపయోగించండి. Nix వినియోగదారులు Pi యొక్క ఫ్లేక్ నుండి ఇన్‌స్టాల్ చేయాలి. ఫ్లేక్ అనేది సాఫ్ట్‌వేర్ మరియు దాని డిపెండెన్సీలను వివరించే Nix కాన్ఫిగరేషన్, మరియు pi update Nix ఇన్‌స్టాలేషన్‌ను అప్‌డేట్ చేయలేదు.

ఇన్‌స్టాలేషన్ తర్వాత, మీ టెర్మినల్ Piని కనుగొనగలదని ముందుగా నిర్ధారించుకోండి:

pi --version

Windowsలో, మోడల్స్ Bash కమాండ్‌లను అమలు చేయాలనుకుంటే, Git for Windowsని ఇన్‌స్టాల్ చేయడం చాలా మంది లోకల్ వినియోగదారులకు సిఫార్సు చేయబడింది. Bash అనేది Pi కొన్ని కమాండ్‌లను రన్ చేయడానికి ఉపయోగించే కమాండ్ ఎన్విరాన్‌మెంట్. Pi ~/.pi/agent/settings.jsonలోని shellPath సెట్టింగ్‌ను, Program Files కింద Git Bashని, ఆపై PATHలోని bash.exeని ఆ క్రమంలో తనిఖీ చేస్తుంది. shellPath Bash యొక్క లొకేషన్‌ను పేర్కొంటుంది, అయితే PATH అనేది సిస్టమ్ కమాండ్‌ల కోసం వెతికే డైరెక్టరీల జాబితా.

Piని ప్రారంభించిన తర్వాత, మీరు దాన్ని తనిఖీ చేయడానికి !printf 'Bash is working\n'ని నమోదు చేయవచ్చు. మీ ఫైళ్లు మరియు టూల్స్ ఇప్పటికే WSLలో ఉంటే, క్విక్ స్టార్ట్‌ను అనుసరించి ఆ Linux ఎన్విరాన్‌మెంట్‌లో Piని ఇన్‌స్టాల్ చేయండి.

తర్వాత, 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 అనేది Pi అభ్యర్థనలను పంపే API ఎండ్‌పాయింట్, మరియు ఇది తప్పనిసరిగా /v1ని కలిగి ఉండాలి. apiKey అనేది APIని యాక్సెస్ చేయడానికి ఉపయోగించే కీ. Model ID అనేది పిలవాల్సిన మోడల్ పేరు మరియు ప్రస్తుత OmniProxy మోడల్ జాబితా నుండి పూర్తిగా కాపీ చేయబడాలి.

కంపాటబుల్ API ఉదాహరణలో చూపిన విధంగా apiని openai-completionsకి సెట్ చేయండి. ఈ ఫీల్డ్ అభ్యర్థనలను పంపేటప్పుడు ఏ API ఫార్మాట్‌ను ఉపయోగించాలో Piకి తెలియజేస్తుంది.

పూర్తి మోడల్ IDని కాపీ చేయండి, పేరులోని స్లాష్‌లతో సహా. 2026-10-09న, ప్రొవైడర్ డాక్యుమెంటేషన్‌లో రెండు రిఫరెన్స్ IDలు 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 మోడల్ జాబితాలోని పూర్తి మోడల్ IDతో సరిపోలాలి. input మోడల్ ఇక్కడ టెక్స్ట్ ఇన్‌పుట్ కోసం కాన్ఫిగర్ చేయబడిందని సూచిస్తుంది.

apiKeyని లిటరల్ విలువగా నమోదు చేయవచ్చు, లేదా Pi దాన్ని ఎన్విరాన్‌మెంట్ వేరియబుల్ నుండి చదవడానికి $NAME లేదా ${NAME}గా నమోదు చేయవచ్చు. !తో ప్రారంభమయ్యే విలువ కమాండ్‌గా పరిగణించబడుతుంది మరియు ప్రతి అభ్యర్థన కోసం అమలు చేయబడుతుంది. రిపోజిటరీకి నిజమైన కీని కమిట్ చేయవద్దు. గేట్‌వే కీలను ధృవీకరించకపోతే, మీరు మీ లోకల్ మెషీన్‌లో మాత్రమే ఉపయోగించే ప్లేస్‌హోల్డర్ స్ట్రింగ్‌ను నమోదు చేయవచ్చు. 2026-10-09న, Pi ఈ కాన్ఫిగరేషన్‌తో ఫైల్‌ను విజయవంతంగా చదివింది.

/modelని తెరవడం ఈ ఫైల్‌ను రీలోడ్ చేస్తుంది. /model అనేది మోడల్స్‌ను చూడటానికి మరియు ఎంచుకోవడానికి Piలోని ఇంటర్‌ఫేస్. Pi వాటి క్రెడెన్షియల్‌లను పరిష్కరించే వరకు కస్టమ్ మోడల్స్ /modelలో కనిపించవు. మోడల్‌ను ఎంచుకున్న తర్వాత, కొత్త సెషన్‌ల కోసం దాన్ని డిఫాల్ట్ మోడల్‌గా సేవ్ చేయడానికి Ctrl+Sని నొక్కండి.

ఫైల్

models.json

• డిఫాల్ట్ డైరెక్టరీ: ~/.pi/agent
• providers కింద ఒక ఎంట్రీని జోడించండి
• apiని completionsకి సెట్ చేయండి

చిరునామా

baseUrl

• /v1ని చేర్చండి
• apiKey వేరియబుల్‌ను రిఫరెన్స్ చేయవచ్చు
• మోడల్ id ఖచ్చితంగా ఉండాలి

ఎంచుకోండి

/model

• దాన్ని తెరవడం ఫైల్‌ను రీలోడ్ చేస్తుంది
• మీరు ఇప్పుడే జోడించిన మోడల్‌ను ఎంచుకోండి
• Ctrl+S దాన్ని డిఫాల్ట్‌గా సేవ్ చేస్తుంది

నిజమైన టాస్క్‌తో ధృవీకరించడం

కాన్ఫిగరేషన్ పూర్తయిన తర్వాత, మీరు ఫైళ్లను కలిగి ఉన్న డైరెక్టరీలో నాన్-ఇంటరాక్టివ్ తనిఖీని చేయవచ్చు. నాన్-ఇంటరాక్టివ్ మోడ్ అంటే Pi ఈ ఒక్క టాస్క్‌ను పూర్తి చేసి, ఆపై కొనసాగుతున్న సంభాషణలోకి ప్రవేశించకుండా నిష్క్రమిస్తుంది. --model తర్వాత ఉన్న విలువను ప్రస్తుత OmniProxy జాబితా నుండి పూర్తి IDతో భర్తీ చేయండి:

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కి స్పష్టంగా సూచిస్తుంది. 2026-10-09న, Pi 1.1.0 ఫైల్ కంటెంట్‌ను విజయవంతంగా చదివింది. మొదటి ప్రతిస్పందనకు సుమారు రెండు నిమిషాలు పట్టింది.

మీరు ఇంటరాక్టివ్ మోడ్‌ను కూడా ఉపయోగించవచ్చు: డైరెక్టరీలోకి వెళ్లి, piని రన్ చేసి, ఆపై /modelతో మోడల్‌ను ఎంచుకోండి. క్విక్ స్టార్ట్‌లోని ఒక ఉదాహరణ టాస్క్, రిపోజిటరీ ఎలా నిర్వహించబడుతుందో మరియు దాని తనిఖీలను ఎలా రన్ చేయాలో వివరించమని Piని అడుగుతుంది. అది ఫైళ్లను చదివి వివరణ ఇస్తుందో లేదో గమనించండి, ఆపై OmniProxy యొక్క అభ్యర్థన లాగ్స్‌లో మూలం మరియు మోడల్ IDని నిర్ధారించుకోండి.

ప్రారంభించండి

pi ప్రారంభమవుతుంది

• ముందుగా ఫోల్డర్‌కు cd చేయండి
• pi --version అవుట్‌పుట్‌ను ఇస్తుంది
• మోడల్ పేరు ఇంటర్‌ఫేస్ దిగువన కనిపిస్తుంది

టాస్క్

ఇది డైరెక్టరీని చదివింది

• రిపోజిటరీ ఎలా నిర్వహించబడుతుందో అడగండి
• అది జాబితా చేసే ఫైళ్లను సమీక్షించండి
• విజయవంతమైన కాన్ఫిగరేషన్ సేవ్ మీద మాత్రమే ఆధారపడవద్దు

లాగ్స్

గేట్‌వేలో కనిపిస్తాయి

• మూలం Pi
• మోడల్ ID సరిపోలింది
• కీని లోకల్ మెషీన్‌లో ఉంచండి

సాధారణ ఎర్రర్లు

• pi కనుగొనబడలేదు: టెర్మినల్‌ను మళ్లీ తెరిచి pi --versionని మళ్లీ ప్రయత్నించండి. npm ఇన్‌స్టాలేషన్ కోసం, గ్లోబల్ బిన్ డైరెక్టరీ PATHలో ఉందని నిర్ధారించుకోండి.
• కస్టమ్ మోడల్స్ /modelలో కనిపించడం లేదు: models.json అనేది ~/.pi/agent/లో ఉందని నిర్ధారించుకోండి, apiKeyని పరిష్కరించగలమని ధృవీకరించండి, ఆపై /modelని మళ్లీ తెరవండి.
• Windows Bash కనుగొనబడలేదని రిపోర్ట్ చేస్తుంది: Git for Windowsని ఇన్‌స్టాల్ చేయండి, లేదా ~/.pi/agent/settings.jsonలో shellPathని సెట్ చేయండి. JSONలోని బ్యాక్‌స్లాష్‌లను రెండుసార్లు వ్రాయాలి.
• అభ్యర్థన తిరస్కరించబడింది: api అనేది openai-completions అని మరియు baseUrl అనేది /v1తో ముగుస్తుందని తనిఖీ చేయండి. సర్వీస్ తనను తాను కంపాటబుల్ అని పేర్కొన్నందున అదనపు కంపాటబిలిటీ ఆప్షన్‌లను ఎనేబుల్ చేయవద్దు.
• మోడల్ ID చెల్లదు: ప్రస్తుత OmniProxy జాబితా నుండి దాన్ని మళ్లీ కాపీ చేయండి.

అధికారిక రిఫరెన్స్‌లు

ఇన్‌స్టాలేషన్ కమాండ్‌ల కోసం, Pi website మరియు Quickstart చూడండి. మోడల్ ఫైల్ కోసం, Choose a Model మరియు Configuration చూడండి. Windows కమాండ్ ఎన్విరాన్‌మెంట్ కోసం, Run Pi on Windows చూడండి. ఉదాహరణలలో ఉపయోగించిన మోడల్ IDల కోసం, Gemini model list మరియు xAI models page చూడండి.

మీ స్వంత OmniProxy కన్ఫిగరేషన్ నుండి విలువలతో ప్రతి ప్లేస్‌హోల్డర్‌ను మార్చండి. నిజమైన కీని ఎప్పుడూ ప్రచురించకండి.

సేవ్ చేసిన ఫలితం లేదా HTTP 200 మాత్రమే పూర్తి ఏజెంట్ అనుకూలతను నిరూపించదు. OmniProxy కాల్ రికార్డ్‌లో వనరు మరియు మాడల్‌ను తనిఖీ చేయండి.

అధికారిక వనరులు · Pi ↗