README
¶
UIL-X (uild)
Real-time hardware governance runtime and sub-millisecond safety interlocks for edge computing and autonomous systems.
"Put WE back in PoWEr."
⚡ What is UIL-X?
As autonomous AI workloads and cyber-physical systems deploy into edge hardware, physical execution bounds, power limits, and thermal guardrails are increasingly trapped inside closed, proprietary platforms.
UIL-X flips this dynamic by providing a lightweight, low-latency background daemon (uild) written in Go. It enforces strict execution safety, constraint monitoring ($CSS\text{-}X$ / $CaP\text{-}X$), and hardware interlocks locally at the edge—keeping physical computing safe, transparent, and developer-owned.
🚀 Key Features
- Sub-Millisecond Interlocks: Real-time interception and signal termination for hardware safety breaches.
- Local Governance Daemon: Operates independently at the edge without cloud dependencies or black-box lock-in.
- Cryptographic Event Logging: Standardized $UPFo$ proof headers for auditability and state verification.
- Edge-Native Support: Built for Linux environments (x86_64 / ARM64) with support for hardware monitoring (NPUs, SBCs, single-board controllers).
🏁 Quickstart (v0.8 Alpha Preview)
# Initialize local configuration
uild init
# Run the safety governance daemon in background
uild run --config /etc/uild/config.yml
# Check daemon health and active constraint loops
uild status
Documentation
¶
Index ¶
Constants ¶
const ( // ProtocolVersion defines the current UIL specification version for v0.5 ProtocolVersion = "UIP-0.5-PQ" // Substrate Targets SubstrateAuto = "SUBSTRATE_AUTO" SubstrateRadeonVulkan = "RADEON_840M_VULKAN" SubstrateNvidiaCUDA = "NVIDIA_RTX_CUDA" SubstrateHailoNPU = "HAILO8_NPU" SubstrateMemryXNPU = "MEMRYX_NPU" SubstrateXDNA2NPU = "AMD_XDNA2_NPU" // Cryptographic Hash Algorithms HashAlgSHA3_256 = "SHA3-256" HashAlgSHA3_512 = "SHA3-512" HashAlgBLAKE3 = "BLAKE3" )
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type UILEnvelope ¶
type UILEnvelope struct {
ProtocolVersion string `json:"protocol_version"`
EnvelopeID string `json:"envelope_id"`
SourceNode string `json:"source_node"`
TargetNode string `json:"target_node,omitempty"`
Timestamp string `json:"timestamp"`
ImportanceScore float64 `json:"importance_score"`
SubstrateTarget string `json:"substrate_target"`
HashAlg string `json:"hash_alg"`
ProofCommitment string `json:"proof_commitment,omitempty"`
PQSignature string `json:"pq_signature,omitempty"` // Base64 Dilithium/SPHINCS+ sig
Payload map[string]interface{} `json:"payload"`
}
UILEnvelope defines the standardized message container across the UIL Mesh.
func NewEnvelope ¶
func NewEnvelope(sourceNode, targetNode, substrate string, payload map[string]interface{}) *UILEnvelope
NewEnvelope constructs a compliant UIL Envelope with auto-generated ID and RFC3339 timestamp.
func (*UILEnvelope) ComputePayloadHash ¶
func (e *UILEnvelope) ComputePayloadHash() (string, error)
ComputePayloadHash calculates a deterministic hash using the configured algorithm (SHA3-256 / SHA3-512).
func (*UILEnvelope) Validate ¶
func (e *UILEnvelope) Validate() error
Validate checks structural integrity and protocol compliance of the envelope.
Source Files
Directories