Iইনস্টলেশন

প্রথম প্রমাণ।

একটি পরিষ্কার মেশিন থেকে এক মিনিটেরও কম সময়ে হ্যাশড, রিপ্লেযোগ্য উত্তর। কোনো অ্যাকাউন্ট নেই, কোনো কী নেই, কোনো সার্ভার নেই। যেকোনো ভাষায় একই চারটি ধাপ চালান — প্রমাণ একই হ্যাশ।

TypeScriptNode ≥ 20

  1. 01ইনস্টল করুন

  2. 02একটি সোর্স সংযুক্ত করুন

    import { createSQAI } from "@thyn-ai/sqai";
    
    const sqai = createSQAI();
    await sqai.connect("./sales.csv",
      { name: "sales" });
  3. 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…
  4. 04একটি মান গণনা করুন

    const r = await sqai.compute({
      module: "finance", function: "npv",
      args: [0.1, [-1000, 300, 420, 560, 680]],
    });
    r.value505.020148896933
    r.computation_hashb74f67d0…d91bc8

PythonPython ≥ 3.10

  1. 01ইনস্টল করুন

  2. 02একটি সোর্স সংযুক্ত করুন

    from sqai import SQAI
    
    sqai = SQAI()
    sqai.connect("./sales.csv",
      name="sales")
  3. 03একটি কোয়েরি করুন

    a = sqai.ask({
      "metric": "revenue",
      "aggregation": "sum",
      "group_by": "region",
      "source_name": "sales",
    })
    # east 2130.5 · west 1519 · north 1000
    # plan_hash f87610d8afeb…
  4. 04একটি মান গণনা করুন

    r = sqai.compute(
      module="finance", function="npv",
      args=[0.1, [-1000, 300, 420, 560, 680]],
    )
    r["value"]505.020148896933
    r["computation_hash"]b74f67d0…d91bc8
computation_hash · TypeScript ≡ Python

b74f67d0d7a594aa7ac91f6291612452aa8ccdf603351ebc8d801a6fddd91bc8

অভিন্ন। বাইট বাই বাইট।

উভয় SDK একই ফলাফলকে একই বাইটে ক্যানোনিকালাইজ করে, তাই হ্যাশ ভাষা নির্বিশেষে মেলে — কাকতালীয়ভাবে নয়, নির্মাণগতভাবে। যেকোনো জায়গায় কলটি রিপ্লে করুন এবং এই লাইনটি প্রিন্ট হতে বাধ্য।

IIএকবারের সেটআপ

একবার প্রভিশন করুন। তারপর তাৎক্ষণিক।

ইনস্টল শেষ হওয়ার সাথে সাথে কোয়েরি প্লেন ইন-প্রসেসে চলে — কোনো ডেমন নেই, কোনো কী নেই। কম্পিউট প্লেন প্রথম compute()-এ একবার তার সাইনড রানটাইম প্রভিশন করে, তারপর রেসিডেন্ট রাখে।

await sqai.compute(…)  // first call, ever~110 সে · প্রতি মেশিনে একবার

  1. 01প্ল্যাটফর্ম বান্ডেল ডাউনলোড করুন
  2. 02RS256 সিগনেচার + প্রতিটি আর্টিফ্যাক্টের sha256 যাচাই করুন
  3. 03অ্যাটমিকভাবে এক্সট্র্যাক্ট ও ইনস্টল করুন
  4. 04রেসিডেন্ট ইঞ্জিন স্পন করুন

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: ok

doctor 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 হলো সেটি যা আপনি তার বাইরে চালান — একটি ডিভাইস সাইন ইন করুন, পরিবেশ পরীক্ষা করুন, রানটাইম পরিচালনা করুন।

  1. $sqai login [--no-browser]

    accounts.thyn.ai-এর মাধ্যমে ঐচ্ছিক ডিভাইস সাইন-ইন (RFC 8628)। এটি একটি স্বাক্ষরিত টোকেন স্থানান্তর করে — আপনার ডেটা নয়। একটি মেশিনে বিনামূল্যে।

  2. $sqai doctor [--parity] [--json]

    Node, SDK ইম্পোর্ট, এমবেডেড কন্ট্র্যাক্ট, লাইভ রানটাইম প্রোব। --parity রিড-অনলি, ডিটার্মিনিস্টিক ইনভেরিয়েন্ট নিশ্চিত করে।

  3. $sqai runtime <status|install|verify|stop>

    রেসিডেন্ট কম্পিউট রানটাইম: রিপোর্ট করুন, আগেভাগে ইনস্টল করুন, পিন করা sha256 যাচাই করুন, বন্ধ করুন।

প্রতিটি কমান্ড --json গ্রহণ করে এবং ঠিক একটি JSON অবজেক্ট প্রিন্ট করে। এক্সিট কোড স্ক্রিপ্টযোগ্য: 0 সফল · 1 চেক ব্যর্থ · 2 ব্যবহার ত্রুটি।