FinRobot version ও custom API guide

আপনি কোন FinRobot চালাচ্ছেন identify করুন

September 5, 2026-এ d2219100-এ reviewed official README PydanticAI, FastAPI ও React/Tauri stack-সহ FinRobot Desktop v0.1.0 describe করে। একইসঙ্গে finrobot_equity Pro workflow ও older AutoGen tutorial রাখা আছে। এগুলো interchangeable configuration surface নয়। Desktop release desktop-v0.1.0 at 6a8161ff tagged; master snapshot আলাদা source identity। Actual release বা commit, entry command ও configuration file record করুন। একই repository-তে legacy OAI_CONFIG_LIST instruction থাকলেই desktop application model load করে কীভাবে তা প্রতিষ্ঠিত হয় না।

Documented application path তুলনা করুন

Version selection-কে first compatibility check ধরুন। Desktop documentation orchestration, specialist research role ও deterministic financial computation বর্ণনা করে, কিন্তু এই review custom APIsRouter endpoint path establish করেনি। Pro script ও legacy Python agent আলাদা source-visible setting expose করে। একটির successful request অন্যটি certify করে না। Installation-এর আগে official desktop platform ও signing note review করুন; integration tutorial শেষ করতে operating-system security check bypass করবেন না।

Pro script-এর জন্যই Pro endpoint field ব্যবহার করুন

Current finrobot_equity/core/config/config.ini.example file-এ openai_api_key, openai_base_url ও openai_model আছে। generate_financial_analysis.py optional base URL ও model পড়ে text-generation path-এ forward করে। নিচের template verified field adapt করে; uppercase placeholder locally replace করুন। এই INI file environment-variable interpolation বোঝায় না। Real file local permission দিয়ে protect করুন, version control থেকে বাদ দিন এবং support log-এ publish করবেন না। Financial-data key model credential থেকে independent থাকে।

[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 input দিয়ে Pro text-generation path run করুন

Company identity ও protected configuration file-সহ Pro analysis script run করুন, তারপর report rendering-এর আগে generated analysis inspect করুন। Financial acquisition, forecast assumption ও numerical calculation নিচে দেখানো model narration route থেকে আলাদা থাকে। International issuer হলে result compare করার আগে data provider-এর exchange coverage, reporting currency ও accounting basis check করুন। Share count, fiscal period ও currency conversion explicitভাবে resolve করুন। প্রথম inspectable report packet তৈরির সময় কেবল required stage run করুন।

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 calculation reproducible রাখুন

Current desktop architecture financial computation-কে LLM explanation থেকে explicitভাবে আলাদা করে। যেকোনো FinRobot artifact review করার সময় একই acceptance principle প্রয়োগ করুন: displayed number-কে source input, unit, assumption ও যে calculation তা তৈরি করেছে তার দিকে trace করুন। Deterministic valuation-ও uncertain forecast-এর ওপর নির্ভর করে; reproducibility forecast সত্যি হবে এমন proof নয়। Base assumption ও alternative scenario আলাদা রাখুন, formula preserve করুন এবং target value নীরবে select না করে model-কে sensitivity discuss করতে দিন। Reviewer authorized assumption না দেওয়া পর্যন্ত missing input missing-ই থাকবে।

Legacy AutoGen notebook-কে আলাদা migration ধরুন

Retained finrobot/agents/workflow.py AutoGen import করে এবং llm_config গ্রহণ করে। Legacy tutorial OAI_CONFIG_LIST দিয়ে model entry load করে এবং ওই workflow-এ config list pass করে। এই path maintain করলে notebook ও dependency version একসঙ্গে অনুসরণ করুন। Modern PydanticAI configuration এতে transplant করবেন না বা OAI_CONFIG_LIST-কে universal FinRobot setting বলবেন না। Existing report process migrate করতে base URL replace ছাড়াও tool, 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 ও citation-সহ একটি report section validate করুন। Secret বাদ দিয়ে application revision, source hash, configuration, resolved model ID ও observed usage record করুন। Generated text unit preserve করে এবং reported fact ও projection আলাদা করে কি না check করুন। Transport hello বা model factory response কেবল ওই stage প্রমাণ করে। Full-report acceptance-এর জন্য data completeness, calculation review, readable output ও traceable claim-ও দরকার।

Stage boundary-তে budget ও recovery রাখুন

Financial-data charge, model request, report-rendering resource ও analyst review আলাদা করুন। Estimate-এর জন্য current pricing ব্যবহার করে পরে retry ও failure-সহ request ledger reconcile করুন। API field ignored হলে আরও configuration file যোগ না করে precise entry script inspect করুন। Report empty হলে model বদলানোর আগে acquisition ও parsing log inspect করুন। Numerical input conflict করলে report review-এর জন্য pause করে দুই source value রাখুন। Corrected stage থেকে resume করুন, যাতে completed report প্রতিটি change-এর কারণ preserve করে।

Evidence ও সীমাবদ্ধতা

Source ও release documentation September 5, 2026-এ review করা হয়েছে। Pro endpoint field ও forwarding d2219100-এ confirmed; desktop custom gateway path এখনও unverified। এই guide-এর জন্য কোনো APIsRouter request, complete report বা measured usage case execute করা হয়নি। Pro example নাম দেওয়া script-এর জন্য, desktop বা প্রতিটি legacy notebook-এর জন্য নয়।

সাধারণ প্রশ্ন