हर भाषा में कमांड और कोड अंग्रेज़ी में ही रहेंगे। बड़े अक्षरों वाले प्लेसहोल्डर को अपने खाते और भुगतान किए गए कार्य के मानों से बदलें; साझा नोटबुक या लॉग में असली कुंजियाँ न डालें।
कमांड-पंक्ति का वर्कफ़्लो
-
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 |
अनिवार्य / कोई डिफ़ॉल्ट नहीं | स्कीमा, स्थानीय मॉडल फ़ाइलें, निर्भरताएँ, भंडारण, डिवाइस और एडैप्टर कम्पैटिबिलिटी जाँचें। वेट में बदलाव या शिक्षक से सामग्री बनवाना नहीं। |
plan --config PATH --dry-run |
command |
अनिवार्य / कोई डिफ़ॉल्ट नहीं | डिफ़ॉल्ट तय करें, फ़िंगरप्रिंट पिन करें और विषय, साझाकरण, बजट तथा आउटपुट दिखाएँ। अनुकूलन या शिक्षक को सशुल्क अनुरोध नहीं। |
run --config PATH |
command |
अनिवार्य / कोई डिफ़ॉल्ट नहीं | समीक्षित मान्य योजना और सक्रिय अधिकार ज़रूरी करें; एक रन लॉक करके बजट के भीतर असली ट्रेनिंग चलाएँ। |
status --run PATH |
command |
अनिवार्य / कोई डिफ़ॉल्ट नहीं | स्थानीय रन की स्थिति-सारांश संवेदनशील जानकारी हटाकर पढ़ें। कार्यकर्ता फिर शुरू नहीं करता और शिक्षक-अनुरोध नहीं भेजता। |
pause --run PATH |
command |
अनिवार्य / कोई डिफ़ॉल्ट नहीं | सुरक्षित पॉज़ माँगें और पूरा परमाण्विक चेकपॉइंट आने तक प्रतीक्षा करें। केवल सक्रिय, आपके स्वामित्व वाले रन के लिए मान्य। |
resume --run PATH |
command |
अनिवार्य / कोई डिफ़ॉल्ट नहीं | सख़्त चेकपॉइंट और योजना-जाँच के बाद ही रुका या बाधित, रिकवर किया जा सकने वाला रन फिर शुरू करें। |
cancel --run PATH |
command |
अनिवार्य / कोई डिफ़ॉल्ट नहीं | अपने कार्यकर्ता रोकें, अपने संसाधन मुक्त करें और कैंसलेशन दर्ज करें; मान्य आउटपुट और जाँच-सूचनाएँ सुरक्षित रखें। |
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.
सुरक्षित रूप से रोकें, फिर जारी करें या रद्द करें
नियंत्रण कमांड आपके रन की डायरेक्टरी पर काम करते हैं। रोकने पर परमाणु चेकपॉइंट बनने और वर्कर की पुष्टि मिलने तक इंतज़ार होता है। फिर से शुरू करते समय उसी मॉडल, डेटा, कॉन्फ़िगरेशन, मूल्यांकनकर्ता और वितरित व्यवस्था का मेल जाँचा जाता है। रद्द करने पर सिर्फ़ उसी रन के वर्कर रुकते हैं और अंतिम स्थिति दर्ज होती है। कमांड दोहराने से दूसरी ट्रेनिंग प्रक्रिया शुरू नहीं होनी चाहिए।
- रुका हुआ रन फिर शुरू किया जा सकता है, लेकिन वह पूरा नहीं हुआ है। रद्द किया रन स्वीकृत डिलीवरी नहीं है।
- मुख्य रन चलते समय नियंत्रण के लिए दूसरा टर्मिनल इस्तेमाल करें।
- समय-सीमा बीतने पर दोबारा कोशिश से पहले स्थिति देखें। लॉक फ़ाइलें न मिटाएँ और असंबंधित GPU काम न रोकें।
| फ़ील्ड या इंटरफ़ेस | प्रकार या परिणाम | डिफ़ॉल्ट या एग्ज़िट कोड | व्यवहार और सत्यापन |
|---|---|---|---|
--directory |
path |
अनिवार्य / कोई डिफ़ॉल्ट नहीं | init के लिए ज़रूरी। लिखने योग्य नई प्रोजेक्ट डायरेक्टरी।
|
--config |
path |
अनिवार्य / कोई डिफ़ॉल्ट नहीं | doctor, plan और run के लिए ज़रूरी। पूरी स्कीमा 1.0 फ़ाइल का पथ।
|
--run |
path |
अनिवार्य / कोई डिफ़ॉल्ट नहीं | status, pause, resume, cancel, evaluate और export के लिए ज़रूरी। आपकी रन डायरेक्टरी, खाता/सत्र ID नहीं।
|
--dry-run |
flag |
true |
योजना का साफ़ फ़्लैग; वेट और सशुल्क काम के मामले में plan हमेशा केवल पढ़ने के लिए है। false या off वाला रन-मोड नहीं है।
|
--split |
enum |
"test" |
केवल evaluate: सत्यापन या टेस्ट। टेस्ट डेटा सुधार के लिए कभी इस्तेमाल नहीं होता।
|
--format |
enum |
"safetensors" |
केवल export: safetensors या adapters, एडैप्टर की क्षमता के अनुसार।
|
--help |
flag |
false |
प्रोवाइडर से संपर्क किए बिना निष्पादन-फ़ाइल या कमांड की मदद दिखाएँ। |
--version |
flag |
false |
वास्तव में इंस्टॉल किए रिलीज़ की जानकारी दिखाएँ, कॉन्फ़िगरेशन स्कीमा का संस्करण नहीं। |
# 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.
स्टेटस और एग्ज़िट कोड साथ समझें
शून्य एग्ज़िट कोड का मतलब है कि माँगी गई कार्रवाई सफल हुई; लेकिन स्टेटस पढ़ने, पॉज़ करने या ड्राई रन की सफलता ट्रेनिंग की स्वीकृति नहीं है। ट्रेनिंग के नतीजे के लिए रन पूरा होना, स्वीकृत स्टॉप रीज़न और सभी ज़रूरी मूल्यांकन मानदंड पूरे होना भी ज़रूरी है। विफल लक्ष्य रिपोर्ट में साफ़ दिखने चाहिए; उन्हें सफल बताकर पेश न करें।
- कमांड stdout में मशीन-पठनीय JSON और stderr में संवेदनशील जानकारी हटाकर डायग्नॉस्टिक्स लिखते हैं। किसी भी स्ट्रीम में सीक्रेट नहीं आते।
runऔरresumeअंतिम या पॉज़ हुई स्थिति आने तक इंतज़ार करते हैं;statusमौजूदा स्नैपशॉट लौटाता है।SIGINTअपने वर्कर को जितना हो सके साफ़ करने के बाद 130 एग्ज़िट कोड देता है। बीच में रुकी प्रक्रिया पूरा चेकपॉइंट गढ़ नहीं सकती।
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.