FinRobot version اور custom API guide

Identify کریں کون سا FinRobot چلا رہے ہیں

5 ستمبر 2026 کو d2219100 پر reviewed official README FinRobot Desktop v0.1.0 کو PydanticAI، FastAPI اور React/Tauri کے ساتھ بیان کرتی ہے۔ اسی repository میں finrobot_equity Pro workflow اور پرانے AutoGen tutorials بھی ہیں۔ یہ interchangeable configuration surfaces نہیں۔ Desktop release desktop-v0.1.0 پر 6a8161ff tagged ہے؛ master snapshot الگ source identity ہے۔ Actual release یا commit، entry command اور configuration file record کریں۔ Legacy OAI_CONFIG_LIST instructions ایک repository میں ہونے سے desktop model loading ثابت نہیں ہوتی۔

Documented application paths compare کریں

Version selection کو پہلا compatibility check سمجھیں۔ Desktop documentation orchestration، specialist research roles اور deterministic financial computation بتاتی ہے، مگر review نے اس کا custom APIsRouter endpoint path establish نہیں کیا۔ Pro script اور legacy Python agents کے source-visible settings مختلف ہیں۔ ایک path کی successful request دوسرے کو certify نہیں کرتی۔ Installation سے پہلے official desktop platform اور signing notes بھی پڑھیں؛ integration tutorial مکمل کرنے کے لیے operating-system security checks bypass نہ کریں۔

Pro endpoint fields صرف Pro script کے لیے استعمال کریں

Current finrobot_equity/core/config/config.ini.example میں openai_api_key، openai_base_url اور openai_model شامل ہیں۔ generate_financial_analysis.py optional base URL اور model پڑھ کر text-generation path کو forward کرتی ہے۔ نیچے template verified fields کو adapt کرتی ہے؛ uppercase placeholders locally replace کریں۔ یہ INI file environment-variable interpolation imply نہیں کرتی۔ Real file local permissions سے protect کریں، version control سے خارج کریں اور support logs میں publish نہ کریں۔ Financial-data key model credential سے الگ ہے۔

[API_KEYS]
fmp_api_key = YOUR_FINANCIAL_DATA_KEY
openai_api_key = YOUR_APISROUTER_KEY
openai_base_url = https://api.apisrouter.com/v1
openai_model = CURRENT_CATALOG_MODEL_ID

Explicit inputs کے ساتھ Pro text-generation path چلائیں

Pro analysis script کو company identity اور protected configuration file کے ساتھ چلائیں، پھر report rendering سے پہلے generated analysis inspect کریں۔ Financial acquisition، forecast assumptions اور numerical calculations model narration route سے الگ رہیں۔ International issuer میں results compare کرنے سے پہلے data provider کی exchange coverage، reporting currency اور accounting basis check کریں۔ Share counts، fiscal periods اور currency conversion explicit resolve کریں۔ پہلا inspectable report packet بناتے وقت صرف required stages چلائیں۔

python finrobot_equity/core/src/generate_financial_analysis.py \
  --company-ticker "$RESEARCH_TICKER" \
  --company-name "$RESEARCH_COMPANY" \
  --config-file finrobot_equity/core/config/config.ini \
  --generate-text-sections

Financial calculations reproducible رکھیں

Current desktop architecture financial computation کو LLM explanation سے explicitly الگ کرتی ہے۔ FinRobot artifact review کرتے وقت displayed number کو source inputs، units، assumptions اور calculation تک trace کریں۔ Deterministic valuation بھی uncertain forecasts پر depend کرتی ہے؛ reproducibility ان forecasts کے درست ہونے کا proof نہیں۔ Base assumptions اور alternative scenarios الگ رکھیں، formulas محفوظ کریں اور model سے sensitivities discuss کرائیں، target value خاموشی سے select نہ ہونے دیں۔ Missing inputs reviewer authorized assumption دے تب تک missing رہیں۔

Legacy AutoGen notebooks کو الگ migration سمجھیں

Retained finrobot/agents/workflow.py AutoGen import کرتی اور llm_config قبول کرتی ہے۔ Legacy tutorials OAI_CONFIG_LIST سے model entries load کر کے config list workflow کو دیتی ہیں۔ اس path میں notebook اور dependency version ساتھ follow کریں۔ Modern PydanticAI configuration اس میں transplant نہ کریں اور OAI_CONFIG_LIST کو universal FinRobot setting نہ کہیں۔ Existing report process migrate کرتے وقت صرف base URL replace نہیں، tools، data-key loading، code-execution behavior اور report generation بھی check کریں۔

Input سے source locator تک ایک report validate کریں

Bounded public filing packet اور narrow question سے شروع کریں۔ Separately authorized client test کے بعد ایک required data tool، ایک numerical calculation اور citations والا ایک report section validate کریں۔ Application revision، source hashes، secrets کے بغیر configuration، resolved model ID اور observed usage record کریں۔ Generated text units محفوظ رکھتی اور reported facts کو projections سے الگ کرتی ہے یا نہیں چیک کریں۔ Transport hello یا model factory response صرف وہ stage ثابت کرتی ہے؛ full report کے لیے data completeness، calculation review، readable output اور traceable claims بھی چاہیے۔

Stage boundaries پر budget اور recovery رکھیں

Financial-data charges، model requests، report-rendering resources اور analyst review الگ رکھیں۔ Estimate کے لیے current pricing، پھر retries اور failures سمیت request ledger reconcile کریں۔ API field ignore ہو تو configuration files بڑھانے سے پہلے precise entry script inspect کریں۔ Report empty ہو تو model بدلنے سے پہلے acquisition اور parsing logs دیکھیں۔ Numerical inputs conflict کریں تو report review کے لیے pause کریں اور دونوں source values رکھیں۔ Corrected stage سے resume کریں تاکہ completed report ہر change کی وجہ محفوظ رکھے۔

Evidence اور limitations

Source اور release documentation 5 ستمبر 2026 کو review ہوئی۔ Pro endpoint fields اور forwarding d2219100 میں confirmed ہیں؛ desktop custom gateway path unverified ہے۔ اس guide کے لیے APIsRouter request، complete report یا measured usage case execute نہیں ہوا۔ Pro examples named scripts پر لاگو ہیں، desktop یا ہر legacy notebook پر نہیں۔

عمومی سوالات