DeepSeek Harness

یہ گائیڈ اوپن سورس DeepSeek Harness کو Felo API Platform کے فراہم کردہ ماڈلز کے ساتھ چلانے کے لیے ہے۔ تجویز کردہ طریقہ ہارنس کے بلٹ اِن deepseek-official ایڈاپٹر کو دوبارہ استعمال کرتا ہے۔ آپ Web UI میں Felo کو الگ حسب ضرورت OpenAI-compatible فراہم کنندہ کے طور پر بھی شامل کر سکتے ہیں۔

DeepSeek Harness اس وقت ڈویلپر پری ویو ہے اور مطابقت توڑنے والی تبدیلیاں لا سکتا ہے۔ جب کوئی آپشن یا اسکرین اِس گائیڈ سے مختلف ہو تو اُس کے اپ اسٹریم ریلیز نوٹس دیکھیں۔

شروع کرنے سے پہلے

آپ کو Node.js اور Felo API Platform کی ایک کلید درکار ہے۔ کلید کو سورس کنٹرول سے باہر رکھیں۔

export FELO_API_KEY="YOUR_API_KEY"

مثالوں میں deepseek-v4-flash استعمال ہوا ہے۔ کوئی دوسرا ماڈل ID منتخب کرنے سے پہلے Models and Pricing دیکھیں۔

تجویز کردہ سیٹ اپ: بلٹ اِن DeepSeek ایڈاپٹر

DeepSeek Harness بلٹ اِن ایڈاپٹر کی اسناد DEEPSEEK_API_KEY سے اور اُس کا endpoint DEEPSEEK_BASE_URL سے پڑھتا ہے۔

export DEEPSEEK_API_KEY="$FELO_API_KEY"
export DEEPSEEK_BASE_URL="https://openapi.felo.ai/api/v1"
npx @deepseek-ai/dsh web

http://127.0.0.1:3080 کھولیں، پھر:

1. اپنا پروجیکٹ ورک اسپیس شامل کریں یا منتخب کریں۔
2. Settings → Models کھولیں۔
3. deepseek-official فراہم کنندہ اور deepseek-v4-flash ماڈل منتخب کریں۔
4. نیا سیشن شروع کریں اور ریپو سے متعلق کوئی چھوٹا ٹاسک بھیجیں۔

base URL کے آخر میں /chat/completions نہ لگائیں۔ بلٹ اِن ایڈاپٹر خود درخواستیں {DEEPSEEK_BASE_URL}/chat/completions پر بھیجتا ہے۔

environment values محفوظ رکھیں

DeepSeek Harness اُس ڈائریکٹری سے .env فائل پڑھ سکتا ہے جہاں سے آپ اُسے شروع کرتے ہیں۔ اگر آپ ہر سیشن کے لیے یہ ویلیوز ایکسپورٹ نہیں کرنا چاہتے تو ایک غیر ٹریک شدہ .env فائل میں درج ذیل ویلیوز شامل کریں:

DEEPSEEK_API_KEY=YOUR_API_KEY
DEEPSEEK_BASE_URL=https://openapi.felo.ai/api/v1

اِس فائل کو commit نہ کریں۔ جب آپ کو صارف سطح کی کنفیگریشن درکار ہو تو آپ $DSH_HOME کے تحت ہارنس کی اسناد اور سیٹنگز فائلیں بھی استعمال کر سکتے ہیں۔

متبادل سیٹ اپ: حسب ضرورت OpenAI-compatible فراہم کنندہ

یہ طریقہ اُس وقت استعمال کریں جب آپ چاہتے ہیں کہ Felo بلٹ اِن DeepSeek کنکشن کو اوور رائیڈ کرنے کے بجائے الگ فراہم کنندہ کے طور پر نظر آئے۔

1. npx @deepseek-ai/dsh web کے ساتھ Web UI شروع کریں۔
2. Settings → Models کھولیں۔
3. Add custom provider چنیں۔
4. درج ذیل ویلیوز درج کریں اور فراہم کنندہ محفوظ کریں۔

اگر ماڈل کی خودکار دریافت ناکام ہو تو ماڈل ID دستی طور پر شامل کریں۔ فراہم کنندہ کا Get available models عمل OpenAI-compatible GET /models روٹ پر منحصر ہے اور دستی کنفیگریشن کے لیے لازمی نہیں۔

سیٹ اپ کی تصدیق کریں

نیا سیشن شروع کریں اور پوچھیں:

Summarize this repository and identify its main packages.

سیٹ اپ اُس وقت تیار ہے جب سیشن deepseek-v4-flash منتخب ہونے کے ساتھ مکمل ہو اور کوئی authentication یا unknown-model خرابی ظاہر نہ ہو۔

تجویز کردہ ایڈاپٹر کے ساتھ غیر تعاملی smoke test کے لیے ہدف ورک اسپیس سے یہ چلائیں:

npx @deepseek-ai/dsh --profile headless "List the top-level files in this workspace."

ویب سرچ کے بارے میں نوٹ

یہ سیٹ اپ ماڈل درخواستیں Felo کے ذریعے روٹ کرتا ہے۔ DeepSeek Harness کے بلٹ اِن web_search فراہم کنندہ کے endpoint کے تقاضے الگ ہیں، اگرچہ اُس کا ڈیفالٹ اسناد ویری ایبل بھی DEEPSEEK_API_KEY ہی ہے۔ DEEPSEEK_SEARCH_BASE_URL کو Felo کی طرف نہ موڑیں، الا یہ کہ آپ کوئی واضح طور پر compatible سرچ endpoint استعمال کر رہے ہوں۔ جب آپ کے ورک فلو کو Felo سرچ درکار ہو تو Felo کی Chat API یا دیگر Felo Skills الگ سے استعمال کریں۔

مسائل کا حل

اگلے مراحل

• DeepSeek Harness ریپوزٹری
• LLM API ریفرنس
• Chat API ریفرنس
• AI ایجنٹس کے لیے Felo Skills