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 Node ভার্সন, SDK ইম্পোর্ট, এমবেডেড কন্ট্র্যাক্ট এবং একটি লাইভ রানটাইম প্রোব পরীক্ষা করে। পরিষ্কার মেশিনে রানটাইম লাইনে unavailable দেখায় — এটি একটি স্কিপ, ব্যর্থতা নয়। কোয়েরি প্লেনের কোনো রানটাইম প্রয়োজন নেই।
- 4,778টি ক্যাপাবিলিটি হ্যাশ-পিনড কন্ট্র্যাক্টে শিপ হয়; 4,574টি SDK-এ উন্মুক্ত — রিড-অনলি, ডিটার্মিনিস্টিক।
- সেই ইনভেরিয়েন্ট দাবি করতে এবং চলমান ইঞ্জিনের বিপরীতে কন্ট্র্যাক্ট মডিউল ডিফ করতে --parity যোগ করুন।
- ঠিক একটি JSON অবজেক্ট প্রিন্ট করতে --json যোগ করুন — CI-এর জন্য প্রস্তুত।
IVপ্রয়োজনীয়তা
এক মিনিটের জন্য যা দরকার।
- Node
- npm প্যাকেজের জন্য 20 বা তার নতুন সংস্করণ — doctor এটি নিশ্চিত করে।
- Python
- PyPI প্যাকেজের জন্য 3.10 বা তার নতুন সংস্করণ।
- কম্পিউট প্লেন
- darwin-arm64 বা linux-x64 — স্বাক্ষরিত রানটাইম প্রথম compute()-এ প্রভিশন হয়।
- কোয়েরি প্লেন
- যেকোনো জায়গায় যেখানে Node বা Python চলে।
- Windows ও অন্যান্য
- কোয়েরি প্লেন সম্পূর্ণরূপে কাজ করে; compute() একটি কাঠামোবদ্ধ unsupported_platform ত্রুটি ফেরত দেয় — কখনো ক্র্যাশ নয়।
সমর্থিত হোস্টের বাইরে, SQAI_ENGINE_URL বা SQAI_API_KEY দিয়ে compute-কে একটি রিমোট ইঞ্জিনে নির্দেশ করুন — কোয়েরি ও ডিসপ্যাচ কাজ করতে থাকে; শুধু স্থানীয় প্রভিশনিং বাদ পড়ে।
Vঅপারেটরের টুলসেট
SDK-এর সাথে তিনটি কমান্ড।
সংযোগ, জিজ্ঞাসা ও কম্পিউটেশন — সবই SDK-এর মাধ্যমে ইন-প্রসেসে ঘটে। CLI হলো সেটি যা আপনি তার বাইরে চালান — একটি ডিভাইস সাইন ইন করুন, পরিবেশ পরীক্ষা করুন, রানটাইম পরিচালনা করুন।
$sqai login [--no-browser]
accounts.thyn.ai-এর মাধ্যমে ঐচ্ছিক ডিভাইস সাইন-ইন (RFC 8628)। এটি একটি স্বাক্ষরিত টোকেন স্থানান্তর করে — আপনার ডেটা নয়। একটি মেশিনে বিনামূল্যে।
$sqai doctor [--parity] [--json]
Node, SDK ইম্পোর্ট, এমবেডেড কন্ট্র্যাক্ট, লাইভ রানটাইম প্রোব। --parity রিড-অনলি, ডিটার্মিনিস্টিক ইনভেরিয়েন্ট নিশ্চিত করে।
$sqai runtime <status|install|verify|stop>
রেসিডেন্ট কম্পিউট রানটাইম: রিপোর্ট করুন, আগেভাগে ইনস্টল করুন, পিন করা sha256 যাচাই করুন, বন্ধ করুন।
প্রতিটি কমান্ড --json গ্রহণ করে এবং ঠিক একটি JSON অবজেক্ট প্রিন্ট করে। এক্সিট কোড স্ক্রিপ্টযোগ্য: 0 সফল · 1 চেক ব্যর্থ · 2 ব্যবহার ত্রুটি।
VIপরবর্তী