Iتنصیب
پہلا ثبوت۔
صاف مشین سے ہیشڈ، ری پلے ایبل جواب تک ایک منٹ سے کم میں۔ کوئی اکاؤنٹ نہیں، کوئی کی نہیں، کوئی سرور نہیں۔ کسی بھی زبان میں وہی چار مراحل چلائیں — ثبوت ایک ہی ہیش ہے۔
TypeScriptNode ≥ 20
01انسٹال کریں
02سورس جوڑیں
import { createSQAI } from "@thyn-ai/sqai"; const sqai = createSQAI(); await sqai.connect("./sales.csv", { name: "sales" });03کوئری کریں
const a = await sqai.ask({ metric: "revenue", aggregation: "sum", group_by: "region", source_name: "sales", }); // east 2130.5 · west 1519 · north 1000 // plan_hash f87610d8afeb…04قدر کمپیوٹ کریں
const r = await sqai.compute({ module: "finance", function: "npv", args: [0.1, [-1000, 300, 420, 560, 680]], });r.value505.020148896933r.computation_hashb74f67d0…d91bc8
PythonPython ≥ 3.10 درکار ہے
01انسٹال کریں
02سورس جوڑیں
from sqai import SQAI sqai = SQAI() sqai.connect("./sales.csv", name="sales")03کوئری کریں
a = sqai.ask({ "metric": "revenue", "aggregation": "sum", "group_by": "region", "source_name": "sales", }) # east 2130.5 · west 1519 · north 1000 # plan_hash f87610d8afeb…04قدر کمپیوٹ کریں
r = sqai.compute( module="finance", function="npv", args=[0.1, [-1000, 300, 420, 560, 680]], )r["value"]505.020148896933r["computation_hash"]b74f67d0…d91bc8
b74f67d0d7a594aa7ac91f6291612452aa8ccdf603351ebc8d801a6fddd91bc8
یکساں۔ بائٹ بہ بائٹ۔
دونوں SDK ایک ہی نتیجے کو ایک ہی بائٹس میں کینونیکلائز کرتے ہیں، اس لیے ہیش زبانوں میں مطابق ہوتی ہے — اتفاق سے نہیں، تعمیر سے۔ کال کو کہیں بھی ری پلے کریں اور یہ لازماً یہی سطر پرنٹ کرے گا۔
IIیک بار سیٹ اپ
ایک بار پروویژن کریں۔ پھر فوری ہے۔
کوئری پلین انسٹال مکمل ہوتے ہی ان-پروسیس چلتا ہے — کوئی ڈیمن نہیں، کوئی کی نہیں۔ کمپیوٹ پلین پہلی compute() پر اپنا سائنڈ رن ٹائم ایک بار پروویژن کرتا ہے، پھر اسے ریزیڈنٹ رکھتا ہے۔
await sqai.compute(…) // first call, ever~110 سیکنڈ · فی مشین ایک بار
await sqai.compute(…) // every call after0.83–0.93 ms · پیمائش شدہ
رن ٹائم پہلے سے ریزیڈنٹ ہے — کوئی ڈاؤن لوڈ نہیں، کوئی کولڈ اسٹارٹ نہیں، کوئی فی-کوئری سیٹ اپ نہیں۔
بنڈل فی یوزر کیش ہوتا ہے، اس لیے پروویژننگ فی مشین ایک بار ہوتی ہے — فی پروسیس نہیں۔
IIIتصدیق
ایک کمانڈ پوری مشین پڑھتی ہے۔
✓ node: v20.11.0
✓ sdk: @thyn-ai/sqai 0.1.4 imports cleanly
✓ contract: 4778 capabilities
sha256:79f1c5a6c7164e7e9e1750e70a5c03292fa87eb52d8148a740c06695924be9a1
• tested-pair: skipped (not in the repo)
• runtime: unavailable (checks skipped)
✓ doctor: okdoctor نوڈ ورژن، SDK امپورٹ، ایمبیڈڈ کنٹریکٹ، اور ایک لائیو رن ٹائم پروب جانچتا ہے۔ صاف مشین پر رن ٹائم لائن unavailable دکھاتی ہے — یہ چھوڑنا ہے، ناکامی نہیں۔ کوئری پلین کو کوئی رن ٹائم درکار نہیں۔
- 4,778 صلاحیتیں ہیش-پنڈ کنٹریکٹ میں شامل ہیں؛ 4,574 SDK کو سامنے آتی ہیں — صرف پڑھنے کے لیے، ڈیٹرمنسٹک۔
- --parity شامل کریں تاکہ وہ انویریئنٹ ثابت ہو اور کنٹریکٹ ماڈیولز کا چلتے انجن سے موازنہ ہو۔
- --json شامل کریں تاکہ بالکل ایک JSON آبجیکٹ پرنٹ ہو — CI کے لیے تیار۔
IVتقاضے
ایک منٹ کو کیا چاہیے۔
- Node
- npm پیکجز کے لیے 20 یا اس سے جدید — doctor اسے نافذ کرتا ہے۔
- Python
- PyPI پیکج کے لیے 3.10 یا اس سے جدید۔
- کمپیوٹ پلین
- darwin-arm64 یا linux-x64 — دستخط شدہ runtime پہلے compute() پر فراہم ہوتا ہے۔
- کوئری پلین
- جہاں بھی Node یا Python چلے۔
- Windows اور دیگر
- کوئری پلین مکمل طور پر کام کرتا ہے؛ compute() ایک منظم unsupported_platform خرابی لوٹاتا ہے — کبھی کریش نہیں۔
کسی معاون میزبان سے باہر، SQAI_ENGINE_URL یا SQAI_API_KEY کے ذریعے compute کو ریموٹ انجن کی طرف موڑیں — کوئریاں اور ڈسپیچ کام کرتے رہتے ہیں؛ صرف مقامی فراہمی چھوڑ دی جاتی ہے۔
Vآپریٹر کا ٹول سیٹ
SDK کے گرد تین کمانڈز۔
جوڑنا، پوچھنا، اور کمپیوٹ کرنا — سب SDK کے ذریعے عمل میں آتا ہے۔ CLI وہ ہے جو آپ اس کے گرد چلاتے ہیں — کسی ڈیوائس کو سائن ان کریں، ماحول جانچیں، runtime منظم کریں۔
$sqai login [--no-browser]
accounts.thyn.ai کے ذریعے اختیاری ڈیوائس سائن ان (RFC 8628)۔ یہ ایک دستخط شدہ ٹوکن منتقل کرتا ہے — آپ کا ڈیٹا کبھی نہیں۔ ایک مشین پر مفت۔
$sqai doctor [--parity] [--json]
Node، SDK امپورٹ، ایمبیڈڈ کنٹریکٹ، لائیو runtime پروب۔ --parity صرف پڑھنے، تعین پذیر invariant کو ثابت کرتا ہے۔
$sqai runtime <status|install|verify|stop>
مقیم کمپیوٹ runtime: اسے رپورٹ کریں، پہلے سے انسٹال کریں، پن شدہ sha256 تصدیق کریں، بند کریں۔
ہر کمانڈ --json قبول کرتی ہے اور بالکل ایک JSON آبجیکٹ پرنٹ کرتی ہے۔ ایگزٹ کوڈز اسکرپٹ کے قابل ہیں: 0 کامیاب · 1 ناکام جانچ · 2 استعمال کی خرابی۔
VIآگے