अपडेट पर वापस जाएँ
New releaseAug 19, 2026

halo-record v0.2.32

AI एजेंटों के लिए छेड़छाड़-रोधी ऑडिट ट्रेल: हैश-चेन्ड Runtime Records, डिपेंडेंसी-मुक्त, जिसे कोई भी सत्यापित कर सकता है।

साझा करें

halo-record

छेड़छाड़-स्पष्ट AI एजेंट्स के लिए ऑडिट ट्रेल्स — हैश-चेन्ड रनटाइम रिकॉर्ड्स, जिन्हें एक रनटाइम रिपोर्ट के रूप में प्रस्तुत किया जाता है जिसे आपके ग्राहक स्वयं जाँच सकते हैं।

आपकी इंस्ट्रुमेंटेशन द्वारा कैप्चर की गई हर क्रिया (टूल कॉल्स, मॉडल कॉल्स, डेटा एक्सेस, अनुमोदन) एक अपेंड-ओनली, हैश-चेन्ड लॉग में एक रनटाइम रिकॉर्ड बन जाती है; रनटाइम रिपोर्ट उस चेन को एक HTML पेज के रूप में प्रस्तुत करती है जो पाठक के ब्राउज़र में हैश चेन की पुनर्गणना करती है और जो प्रदर्शित करती है उसे उन रिकॉर्ड्स से रेंडर करती है जिन्हें उसने सत्यापित किया है (ऐसी जाँच के लिए जो पेज के अपने कोड पर निर्भर न हो, JSONL पर halo verify चलाएँ)। चेन का चेकपॉइंट रखने वाला कोई भी पक्ष सत्यापित कर सकता है कि उस चेकपॉइंट तक के रिकॉर्ड्स उसे लिए जाने के बाद से बदले नहीं गए हैं, बिना उन्हें उत्पादित करने वाले पर भरोसा किए — वह चेकपॉइंट ही भार-वहन करने वाला हिस्सा है: चेन अकेले ही रिकॉर्डर चलाने वाले पक्ष को छोड़कर सभी के विरुद्ध छेड़छाड़-स्पष्ट है (LIMITS.md §1)। जब किसी ग्राहक की सुरक्षा टीम पूछे "आपके एजेंट ने हमारे डेटा के साथ क्या किया?", तो आप उन्हें एक पैराग्राफ के बजाय एक लिंक देते हैं। सुरक्षा समीक्षाएँ पहले से ही SOC 2 चेकलिस्ट के साथ-साथ AI से जुड़े प्रश्न पूछती हैं — और तेजी से ये प्रश्न ISO 42001, EU AI Act के रिकॉर्ड-कीपिंग अनुच्छेदों, और ग्राहकों की अपनी प्रश्नावलियों से आते हैं। आज एक लिखित आश्वासन अभी भी पास हो जाता है। इस परियोजना के पीछे का दाँव यह है कि यह लंबे समय तक नहीं रहेगा।

"फोरेंसिक्स में बीस साल आपको सिखाते हैं कि साक्ष्य तभी साक्ष्य है जब दूसरा पक्ष उसे जाँच सके... भरोसे की माँग करने वाले AI उत्पादों से भरे क्षेत्र में, [Halo] उन दुर्लभ में से है जिसे भरोसे को अनावश्यक बनाने के लिए डिज़ाइन किया गया है।"

Johannes Stillig, Tidebreak AI के संस्थापक एवं CEO तथा एक निजी निवेश कार्यालय में Group CISO

Help Net Security में प्रमुखता से प्रस्तुत · उस सप्ताह के Show HN लॉन्चों में शीर्ष 4% · पाँच नियंत्रणों के विरुद्ध Agentic Trust Controls पर सूचीबद्ध

रिकॉर्ड प्रारूप खुला है और इसे लागू करना निःशुल्क है। यह पैकेज संदर्भ कार्यान्वयन है: रिकॉर्डर, सत्यापनकर्ता, विटनेस क्लाइंट, और रिपोर्ट सर्वर।

halo-record का उपयोग कर रहे हैं, या इसके बारे में सोच रहे हैं? मुझे बताएँ कि आप कौन हैं और किस लिए → halo-record का उपयोग कौन कर रहा है?

स्वयं जाँचें

आपसे कहा जा रहा है कि आप अपने एजेंट के अंदर एक रिकॉर्डर लगाएँ। आपको इसे आँख मूँदकर स्वीकार नहीं करना चाहिए:

  • शून्य रनटाइम निर्भरताएँ। केवल मानक लाइब्रेरी। pip install halo-record ठीक एक पैकेज इंस्टॉल करता है।
  • कोई नेटवर्क कॉल नहीं, सिवाय चार ऑप्ट-इन वाले — किसी witness पर एंकरिंग (subject id, एक रिकॉर्ड गणना, और दो चेन फिंगरप्रिंट भेजता है — head और chain root), किसी witness के checkpoints वापस पढ़ना (subject id भेजता है), RFC 3161 टाइमस्टैम्प (केवल एक checkpoint का state hash किसी Timestamp Authority को भेजता है), और halo serve --verify-email (एक वन-टाइम कोड और रिपोर्ट का subject name, $HALO_SMTP_HOST में आपके द्वारा कॉन्फ़िगर किए गए सर्वर के माध्यम से SMTP द्वारा, उस पते पर भेजता है जो एक रिपोर्ट दर्शक दर्ज करता है)। जब तक आप उन्हें लागू नहीं करते, ये सभी बंद रहते हैं; कोई अन्य रिकॉर्ड सामग्री आपके इंफ्रास्ट्रक्चर से बाहर नहीं जाती।
  • कच्चे टूल आर्ग्युमेंट हैश किए जाते हैं, साथ में एक रिडैक्टेड सारांश। आर्ग्युमेंट एक कैनोनिकल हैश और एक सारांश के रूप में संग्रहीत किए जाते हैं: आर्ग्युमेंट टेक्स्ट जिसमें ज्ञात secret और PII पैटर्न मास्क किए गए हों, 200 अक्षरों तक सीमित। कोई भी छोटा इनपुट जो किसी पैटर्न से मेल नहीं खाता, सारांश में पूर्ण रूप में दिखाई देता है; hash-only मोड (summaries=False) कोई सारांश नहीं रखता। रिडैक्शन सर्वोत्तम-प्रयास है (सामान्य secret और PII प्रारूपों पर regex और एक entropy catch-all): इसे defense-in-depth मानें, गारंटी नहीं। summary से परे आपके द्वारा दिए गए outcome फ़ील्ड स्कैन किए जाते हैं और उन्हीं पैटर्न से मास्क किए जाते हैं, लेकिन 200 अक्षरों तक नहीं काटे जाते (LIMITS §13)।
  • ऑडिट करने के लिए पर्याप्त छोटा। ~8,700 पंक्तियाँ Python, जिसमें रिपोर्ट पेज का एम्बेडेड JavaScript और CSS शामिल है (कोड पंक्तियाँ, रिक्त पंक्तियों, टिप्पणियों और docstrings को छोड़कर)। इसे एक दिन में पूरा पढ़ें।
  • Apache-2.0।
  • दस्तावेज़ीकरण प्रथम-श्रेणी का है। LIMITS.md (चेन क्या सिद्ध नहीं कर सकती), PRIVACY.md (रिकॉर्ड में क्या होता है और आपकी मशीन से क्या बाहर जाता है), RETENTION.md (एक retention नीति के अंतर्गत संचालन), और REVIEWERS.md — चार-कमांड स्वतंत्र जाँच के साथ-साथ समीक्षा निष्कर्षों के लिए एक उद्धरण प्रारूप।

प्रत्येक परत क्या सिद्ध करती है — इस परियोजना में भार-वहन करने वाला अंतर (LIMITS.md §1): आपके द्वारा स्वयं रखी गई चेन सिद्ध करती है कि रिकॉर्ड संपादित नहीं किए गए, उस head के सापेक्ष जो किसी के पास पहले से है; केवल ऑपरेटर के बाहर रखे गए checkpoints सिद्ध करते हैं कि कोई हटाया नहीं गया; और कोई भी हैश यह सिद्ध नहीं करता कि प्रत्येक क्रिया कैप्चर की गई थी।

दावास्व-धारित चेन+ बाहरी checkpoints+ विश्वसनीय कैप्चर
स्थापित आर्टिफ़ैक्ट में संपादन का पता लगाना✔✔✔
प्रतिबद्ध इतिहास के पुनर्लेखन का पता लगाना—✔✔
अनुपस्थित/विलंबित checkpoints का पता लगाना—✔ (सहमत कैडेंस)✔
सिद्ध करना कि प्रत्येक क्रिया रिकॉर्ड की गई थी——कैप्चर सीमा पर निर्भर

इंस्टॉल करने से पहले एक देखें: एक नमूना Runtime Report — काल्पनिक डेटा, वास्तविक चेन, और इसकी स्क्रिप्ट खोलने पर आपके ब्राउज़र में एम्बेडेड रिकॉर्ड्स की हैश चेन की पुनर्गणना करती है।

60-सेकंड डेमो

किसी एजेंट की आवश्यकता नहीं। uv के साथ, कुछ भी इंस्टॉल करने की आवश्यकता नहीं:

uvx --from halo-record halo demo --serve

या क्लासिक तरीका:

pip install halo-record
halo demo --serve

या तो दो ग्राहकों वाले एक काल्पनिक सपोर्ट-एजेंट विक्रेता का scaffold तैयार करता है, chains को witness करता है (ऑपरेटर के बाहर वाले एक witness के स्थान पर एक स्थानीय witness फ़ाइल — देखें LIMITS.md §1), उनकी gated Runtime Reports प्रस्तुत करता है, और आपके ब्राउज़र में ऑपरेटर कंसोल खोलता है। फिर tamper परीक्षण आज़माएँ: किसी एक .jsonl फ़ाइल से एक पंक्ति हटाएँ और पुनः लोड करें। रिपोर्ट इसे पकड़ लेती है।

अपने स्वयं के एजेंट को रिकॉर्ड करें

सीमा पर एक पंक्ति:

from halo_record import trace

agent = trace(run_my_agent, profile="my-agent", log="audit.jsonl")   # wraps your entrypoint; records the run boundary to ./audit.jsonl — add record_call() or a framework adapter at each tool boundary to capture individual calls

एक from halo import ... सुविधा शिम भी शिप होती है — लेकिन PyPI पर halo नाम एक असंबंधित टर्मिनल-स्पिनर पैकेज का है, और यदि वह पैकेज इंस्टॉल है तो वही इम्पोर्ट जीत लेता है। halo_record स्पष्ट है, इसलिए उदाहरण इसे ही उपयोग करते हैं।

log= के बिना, रिकॉर्ड ~/.halo/my-agent.jsonl में जाते हैं (प्रति एजेंट एक चेन)। रैपर रन की सीमा को सील करता है; साक्ष्य प्रति-कॉल रिकॉर्ड में रहता है। उन्हें एक फ्रेमवर्क एडाप्टर (नीचे मैट्रिक्स) से कैप्चर करें — या स्पष्ट रूप से, जो यह भी दिखाता है कि डेलिगेशन कैसे लिंक होता है:

from halo_record import Recorder, record_call

rec = Recorder("audit.jsonl")

with record_call(rec, "crm.lookup", {"account": "acct-9"}) as call:            # one sealed record per tool call
    call.result = crm.lookup("acct-9")

with record_call(rec, "payments.refund", {"amount": 120},
                 parent_id=rec.last_record_id()) as call:                      # child links to the action that spawned it
    call.result = payments.refund(120)

फिर रिपोर्ट रेंडर करें:

श्रेणियाँ