version: 0.1.2 / status: Active / edition: Canonical Series / published: 2026-06-16 / updated: 2026-06-16

AIKernel Package Installation Guide

AIKernel 0.1.2 is the next canonical package series for the Semantic OS surface. It aligns NuGet packages and Python wrapper packages around the same public API catalog, while keeping implementation logic in the managed package layer.

Do not create stable 0.1.2 packages until the release task is explicitly opened. During integration and repository-to-repository verification, use local development package versions:

Package system	Development version
NuGet	`0.1.2-dev<build-number>`
PyPI	`0.1.2.dev<build-number>`

The shared release and package-alignment rules are defined in ../development/package-release-alignment-v0.1.2.md. The CTG-ROM carried from the RC5 monolith is aligned to canonical 0.1.2 metadata without changing its rule text or semantic content; see CTG_ROM_LAYOUT-v0.1.2.md.

Quick Start: Canonical 0.1.2

After the stable release is opened, install matching 0.1.2 packages by layer:

dotnet add package AIKernel.Core --version 0.1.2\ndotnet add package AIKernel.Providers.Standard --version 0.1.2\ndotnet tool install -g AIKernel.Tools.CLI --version 0.1.2

During local validation, replace stable versions with 0.1.2-dev<build-number> and use the local NuGet package source generated by the dependency-order build.

Then verify the command-line surface:

aik runtime ping\naik system info\naik system vfs --vfs-root .\naik capabilities invoke aikernel.vfs vfs.exists path=README.md

NuGet Packages

Layer	Package	Purpose
Contract boundary	`AIKernel.Abstractions`	Interface and OS boundary contracts.
Contract DTOs	`AIKernel.Contracts`	Contract-level request, response, and policy shapes.
Contract DTOs	`AIKernel.Dtos`	Public data-transfer objects used across the runtime.
Contract enums	`AIKernel.Enums`	Stable enum vocabulary for the Semantic OS.
Functional primitives	`AIKernel.Common`	Result, Option, Try, Async, identifiers, hashing, and deterministic helpers.
Runtime	`AIKernel.Core`	Kernel runtime, VFS, ROM, DSL, process, compute, routing, CTG, and OS abstractions.
Hosting	`AIKernel.Hosting`	Host composition and dependency-injection support.
Kernel facade	`AIKernel.Kernel`	Kernel-facing facade package for application entry points.
Governance	`AIKernel.Control`	Deterministic control plane, policy, emulator, and governance execution.
Standard drivers	`AIKernel.Providers.Standard`	CPU compute, file systems, logging, event bus, network, profiler, and scheduler providers.
Provider extensions	`AIKernel.Providers.*`	Runtime-configurable and descriptor-driven provider families.
Tools	`AIKernel.Tools.*`	Canonical formatting, inspection, replay, instrumentation, and CLI.
WASM	`AIKernel.Wasm.*`	WASM runtime, WebGPU, WebAudio, perception, HUD, overlay, and sandbox surfaces.
CUDA native	`AIKernel.Cuda13.0.Libtorch2.12.win-x64`	Windows-only LibTorch 2.12 / CUDA 13.0 package.

CUDA is intentionally platform-scoped. Use the CUDA package only on Windows win-x64 environments that satisfy its native runtime requirements.

PyPI Packages

The 0.1.2 line publishes Python packages as thin wrappers over the managed package API catalog. Python packages must not reimplement CTG, provider routing, WASM execution, CUDA runtime behavior, or Doom scenario logic.

Package	Import Surface	Purpose
`aikernel-net`	`aikernel_net`	Core runtime wrapper, managed API catalog, assembly discovery, and CTG-ROM sample assets.
`aikernel-governance`	`aikernel_governance`	Control and governance wrapper.
`aikernel-providers`	`aikernel_providers`	Provider descriptors, manifests, and invoker wrappers.
`aikernel-tools`	`aikernel_tools`	Instrumentation, formatter, inspector, replay, and CLI-adjacent wrappers.
`aikernel-wasm`	`aikernel_wasm`	WASM runtime and WebGPU wrapper surface.
`aikernel-cuda13-libtorch2-12-win-x64`	`aikernel_cuda13_libtorch2_12_win_x64`	Windows-only CUDA wrapper metadata and loader guidance.

After the stable release is opened:

pip install aikernel-net==0.1.2\npip install aikernel-providers==0.1.2\npip install aikernel-tools==0.1.2

Add governance, WASM, or CUDA wrappers when the application uses those surfaces:

pip install aikernel-governance==0.1.2\npip install aikernel-wasm==0.1.2\npip install aikernel-cuda13-libtorch2-12-win-x64==0.1.2

During local validation, install local wheels with 0.1.2.dev<build-number> and verify the wrapper API catalog against the C# public surface.

Dependency Order

Build and validate package families in dependency order:

AIKernel.NET
AIKernel.Core
AIKernel.Control
AIKernel.Providers
AIKernel.Cuda13.0
AIKernel.Wasm
AIKernel.Tools
Demo repositories: AIKernel.Demo, AIKernel.Doom

Demo repositories are validation targets, not package-publication targets.

Provider Selection

Choose the provider package by the runtime boundary you need:

Scenario	Package
Local OS services, file systems, logging, scheduler, profiler	`AIKernel.Providers.Standard`
Local LLM experimentation without a hosted API	`AIKernel.Providers.LocalLlm`
OpenAI chat integration	`AIKernel.Providers.ChatOpenAI`
Microsoft AI integration	`AIKernel.Providers.MicrosoftAI`
Lightweight history-backed inference surfaces	`AIKernel.Providers.ChatHistory`
Dynamic DSL pipeline compilation	`AIKernel.Providers.DynamicPipelineCompiler`
CUDA compute capability bridge	`AIKernel.Providers.CudaCompute` plus the CUDA runtime package when needed

Historical Lines

Line	Meaning
`0.1.2`	First synchronized public Semantic OS package line.
`0.1.2`	Unified public canonical package line for NuGet packages and synchronized Python wrappers.
`0.1.2`	Current canonical series target. NuGet and PyPI package families are synchronized when publication opens.

Historical 0.1.2 CTG documents remain available for migration context:

Repository Links

AIKernel.NET - contract boundary packages.
AIKernel.Core - runtime and OS abstractions.
AIKernel.Providers - standard and extension provider drivers.
AIKernel.Control - governance and control plane.
AIKernel.Tools - instrumentation and CLI.
AIKernel.Wasm - sandboxed WASM runtime.
AIKernel.Cuda13.0 - Windows CUDA package line.
AIKernel.Demo - official examples.

Release Rule

Use only matching 0.1.2 package families together for the canonical line. Do not mix 0.1.2, 0.1.2, and 0.1.2 packages in a release validation environment unless the task explicitly tests migration behavior.

Stable packages are created only after the publication task is opened. Until then, all local package validation uses:

NuGet: 0.1.2-dev<build-number>\nPyPI:  0.1.2.dev<build-number>

Source: operations/PACKAGE_INSTALLATION_GUIDE.md