په ټولو ژبو کې امرونه او کوډ په انګلیسي پاتې کېږي. غټتوري ځاینښې د خپل حساب او پیسې ورکړل شوې دندې له ارزښتونو سره بدلې کړئ؛ ریښتینې کیلي په شریکو notebook-ونو یا لاګونو کې مه نښلوئ.
د امر کرښې کاري بهیر
- init / doctor پروژه جوړه او وڅېړئ
- plan بې له روزنې یې وارزوئ
- run د بودجو دننه یې وروزئ
- evaluate جلا معیارونه وګورئ
- export تایید او بستهبندي
init / doctor: پروژه جوړه او وڅېړئ. plan: بې له روزنې یې وارزوئ. run: د بودجو دننه یې وروزئ. evaluate: جلا معیارونه وګورئ. export: تایید او بستهبندي
د امرونو څرګند ترتیب تعقیب کړئ
fpai-training اجرا کېدونکی پروګرام د Python انترفېس په شان د پروژې قرارداد کاروي: پیلول، سازګاري کتل، د ازمېښتي پلان بیاکتنه، اجرا، ارزونه او صادرول. د وضعیت یا پلان لوستل د بریالۍ روزنې ثبوت نه دی.
- تصدیق د FUSIONPOINTAI_API_KEY له چاپېریاله لوستل کېږي. د امر کرښې د API key اختیار نشته.
- پر اجرا کېدونکي پروګرام یا امر --help وکاروئ. --version د نصب شوې بسته نسخه ښيي.
- بیاکتل شوی پلان حل شوي تنظیمات تثبیتوي. نادستند شوي CLI hyperparameter بدلونونه نه ملاتړ کېږي.
| ډګر یا انترفېس | ډول یا پایله | تلواله یا د وتلو کوډ | چلند او تایید |
|---|---|---|---|
init --directory PATH |
command |
اړین / تلواله نه لري | د پروژې نوې چوکاټ او د تنظیم بېلګه جوړه کړئ؛ شته ناتش ډایرکټري رد کړئ. روزنه یا پیسې ورکړل شوې غوښتنې نه کوي. |
doctor --config PATH |
command |
اړین / تلواله نه لري | schema، محلي ماډل فایلونه، تړاوونه، زېرمه، وسایل او د adapter سازګاري وګورئ. وزنونه نه بدلوي او ښوونکی نه رابولي. |
plan --config PATH --dry-run |
command |
اړین / تلواله نه لري | تلواله ارزښتونه حل، fingerprint-ونه تثبیت او موضوعات، شریکول، بودجې او محصولات وښایئ. اصلاح یا پیسې ورکړل شوی ښوونکی نه چلوي. |
run --config PATH |
command |
اړین / تلواله نه لري | بیاکتل شوی سم پلان او فعال حق غواړي؛ یوه اجرا قلف کوي او د بودجې دننه واقعي روزنه چلوي. |
status --run PATH |
command |
اړین / تلواله نه لري | د محلي اجرا پټ شوی snapshot ولولئ. Worker نه بیاپیلوي او د ښوونکي غوښتنه نه جوړوي. |
pause --run PATH |
command |
اړین / تلواله نه لري | خوندي pause وغواړئ او بشپړ atomic checkpoint ته تم شئ. یوازې د فعالې خپلې اجرا لپاره سم دی. |
resume --run PATH |
command |
اړین / تلواله نه لري | یوازې ځنډول شوې/پرې شوې بېرته رغېدونکې اجرا د سخت checkpoint او پلان تر تایید وروسته بیاپیل کړئ. |
cancel --run PATH |
command |
اړین / تلواله نه لري | خپل worker ودروئ، خپلې سرچینې خوشې او لغوه کول ثبت کړئ؛ سم محصول او تشخیص وساتئ. |
evaluate --run PATH --split test |
command |
اړین / تلواله نه لري | تثبیت شوی ماډل پر اعتبارسنجونې یا ازموینې معلوماتو وارزوئ. اصلاح او د پټو معلوماتو شریکول نه کوي. |
export --run PATH --format safetensors |
command |
اړین / تلواله نه لري | منل شوی ملاتړ شوی محصول تایید او بسته کړئ؛ بهرنی پورته کول یا ژوندی ځایپرځای کول نه کوي. |
fpai-training --version
fpai-training --help
fpai-training init --directory ./german-project
# Replace training.json and rubric/data files with your reviewed configuration.
fpai-training doctor --config ./german-project/training.json
fpai-training plan --config ./german-project/training.json --dry-run
# Inspect resolved values, data sharing and budgets BEFORE the next command.
fpai-training run --config ./german-project/training.json
fpai-training status --run ./german-project/runs/german-001
fpai-training evaluate --run ./german-project/runs/german-001 --split test
fpai-training export --run ./german-project/runs/german-001 --format safetensors
# Supply the key through FUSIONPOINTAI_API_KEY, never a command-line argument.په خوندي ډول وځنډوئ، بیاپیل یا لغوه کړئ
د کنټرول امرونه د یوې خپلې اجرا ډایرکټرۍ لپاره دي. Pause د atomic checkpoint او د worker ځواب ته تم کېږي. Resume هماغه ماډل، معلومات، تنظیم، evaluator او وېشل شوی جوړښت تاییدوي. Cancel یوازې د اجرا خپل worker دروي او وروستی لغوه شوی حالت ثبتوي. د کنټرول غوښتنې تکرار باید دویمه روزنیزه پروسه جوړه نه کړي.
- ځنډول شوې اجرا بېرته ترلاسه کېدای شي، بشپړه شوې نه ده. لغوه شوې اجرا د منلو وړ سپارل کېدونکی توکی نه دی.
- چې په مخکینۍ terminal کې اجرا روانه وي، د کنټرول لپاره دویمه terminal وکاروئ.
- د timeout وروسته تر بیا هڅې مخکې status ولولئ. قلف فایلونه مه ړنګوئ او نامربوط GPU دندې مه وژنئ.
| ډګر یا انترفېس | ډول یا پایله | تلواله یا د وتلو کوډ | چلند او تایید |
|---|---|---|---|
--directory |
path |
اړین / تلواله نه لري | د init لپاره اړین. د لیکلو وړ نوې پروژه ډایرکټري. |
--config |
path |
اړین / تلواله نه لري | د doctor، plan او run لپاره اړین. د بشپړ schema 1.0 فایل مسیر. |
--run |
path |
اړین / تلواله نه لري | د status، pause، resume، cancel، evaluate او export لپاره اړین. خپله اجرا ډایرکټري ده، د حساب/ناستې ID نه دی. |
--dry-run |
flag |
true |
د پلان څرګند اختیار؛ پلان د وزنونو او پیسې ورکړل شوي کار په اړه تل یوازې لوستل دي. د false/off اجرا حالت نشته. |
--split |
enum |
"test" |
یوازې evaluate: validation یا test. د ازموینې معلومات د پرمختګ لپاره هېڅکله نه کارېږي. |
--format |
enum |
"safetensors" |
یوازې export: safetensors یا adapters، د adapter د وړتیا تابع. |
--help |
flag |
false |
د چمتوکوونکي له لاسرسي پرته د اجرا کېدونکي یا امر مرسته وښایئ. |
--version |
flag |
false |
د نصب شوې نسخې واقعي metadata وښایئ، د تنظیم schema نسخه نه. |
# Run controls from a separate terminal if training is active.
fpai-training pause --run ./german-project/runs/german-001
# Wait for status=paused and a completed atomic checkpoint before stopping a host.
fpai-training status --run ./german-project/runs/german-001
fpai-training resume --run ./german-project/runs/german-001
# Cancellation is terminal; preserve existing artifacts, do not pretend it passed.
fpai-training cancel --run ./german-project/runs/german-001
# Repeat status, not run(), after a timeout. Never kill an unrelated process.حالت او د وتلو کوډونه یوځای تعبیر کړئ
د وتلو صفر کوډ د غوښتل شوي عملیاتو بریا ښيي؛ د status، pause یا dry-run بریالی ځواب د روزنې منل نه دي. د روزنې پایله بشپړ حالت، د منلو وړ درولو دلیل او د ارزونې ټول اړین معیارونه هم غواړي. ناکام هدفونه په راپورونو کې ښکاره پاتې کېږي او د بریا په نوم نه بدلېږي.
- امرونه ماشینلوستل کېدونکی JSON stdout ته او پټې تشخیصي نښې stderr ته لیکي. په هېڅ لاره کې پټ رازونه نه راځي.
- run او resume تر وروستي یا ځنډول شوي حالت پورې تم کېږي؛ status اوسنی snapshot ورکوي.
- SIGINT د خپلو worker-ونو د تر وسه پاکولو وروسته 130 کوډ ورکوي. پرې شوې پروسه بشپړ شوی checkpoint نه شي جوړولای.
SDK 0.2.0 EXIT AND STATE CONTRACT
0 accepted, successful read/control, or successful dry-run; inspect operation.
2 invalid configuration; no training started.
3 incompatible model/runtime/method/export combination.
4 authentication, entitlement or authorized-sharing failure.
5 resource budget exhausted; preserve latest valid checkpoint and report.
6 evaluation requirements not met; not an accepted model.
7 execution, checkpoint, cancellation-control or export failure.
130 interrupted by the caller.
Lifecycle:
planned -> preparing -> training -> evaluating -> completed
training -> pausing -> paused -> training (validated resume)
active -> cancelling -> cancelled
active -> failed
stop_reason: accepted | budget_exhausted | no_progress | regression |
cancelled | failed
paused is a recoverable state, not an accepted training result.
completed requires stop_reason=accepted and all required criteria passing.
Repeated control requests must read/reuse the owned transition, not spawn workers.
One run lock prevents duplicate execution of the same run directory.