Skip to content

Ultrafast इंस्टॉल और रन: uv sync और दो API Key ​

पिछले पाठ में Jev Ultrafast के सिद्धांत को तोड़-चोड़कर समझा, इस पाठ में हाथ से करें: jev-ultrafast को अपने कंप्यूटर पर इंस्टॉल करें और लोकल inspector चलाएँ। करने को केवल दो काम हैं——uv sync से एनवायरनमेंट इंस्टॉल करना, .env में दो API Key भरना।

आधिकारिक README का इंस्टॉल पाथ कुल 5 कमांडों का है (git clone, cd, uv sync, cp, uv run jev) — कमांड खुद मुश्किल नहीं हैं, लेकिन हर कमांड के पीछे एक «क्यों» है: क्यों uv और pip नहीं, दोनों Key अलग-अलग क्या संभालते हैं, Chrome कब कनेक्ट होता है। यह पाठ 15 मिनट यहीं लगाता है, इंस्टॉल के बाद सीधे अगले पाठ में जाकर असली Google Flights चलाएँगे।

यह सीखने के बाद आप क्या कर सकेंगे ​

  • git clone + uv sync से jev-ultrafast इंस्टॉल पूरा करना, डिपेंडेंसी रिपॉज़िटरी के साथ आने वाले uv.lock में लॉक होती हैं और प्रोजेक्ट के बगल में .venv में इंस्टॉल होती हैं, सिस्टम Python को नहीं छुआ जाता
  • .env में 6 एनवायरनमेंट वेरिएबल सेट करना, यह स्पष्ट करना कि कौन से दो Key ज़रूरी हैं और हर एक किस कॉल की सेवा करता है
  • 127.0.0.1:8766 पर inspector खोलना, Start demo → Run automatically से पहला demo चलाना
  • uv run browser-harness --doctor से Chrome कनेक्ट करना, और यह जानना कि «रिमोट डिबगिंग की अनुमति दें» प्रॉम्प्ट पर क्लिक करना चाहिए या नहीं
  • टेक्स्ट helper को उदाहरण के OpenRouter + Mercury से बदलकर DeepSeek, GLM जैसे OpenAI-संगत मॉडल लगाना

आपकी अभी की दिक्कत ​

  • 7 सेकंड में फ्लाइट सर्च अपनी आँखों से देखना चाहते हैं, लेकिन README में सिर्फ़ पाँच लाइन कमांड हैं, और चल न पाने पर समझ नहीं आता कि किस लेयर की जाँच करें: इंस्टॉल नहीं हुआ, Key सेट नहीं हुआ, या Chrome कनेक्ट नहीं हुआ
  • Key थोड़े उलझे हुए हैं: TypeSafe का Key है, पर उदाहरण कॉन्फ़िग में एक OpenRouter का भी माँगा जाता है — एक कम होने पर क्या होगा और कब फटेगा, यकीन नहीं
  • कंप्यूटर पर Python के कई वर्शन हैं, और यह रिपॉज़िटरी Python ≥ 3.12 माँगती है — एक और ग्लोबल एनवायरनमेंट मैन्युअली संभालना नहीं चाहते

यह तरीका कब इस्तेमाल करें ​

जब आपको चाहिए:

  • अपनी मशीन पर ओपन-सोर्स Jev Ultrafast चलाना, ताकि Google Flights चलाने के लिए एनवायरनमेंट तैयार हो
  • inspector में अपनी आँखों से पिछले पाठ में बताए नंबर वाले एलिमेंट, ऑपरेशन प्रॉबेबिलिटी, टारगेट प्रॉबेबिलिटी देखना — सिद्धांत स्क्रीन पर उतरता है
  • बाद में Agent लाइब्रेरी से अपने ब्राउज़र टास्क लिखना

और नहीं चाहते:

  • मैन्युअली venv बनाना, pip से डिपेंडेंसी इंस्टॉल करना, वर्शन कॉन्फ्लिक्ट संभालना
  • API Key कोड में हार्डकोड करना, या ग़लती से git में कमिट कर देना

🎒 शुरू करने से पहले की तैयारी ​

  • Jev Ultrafast के सिद्धांत पूरा किया है: ऑपरेशन सेट, स्पेक्युलेटिव target heads और सुरक्षा सीमा जानते हैं, इंस्टॉल के बाद inspector देखकर चकराएँगे नहीं
  • पास TypeSafe API Key है (नहीं है तो पहले रजिस्ट्रेशन और API Key पूरा करें)
  • आपके कंप्यूटर पर Chrome इंस्टॉल हो — agent के सभी क्लिक और इनपुट Chrome में ही होते हैं
  • (वैकल्पिक) एक OpenRouter खाते की Key, या सीधे DeepSeek / GLM की Key (कैसे बदलें, यह चरण 3 में बताया जाएगा)
  • एक गिलास पानी — इस बार सचमुच Jev को आपकी ओर से ब्राउज़र क्लिक करने देना है

सिस्टम आवश्यकताएँ ​

आइटमआवश्यकतास्रोत
Python≥ 3.12 (requires-python = ">=3.12")रिपॉज़िटरी pyproject.toml
uvकोई भी उपयोगी संस्करण, अगर न हो तो चरण 1 में इंस्टॉल करेंREADME में uv sync से इंस्टॉल किया गया
Chromeलोकल मशीन पर इंस्टॉल, चलते समय रिमोट डिबगिंग की अनुमतिREADME का 「Try it」
नेटवर्कapi.typesafe.ai और आपके कॉन्फ़िगर किए टेक्स्ट मॉडल एंडपॉइंट तक पहुँचjev_ultrafast/model.py

💡 uv क्या है

uv Astral का बनाया Python पैकेज और प्रोजेक्ट मैनेजर है (आधिकारिक शब्दों में: extremely fast Python package and project manager, written in Rust)। यह pyproject.toml के बगल में प्रोजेक्ट-विशेष .venv बनाए रखता है, और uv run हर बार पहले पुष्टि करता है कि वातावरण और लॉक फ़ाइल सिंक हैं — आपको मैन्युअल रूप से कुछ भी activate करने की ज़रूरत नहीं। पहले SDK इंस्टॉल के वैकल्पिक तरीके में uv add का उपयोग किया था, इस बार यह उसकी सिस्टर कमांड uv sync है।

मूल विचार ​

jev-ultrafast इंस्टॉल का सार = एक लॉक की गई डिपेंडेंसी + दो चाबियाँ।

डिपेंडेंसी का काम uv sync करता है। यह रिपॉज़िटरी पहले से pyproject.toml और uv.lock लेकर आती है, uv sync दो काम करता है (uv के आधिकारिक दस्तावेज़ 《Locking and syncing》 की परिभाषा): डिपेंडेंसी को लॉक फ़ाइल में लॉक करना, फिर लॉक फ़ाइल के पैकेजों को प्रोजेक्ट वातावरण (pyproject.toml के बगल का .venv) में इंस्टॉल करना। इंस्टॉल से मिलने वाली मुख्य तीन चीज़ें:

.venv में इंस्टॉल होने वाली चीज़ेंसंस्करण बाध्यताकिस काम के लिए
jev-ultrafast मुख्य पैकेज0.1.0agent लूप + jev कमांड एंट्री
browser-harness== 0.1.13Chrome से कनेक्ट करता है (README: uv sync द्वारा स्वतः इंस्टॉल होता है)
httpx[http2]≥ 0.28, < 1TypeSafe और टेक्स्ट मॉडल रिक्वेस्ट भेजने वाला HTTP क्लाइंट

डेवलपमेंट डिपेंडेंसीज़ (pytest, ruff, pillow) dev ग्रुप में आती हैं, और uv sync डिफ़ॉल्ट रूप से इन्हें भी इंस्टॉल कर देता है——इनकी चिंता करने की ज़रूरत नहीं है।

कुंजियाँ .env में भरें, कुल दो कुंजियाँ चाहिए। दो कुंजियाँ क्यों? पिछले पाठ में बताया गया था: Jev केवल निर्णय लेता है, टेक्स्ट जनरेट नहीं करता; जब TYPE_TEXT ऑपरेशन आता है, तो स्ट्रिंग एक अलग «छोटे LLM» द्वारा जनरेट होती है। इसलिए दो अलग-अलग सेवाओं को ऑथराइज़ करना है:

Keyकिसे ऑथराइज़ करती हैकब उपयोग होती है
TYPESAFE_API_KEYapi.typesafe.ai/v1/systemone (Jev निर्णय)हर निर्णय चक्र में उपयोग होती है, इसके बिना पहली रिक्वेस्ट ही नहीं भेजी जा सकती
TEXT_MODEL_API_KEYTEXT_MODEL_BASE_URL द्वारा इंगित OpenAI-संगत एंडपॉइंट (उदाहरण OpenRouter है)केवल तब जब ऑपरेशन TYPE_TEXT हो, इसके बिना टाइपिंग के चरण पर ही एरर मिलता है

इस «एक रिक्वेस्ट में ऑपरेशन पूछना, टाइपिंग छोटे मॉडल को आउटसोर्स करना» वाले विभाजन का व्यावहारिक रूप, Jev समानांतर प्रश्न में स्पेक्युलेटिव फैन-आउट का ही वास्तविक रूप है।

अंत में चलाने के तरीके का चुनाव——इंस्टॉल के बाद तीन रास्ते हैं, यह पाठ पहले रास्ते पर चलता है:

चलाने का तरीकाकिसके लिए उपयुक्त
लोकल डेमो (uv run jev + inspector)पहले एक नज़र देखना चाहते हैं, चरण-दर-चरण रोक सकते हैं——यही पाठ
Agent लाइब्रेरी (uv run --env-file .env python 你的脚本.py)अपने खुद के टास्क लिखना चाहते हैं——पाठ 5
BU Ultrafast क्लाउड सेवा (model: "bu-ultrafast")कुछ भी इंस्टॉल नहीं करना चाहते, सीधे Browser Use Cloud पर चलाना चाहते हैं

मेरे साथ करें ​

चरण 1: uv और Chrome इंस्टॉल करें——jev-ultrafast इंस्टॉलेशन की पूर्व-आवश्यकताएँ ​

क्यों: पूरा इंस्टॉलेशन uv की एक ही कमांड से पूरा होता है; Chrome agent का "हाथ" है, क्लिक और इनपुट सब उसी में होते हैं।

पहले जाँचें कि uv मौजूद है या नहीं:

bash
uv --version

आपको यह दिखना चाहिए: एक पंक्ति में वर्ज़न नंबर (जैसे uv 0.13.x, आपके इंस्टॉल किए वर्ज़न के अनुसार)। अगर नहीं है, तो macOS / Linux पर आधिकारिक इंस्टॉल स्क्रिप्ट का उपयोग करें:

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

Windows (PowerShell):

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

ये सभी कमांड uv के आधिकारिक इंस्टॉल दस्तावेज़ (docs.astral.sh/uv) से ली गई हैं; आप brew install uv, pipx install uv, winget install --id=astral-sh.uv -e जैसे पैकेज मैनेजर से भी इंस्टॉल कर सकते हैं। सिस्टम पर curl न होने पर आधिकारिक रूप से wget वर्ज़न भी उपलब्ध है: wget -qO- https://astral.sh/uv/install.sh | sh।

Chrome में कोई कॉन्फ़िगरेशन बदलने की ज़रूरत नहीं है, बस इंस्टॉल रहने दें——remote debugging की अनुमति प्रॉम्प्ट चरण 5 तक नहीं आएगा।

  • uv --version का आउटपुट दिखता है; Chrome सामान्य रूप से खुलता है

चरण 2: git clone करें और uv sync चलाएँ——jev-ultrafast का मुख्य इंस्टॉलेशन ​

क्यों: README के "Try it" अनुभाग की इंस्टॉल कमांड बस इतनी ही हैं, शब्दशः कॉपी कर लें; uv sync रिपॉज़िटरी द्वारा लॉक की गई सभी डिपेंडेंसी एक साथ इंस्टॉल कर देगा (Browser Harness सहित), आपको अलग-अलग pip नहीं करना पड़ेगा।

bash
git clone https://github.com/browser-use/jev-ultrafast.git
cd jev-ultrafast
uv sync

आपको यह दिखना चाहिए: git रिपॉज़िटरी को jev-ultrafast/ डायरेक्टरी में क्लोन करता है; uv डिपेंडेंसी रिज़ॉल्यूशन और इंस्टॉलेशन पूरा करता है, आउटपुट में वातावरण में इंस्टॉल हुए पैकेज दिखते हैं (जिनमें browser-harness और httpx दिखना चाहिए); रिपॉज़िटरी डायरेक्टरी में एक .venv/ जुड़ जाता है।

तीन जानने लायक बातें (uv के आधिकारिक दस्तावेज़ के अनुसार):

विवरणव्याख्या
.venv/uv द्वारा pyproject.toml के साथ प्रबंधित प्रोजेक्ट वातावरण, सिस्टम Python को प्रदूषित नहीं करता, और आपको इसे मैन्युअल रूप से एक्टिवेट भी नहीं करना पड़ता
uv.lockरिपॉज़िटरी के साथ आता है, सटीक वर्ज़न लॉक करता है; लॉक फ़ाइल पहले से होने पर uv sync लॉक किए गए वर्ज़न को प्राथमिकता देता है
uv run स्वतः सिंक करता हैके बाद हर uv run … से पहले यह जाँचता है कि वातावरण और लॉक फ़ाइल नवीनतम हैं, इसलिए डिपेंडेंसी बदलने पर भी दोबारा मैन्युअल sync करने की ज़रूरत नहीं
  • uv sync बिना किसी एरर के, jev-ultrafast/ के अंतर्गत .venv/ दिखता है

चरण 3: .env.example कॉपी करें, दो API Key भरें ​

क्यों: सभी Key .env फ़ाइल से जाते हैं——रिपॉज़िटरी का .gitignore इसे पहली पंक्ति में इग्नोर करता है, README के डेवलपमेंट अनुभाग में भी लिखा है "Credentials and raw traces stay ignored", Key git के साथ नहीं जाएँगे।

bash
cp .env.example .env

फिर .env खोलकर दो Key भरें (<尖括号> केवल प्लेसहोल्डर है, भरने के बाद एंगल ब्रैकेट हटा दें):

bash
TYPESAFE_API_KEY=<你的 TypeSafe API Key>
TYPESAFE_MODEL=jev-latest
TEXT_MODEL_API_KEY=<你的文本模型 Key>
TEXT_MODEL_BASE_URL=https://openrouter.ai/api/v1
TEXT_MODEL=inception/mercury-2.5
TEXT_MODEL_REASONING=none

.env.example में कुल 6 वेरिएबल हैं, हर एक को स्पष्ट रूप से समझाया जा रहा है (उदाहरण मान और डिफ़ॉल्ट मान दोनों इसी फ़ाइल और jev_ultrafast/model.py से लिए गए हैं):

वेरिएबलउदाहरण मानअनिवार्य?किसे नियंत्रित करता है
TYPESAFE_API_KEY—अनिवार्यJev के लिए निर्णय अनुरोध (decision request) की Bearer Key, api.typesafe.ai/v1/systemone पर भेजी जाती है
TYPESAFE_MODELjev-latestवैकल्पिकनिर्णय मॉडल; न सेट करने पर कोड इसे डिफ़ॉल्ट रूप से jev-latest ही रखता है
TEXT_MODEL_API_KEY—TYPE_TEXT अनिवार्यटेक्स्ट helper की Key; न सेट करने पर और टाइपिंग ऑपरेशन मिलने पर सीधे एरर थ्रो होता है
TEXT_MODEL_BASE_URLhttps://openrouter.ai/api/v1वैकल्पिकटेक्स्ट मॉडल एंडपॉइंट; न सेट करने पर कोड डिफ़ॉल्ट रूप से https://api.deepseek.com/v1 उपयोग करता है
TEXT_MODELinception/mercury-2.5वैकल्पिकटेक्स्ट मॉडल का नाम; न सेट करने पर कोड डिफ़ॉल्ट रूप से deepseek-chat उपयोग करता है
TEXT_MODEL_REASONINGnoneवैकल्पिकnone = रीज़निंग बंद; न सेट करने पर लागू होने वाला नियम नीचे तरीका B में देखें

दोनों Key का स्रोत: TypeSafe की Key console.typesafe.ai/keys से लें (इसे पंजीकरण पाठ में पहले ही देखा जा चुका है); टेक्स्ट मॉडल की Key आपके चुने हुए तरीके के अनुसार:

तरीका A (उदाहरण कॉन्फ़िगरेशन): OpenRouter + Mercury ​

.env.example की मूल कॉन्फ़िगरेशन जैसी है: OpenRouter की Key + inception/mercury-2.5, रीज़निंग बंद। README के अनुसार मौजूदा demo इसी का उपयोग करता है। बस जस की तस कॉपी कर लें, शून्य निर्णय लागत।

तरीका B: DeepSeek सीधा कनेक्शन——कोड में डिफ़ॉल्ट एंडपॉइंट ​

केवल TEXT_MODEL_API_KEY=<你的 DeepSeek Key> भरें, TEXT_MODEL_BASE_URL और TEXT_MODEL दोनों पंक्तियों को छोड़ा जा सकता है (.env.example से कॉपी किया है तो इन दोनों पंक्तियों को हटा दें, खाली छोड़ना भी मना है — खाली स्ट्रिंग भी सेट मानी जाती है) — model.py में unset होने पर डिफ़ॉल्ट मान https://api.deepseek.com/v1 + deepseek-chat ही है। DeepSeek एंडपॉइंट स्वतः पहचाना जाता है, और अनुरोध में thinking: {type: disabled} भेजकर reasoning बंद कर दिया जाता है।

तरीका C: GLM / Gemini आदि अन्य OpenAI-संगत मॉडल ​

README में स्पष्ट कहा गया है: Gemini, GLM, DeepSeek सभी इस OpenAI-संगत टेक्स्ट helper के साथ काम कर सकते हैं — 「संबंधित model, endpoint और reasoning सेटिंग्स कॉन्फ़िगर करें」。 यानी TEXT_MODEL_BASE_URL को आपकी सेवा के OpenAI-संगत एंडपॉइंट से और TEXT_MODEL को संबंधित मॉडल नाम से बदलें (सटीक मान आपके सेवा प्रदाता के दस्तावेज़ के अनुसार ही मानें)।

⚠️ reasoning पैरामीटर के नियम

model.py का तर्क यह है: एंडपॉइंट में api.deepseek.com/ होने पर स्वतः thinking: {type: disabled} भेजा जाता है; अन्य एंडपॉइंट पर डिफ़ॉल्ट रूप से reasoning: {effort: low} भेजा जाता है; केवल TEXT_MODEL_REASONING=none होने पर ही यह reasoning: {enabled: false} में बदलता है। मॉडल बदलते समय एक पंक्ति TEXT_MODEL_REASONING=none रखना सबसे आसान है।

आपको यह दिखना चाहिए: खुली हुई .env में TYPESAFE_API_KEY और TEXT_MODEL_API_KEY दोनों पंक्तियों में आपके अपने मान हों, प्लेसहोल्डर कोणक कोष्ठक हट चुके हों; शेष 4 पंक्तियाँ उदाहरण मान पर ही रहें या तरीका B/C के अनुसार समायोजित करें।

  • .env में दोनों Key गैर-रिक्त हैं; पुष्टि करें कि यह .gitignore में है (डिफ़ॉल्ट रूप से पहले से ही ignore किया गया है)

चरण 4: uv run jev से लोकल inspector शुरू करें ​

क्यों: jev वह कमांड-लाइन एंट्री है जो pyproject.toml में रजिस्टर है ([project.scripts] में jev = "jev_ultrafast.demo:main"), और यह एक ऐसा inspector पेज शुरू करता हैजो केवल लोकल लूपबैक एड्रेस पर सुनता है।

रिपॉज़िटरी की रूट डायरेक्टरी में चलाएँ:

bash
uv run jev

आपको यह दिखना चाहिए (टर्मिनल में जस का तस आउटपुट, demo.py के main() से):

text
Jev Ultrafast: http://127.0.0.1:8766

ब्राउज़र में http://127.0.0.1:8766 खोलें, आपको demo का होमपेज दिखेगा: टास्क इनपुट बॉक्स, सीन ड्रॉपडाउन और कंट्रोल बटनों की एक कतार। यह सेवा केवल 127.0.0.1 से बंधती है (demo.py की docstring इसे Loopback-only inspector कहती है), दूसरी मशीनें इसे एक्सेस नहीं कर सकतीं; Ctrl+C से रोकें।

दो बारीकियाँ:

  • पोर्ट डिफ़ॉल्ट रूप से 8766 है, यदि व्यस्त हो तो एनवायरनमेंट वेरिएबल TYPESAFE_DEMO_PORT से बदल सकते हैं (देखें एडवांस्ड टिप्स)

  • .env शुरू होने के समयवर्तमान डायरेक्टरी से पढ़ा जाता है — इसलिए यह कमांड jev-ultrafast/ रिपॉज़िटरी की रूट डायरेक्टरी में ही चलानी चाहिए (कारण देखें ट्रबलशूटिंग रिमाइंडर का 2वाँ बिंदु)

  • टर्मिनल पर Jev Ultrafast: http://127.0.0.1:8766 प्रिंट होता है, और ब्राउज़र में पेज दिखता है

चरण 5: Start demo से Chrome कनेक्ट करें और पहला demo चलाएँ ​

क्यों: inspector एक आधिकारिक पैनल है जो आपको निर्णय प्रक्रिया दिखाता है; पहली बार Start demo क्लिक करने पर, Browser Harness Chrome से कनेक्ट होने की कोशिश करता है—रिमोट डिबगिंग का प्राधिकरण प्रॉम्प्ट तभी दिखाई देता है।

पेज पर (बटन के नाम इंटरफ़ेस के मूल पाठ हैं):

  1. टास्क बॉक्स में डिफ़ॉल्ट लक्ष्य पहले से भरा है: Zurich से London के लिए वन-वे फ़्लाइट खोज (मूल पाठ static/index.html में देखें, आप इसे अपना 1–2000 वर्णों वाला लक्ष्य बदल सकते हैं)
  2. सीन ड्रॉपडाउन में Google Flights · real web चुनें (दूसरे दो Travel planner · fixture, Reading room · fixture लोकल पेज हैं, नेट पर नहीं जाते)
  3. Start demo क्लिक करें
  4. Chrome रिमोट डिबगिंग के लिए पूछे तो Allow करें (README का मूल वाक्य: Allow remote debugging in Chrome when prompted)
  5. Run automatically क्लिक करके चालू करें; चरण-दर-चरण देखना चाहें तो Choose next क्लिक करें, यह हर निष्पादन से पहले रुकेगा

अगर Chrome कनेक्ट नहीं होता, तो दूसरे टर्मिनल में (रिपॉज़िटरी रूट डायरेक्टरी से) चलाएँ:

bash
uv run browser-harness --doctor

आपको यह दिखना चाहिए: inspector पैनल में क्रमांकित एलिमेंट, एक्शन की प्रायिकता, लक्ष्य की प्रायिकता और निष्पादित एक्शन दिखते हैं (README के मूल पाठ की चार चीज़ें); ब्राउज़र पैनल में पेज स्वतः ऑपरेट होने लगता है। पूरा होने पर Ctrl+C दबाकर सेवा बंद कर दें।

  • Start demo के बाद inspector में क्रमांकित एलिमेंट और प्रायिकता के दो कॉलम दिखते हैं; Chrome विंडो में पेज चल रहा होता है

चेकपॉइंट ✅ ​

  • uv --version का आउटपुट आता है, Chrome इंस्टॉल है
  • uv sync बिना त्रुटि चलता है, रिपॉज़िटरी डायरेक्टरी में .venv/ मौजूद है, इंस्टॉल सूची में browser-harness शामिल है
  • .env में दोनों Key भरे गए हैं: TYPESAFE_API_KEY, TEXT_MODEL_API_KEY
  • रिपॉज़िटरी रूट डायरेक्टरी से uv run jev Jev Ultrafast: http://127.0.0.1:8766 प्रिंट करता है
  • ब्राउज़र में 127.0.0.1:8766 खुलता है, Start demo के बाद क्रमांकित एलिमेंट, एक्शन की प्रायिकता, लक्ष्य की प्रायिकता दिखते हैं

सामान्य गलतियों की चेतावनी ​

❌ केवल TYPESAFE_API_KEY भरकर ही चालू कर दिया ​

लक्षण: demo शुरू हो जाता है, पेज का निरीक्षण भी होता है, लेकिन «इनपुट बॉक्स में टाइप करने» के चरण पर रुक जाता है, त्रुटि संदेश ज्यों का त्यों है:

text
TYPE_TEXT needs TEXT_MODEL_API_KEY; no text is hardcoded or guessed by the executor.

कारण: TEXT_MODEL_API_KEY केवल तब जाँचा जाता है जब एक्शन TYPE_TEXT हो (model.py का field_text()), शुरुआत में सत्यापन नहीं होता, इसलिए Key के अभाव में यह टाइपिंग तक पहुँचकर ही टूटता है। Flights demo को शहरों के नाम जनरेट करने होते हैं, यह लाज़मी तौर पर आएगा।

सही तरीका: दोनों Key एक साथ कॉन्फ़िगर करें — यही इस पाठ H1 में 「दो API Key」 का अर्थ है।

❌ रिपॉज़िटरी के रूट डायरेक्टरी में न चलाना, तो .env पढ़ा नहीं जा पाता ​

लक्षण: Key स्पष्ट रूप से भरा होने पर भी फिर भी Key कमी की गड़बड़ी दिखती है या पुराना कॉन्फ़िगरेशन उपयोग होता है।

कारण: demo.py का load_environment() .env को वर्तमान कार्यशील डायरेक्टरी से पढ़ता है (कोड यही है: Path.cwd() / ".env"), इसलिए किसी और डायरेक्टरी में uv run jev चलाने पर वहाँ का .env (या कुछ भी नहीं) पढ़ा जाता है। इसके अलावा यह setdefault का उपयोग करता है — अगर आपके टर्मिनल में पहले से ही उसी नाम के वेरिएबल को export किया गया है, तो .env का मान उसे ओवरराइट नहीं करेगा।

सही तरीका: पहले cd jev-ultrafast फिर uv run jev; जाँच के समय echo $TEXT_MODEL_API_KEY से देखें कि shell में कोई पुराना मान पहले से तो नहीं है।

❌ Chrome कनेक्ट नहीं हो पाता, पैनल बिल्कुल नहीं हिलता ​

कारण: Browser Harness के लिए ज़रूरी है कि Chrome रिमोट डिबगिंग की अनुमति दे; पहली कनेक्शन के समय Chrome प्रॉम्प्ट दिखाता है; उसे मिस करने या मना करने के बाद कनेक्ट नहीं हो पाता।

सही तरीका: uv run browser-harness --doctor चलाकर कनेक्शन का निदान करें; अगली बार Chrome 「रिमोट डिबगिंग की अनुमति दें」 प्रॉम्प्ट दिखाए तो अनुमति दें। कनेक्ट न होने या क्लिक न चलने की और जाँच के लिए Ultrafast ट्रबलशूटिंग देखें।

❌ यह सोचना कि टेक्स्ट मॉडल केवल OpenRouter के Mercury से ही चल सकता है ​

कारण: .env.example का उदाहरण मान OpenRouter + inception/mercury-2.5 है, जो देखने में जकड़ा हुआ लगता है।

तथ्य: README स्पष्ट रूप से कहता है कि Gemini, GLM, DeepSeek तीनों इस OpenAI-संगत helper से चल सकते हैं; जब model.py में TEXT_MODEL_BASE_URL / TEXT_MODEL सेट नहीं किया जाता, तो कोड का डिफ़ॉल्ट मान सीधे DeepSeek ही होता है (https://api.deepseek.com/v1 + deepseek-chat)।

सही तरीका: चरण 3 के तरीके B / C के अनुसार एंडपॉइंट और मॉडल नाम बदलें, और उस ⚠️ टिप के अनुसार reasoning कॉन्फ़िगर करें; बदलने के बाद एक बार demo चलाकर सत्यापित करें कि टाइपिंग चरण सामान्य चल रहा है।

एडवांस टिप्स (वैकल्पिक) ​

पोर्ट बदलें। जब 8766 व्यस्त हो, शुरू करने से पहले shell में export TYPESAFE_DEMO_PORT=8767 (Windows PowerShell में $env:TYPESAFE_DEMO_PORT="8767") चलाकर फिर uv run jev चलाएँ। ध्यान दें: यह वेरिएबल प्रोसेस शुरू होने से पहले ही सेट होना चाहिए — demo.py मॉड्यूल इंपोर्ट के समय ही पोर्ट पढ़ लेता है, .env में लिखना समय पर लागू नहीं हो पाएगा।

पहले स्थानीय fixture पेज पर अभ्यास करें। परिदृश्य ड्रॉपडाउन में Travel planner · fixture और Reading room · fixture रिपॉज़िटरी में शामिल स्थानीय पेज (static/fixture.html) चलाते हैं, बाहरी नेटवर्क तक नहीं जाते — जब आप पहले देखना चाहते हैं कि agent कैसे चलता है, लेकिन फिलहाल असली वेबसाइट पर हाथ नहीं आज़माना चाहते, तो इन्हें चुनें।

स्थानीय रूप से इंस्टॉल नहीं करना चाहते? क्लाउड सेवा का उपयोग करें। Browser Use Cloud होस्टेड संस्करण BU Ultrafast प्रदान करता है, जो आधिकारिक रूप से सभी योजनाओं में उपलब्ध बताया गया है: model: "bu-ultrafast" कॉन्फ़िगर करें (cloud.browser-use.com)। ओपन-सोर्स संस्करण आपके कंप्यूटर पर चलता है, क्लाउड सेवा Browser Use Cloud पर चलती है।

इस पाठ का सारांश ​

✅ jev-ultrafast इंस्टॉलेशन = git clone → uv sync → cp .env.example .env → uv run jev, चार चरण, पाँच कमांड, README के "Try it" अनुभाग से लिए गए, जस के तस उपयोग करने योग्य।

✅ दोनों Key अलग-अलग काम संभालते हैं: TYPESAFE_API_KEY Jev के निर्णयों को अधिकृत करता है (हर चक्र में उपयोग होता है), TEXT_MODEL_API_KEY टाइपिंग के समय छोटे LLM को अधिकृत करता है (इसके बिना TYPE_TEXT पर पहुँचने पर ही त्रुटि मिलती है, त्रुटि संदेश का मूल पाठ खोजा जा सकता है)।

✅ uv sync रिपॉज़िटरी द्वारा लॉक की गई निर्भरताओं को प्रोजेक्ट के बगल में .venv में इंस्टॉल करता है (Chrome से जुड़ने वाला browser-harness 0.1.13 सहित); uv run हर बार पर्यावरण सिंक की पुष्टि स्वतः करता है।

✅ Chrome Browser Harness के माध्यम से जुड़ता है, uv run browser-harness --doctor आधिकारिक डायग्नोस्टिक कमांड है; पहली बार जुड़ते समय रिमोट डिबगिंग की अनुमति देना न भूलें।

✅ टेक्स्ट मॉडल OpenRouter से बंधा नहीं है: DeepSeek कोड का डिफ़ॉल्ट है, GLM / Gemini OpenAI-संगत एंडपॉइंट से दोनों उपयोग किए जा सकते हैं।

मुख्य कॉन्फ़िगरेशन फ़ील्ड की समीक्षा (.env, उदाहरण मान .env.example से लिए गए):

फ़ील्डअनुशंसित मानविवरण
TYPESAFE_API_KEY(आवश्यक)Jev निर्णय की कुंजी, console.typesafe.ai/keys से प्राप्त करें
TEXT_MODEL_API_KEY(आवश्यक)टेक्स्ट helper की कुंजी, चुनी गई सेवा के अनुसार
TYPESAFE_MODELjev-latestनिर्णय मॉडल, हटाया जा सकता है (डिफ़ॉल्ट समान)
TEXT_MODEL_BASE_URLविधि A/B/C के अनुसारटेक्स्ट मॉडल एंडपॉइंट, DeepSeek हेतु हटाया जा सकता है
TEXT_MODELविधि A/B/C के अनुसारटेक्स्ट मॉडल का नाम, DeepSeek हेतु हटाया जा सकता है
TEXT_MODEL_REASONINGnoneरीज़निंग बंद करता है; मॉडल बदलते समय

अगले पाठ का पूर्वावलोकन ​

परिवेश तैयार है; अगले पाठ में Google Flights चलाएंगे: 7 सेकंड में एक वास्तविक खोज पूरी करें और agent से असली काम करवाएंगे। आप सीखेंगे:

  • inspector में एक वास्तविक Google Flights खोज चलाना, और अपनी आंखों से देखना कि 7 सेकंड कैसे खर्च होते हैं
  • examples/flights.py --keep-open से आधिकारिक रिकॉर्डिंग को दोहराना: खोज, स्वतंत्र सत्यापन, trace सहेजना — कुछ चुनना या बुक करना नहीं
  • यह समझना कि उदाहरण का स्वतंत्र verify() क्या-क्या जांचता है — DONE पर्याप्त नहीं, कोड द्वारा सत्यापन ही गिनता है
  • कौन-से कारक इस सेकंड संख्या को प्रभावित करते हैं (मापन पद्धति के विवरण प्रदर्शन व्याख्या में छोड़े गए हैं)

परिशिष्ट: सोर्स कोड संदर्भ ​

पर क्लिक करके सोर्स कोड स्थान देखें

अपडेट समय: 2026-11-04 (रिपॉज़िटरी github.com/browser-use/jev-ultrafast, स्थानीय सूचना स्रोत sources/jev/repo-ultrafast/)

सुविधाफ़ाइल पथमुख्य स्थान
इंस्टॉल कमांड और Chrome कनेक्शन निर्देशREADME.md「Try it」 खंड (git clone / uv sync / cp / uv run jev / 8766 / --doctor / रिमोट डिबगिंग की अनुमति); 「Use the library」 (--env-file उपयोग विधि)
पर्यावरण चर उदाहरण.env.exampleपूरी फ़ाइल: 6 चर + 1 पंक्ति टिप्पणी (TYPE_TEXT आवश्यकता का विवरण)
Python संस्करण, निर्भरताएं, jev एंट्रीpyproject.tomlrequires-python = ">=3.12"; dependencies (browser-harness==0.1.13, httpx[http2]); [project.scripts] jev = "jev_ultrafast.demo:main"
inspector पोर्ट और .env लोडिंगjev_ultrafast/demo.pyL16 PORT (डिफ़ॉल्ट 8766, TYPESAFE_DEMO_PORT पढ़ता है); L23 load_environment() (cwd का .env, setdefault); L131 main() (Jev Ultrafast: http://127.0.0.1:8766 प्रिंट करता है; केवल 127.0.0.1 से बाइंड होता है)
demo परिदृश्य और लक्ष्य की लंबाईjev_ultrafast/demo.pyL44 command() (scenario ∈ travel/research/flights; goal 1–2000 अक्षर)
दो Key का उपयोग और त्रुटि संदेशjev_ultrafast/model.pyL119 TypeSafe अनुरोध (Bearer TYPESAFE_API_KEY); L160–168 field_text() (TEXT_MODEL_API_KEY आवश्यक, DeepSeek डिफ़ॉल्ट एंडपॉइंट, reasoning की तीन शाखाएँ)
पैनल बटन और पूर्व-भरा लक्ष्यjev_ultrafast/static/index.htmlL33–36 परिदृश्य ड्रॉपडाउन; L40–44 डिफ़ॉल्ट लक्ष्य और Start demo; L56–59 Choose next / Execute choice / Run automatically / Pause
.env git में नहीं जाता.gitignoreपंक्ति 1 .env; साथ ही .venv/, artifacts/ को भी अनदेखा करता है
uv इंस्टॉलेशन और sync व्यवहारuv आधिकारिक दस्तावेज़docs.astral.sh/uv (Installation का curl/irm कमांड; Locking and syncing की परिभाषा और डिफ़ॉल्ट व्यवहार; .venv की स्थिति Projects → Structure and files में देखें)
gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.