मुख्य सामग्री पर जाएं
प्रशिक्षण मार्गदर्शिका के अध्याय सभी दस्तावेज़

TrainingProject बनाएँ और चलाएँ

SDK 0.2.0 इंस्टॉल करें, प्रोजेक्ट कॉन्फ़िगर करें, प्लान की समीक्षा करें और स्थानीय मॉडल को ट्रेन करें।

प्रशिक्षण मार्गदर्शिका के अध्याय

हर भाषा में कमांड और कोड अंग्रेज़ी में ही रहेंगे। बड़े अक्षरों वाले प्लेसहोल्डर को अपने खाते और भुगतान किए गए कार्य के मानों से बदलें; साझा नोटबुक या लॉग में असली कुंजियाँ न डालें।

TrainingProject बनाएँ और चलाएँ

स्थानीय मॉडल फ़ाइल इस्तेमाल करने से पहले प्लान और मूल्यांकन देखें।
  1. इंस्टॉल करें Python परिवेश
  2. कॉन्फ़िगर करें मॉडल, डेटा और रूब्रिक
  3. प्लान अनुकूलता और बजट
  4. ट्रेन करें स्थानीय अनुकूलन
  5. जाँचें मूल्यांकन और मॉडल फ़ाइल

इंस्टॉल करें: Python परिवेश. कॉन्फ़िगर करें: मॉडल, डेटा और रूब्रिक. प्लान: अनुकूलता और बजट. ट्रेन करें: स्थानीय अनुकूलन. जाँचें: मूल्यांकन और मॉडल फ़ाइल

अपना परिवेश तैयार करें

Python 3.10 या नया एक अलग वर्चुअल परिवेश में चलाएँ। ट्रेनिंग एक्स्ट्रा और रनटाइम के अनुकूल PyTorch इंस्टॉल करें। TrainingProject, Transformers के मौजूदा causal-language-model अडैप्टर का उपयोग करता है, जो SFT, LoRA और QLoRA की अनुकूलता जाँचता है। शिक्षक से जुड़े कामों के लिए खाते की API key, सशुल्क संदर्भ मॉडल तक सक्रिय पहुँच, संगत स्थानीय मॉडल, स्वीकृत डेटा और पर्याप्त स्टोरेज चाहिए। रनटाइम चुनने से हार्डवेयर नहीं मिलता।

  • मुख्य पैकेज में TrainingClient और प्रोजेक्ट API हैं; train एक्स्ट्रा स्थानीय मॉडल ट्रेन करने की निर्भरताएँ इंस्टॉल करता है।
  • API key को रनटाइम के सीक्रेट में रखें, प्रोजेक्ट फ़ाइलों या कमांड के तर्कों में नहीं।
  • QLoRA के लिए संगत CUDA रनटाइम और क्वांटाइज़ेशन की निर्भरताएँ चाहिए।
उदाहरण · bash
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
# Install the GPU-compatible PyTorch build for your runtime first.
python -m pip install 'fusionpointai-training[train] @ https://fusionpointai.com/downloads/fusionpointai-training.zip'
# API-only use without local training dependencies:
# python -m pip install 'fusionpointai-training @ https://fusionpointai.com/downloads/fusionpointai-training.zip'

प्रोजेक्ट कॉन्फ़िगर करें और प्लान देखें

प्रोजेक्ट डायरेक्टरी बनाएँ और ट्रेनिंग, वैलिडेशन तथा फ़ाइनल टेस्ट की JSONL फ़ाइलें तैयार करें। फिर training.json और rubric.json संपादित करें। स्थानीय विद्यार्थी मॉडल का पथ, सेवा-प्रदाता और शामिल reference_model_id तय करें। प्लान कॉन्फ़िगरेशन, मॉडल की अनुकूलता, डेटा फ़िंगरप्रिंट, साझा करने की नीति, बजट और आउटपुट जाँचता है; यह न भार बदलता है, न शिक्षक को अनुरोध भेजता है।

  • schema_version 1.0 रखें; यह कॉन्फ़िगरेशन स्कीमा का संस्करण है, पैकेज का नहीं।
  • प्रोजेक्ट रूट के भीतर आने वाले सापेक्ष पथ रखें।
  • हर नए रन के लिए नई आउटपुट डायरेक्टरी चाहिए। resume अलग कार्रवाई है और फ़िंगरप्रिंट की सख़्त जाँच करता है।
उदाहरण · bash
# Enter the key using a secure runtime secret facility or this history-safe prompt.
read -rs -p 'FusionPointAI API key: ' FUSIONPOINTAI_API_KEY
export FUSIONPOINTAI_API_KEY
printf '\n'
python --version
fpai-training --version
# After the project run, clear the shell value: unset FUSIONPOINTAI_API_KEY
उदाहरण · json
{
  "schema_version": "1.0",
  "mode": "automatic",
  "objective": "Classify support messages as billing, account_access or technical_issue.",
  "model": {"path": "./models/student", "adapter": "transformers-causal-lm", "revision": null},
  "teacher": {"provider": "openai", "reference_model_id": 123},
  "data": {
    "sources": ["./data/train.jsonl"], "teacher_sharing": "none",
    "validation_path": "./data/validation.jsonl", "test_path": "./data/test.jsonl",
    "deduplicate": true, "seed": 42
  },
  "runtime": {"target": "customer_datacenter", "devices": "auto"},
  "training": {"method": "auto"},
  "curriculum": {"topics": ["intent", "ambiguous_requests", "class_balance"], "max_improvement_cycles": 3, "stop_on_regression": true},
  "budgets": {"max_training_minutes": 120, "max_teacher_requests": 1000, "max_storage_gib": 20},
  "checkpoints": {"keep_last": 3},
  "evaluation": {"rubric": "./rubric.json", "baseline_required": true},
  "output": {"directory": "./runs/german-001", "format": "safetensors"}
}
उदाहरण · python
import os
from fusionpointai_training import TrainingProject

project = TrainingProject.from_file(
    "./support-project/training.json",
    api_key=os.environ["FUSIONPOINTAI_API_KEY"],
)
plan = project.plan(dry_run=True)
print("Topics:", plan["topics"], "Budgets:", plan["budgets"])
result = project.run()
print("Run:", result["run_id"], result["status"], result["stop_reason"])
evaluation = project.evaluate(split="test")
print("Accepted:", evaluation["accepted"], evaluation["report_path"])
artifact = project.export(format="safetensors")
print("Artifact:", artifact["artifact_path"], artifact["sha256"])

मूल्यांकन और स्थानीय मॉडल फ़ाइल जाँचें

प्रशिक्षण में बिना बदले मॉडल का baseline और स्थानीय held-out पंक्तियों पर अंतिम मूल्यांकन होता है। रिपोर्ट मापे गए मानदंड, गिरावट, फ़िंगरप्रिंट, बजट और अधूरी ज़रूरतें दर्ज करती हैं। Export स्थानीय safetensors मॉडल या adapter package जाँचकर manifest लिखता है। Adapter को उसी pin किए base model और tokenizer की ज़रूरत होती है। सफल run मापे गए rubric से आगे की गुणवत्ता की गारंटी नहीं देता।

  • Baseline और final held-out फ़ाइलें training और teacher input से अलग रखें।
  • evaluation-report.json और artifact-manifest.json इस्तेमाल से पहले देखें।
  • Export मॉडल upload नहीं करता और production inference deploy नहीं करता।
उदाहरण · bash
cat ./support-project/runs/support-001/training-report.json
cat ./support-project/runs/support-001/evaluation-report.json
cat ./support-project/runs/support-001/artifact-manifest.json
sha256sum ./support-project/runs/support-001/exports/safetensors/artifact-manifest.json
# Compare the digest with the value returned by project.export().
# Adapter exports also require the matching base model and tokenizer.