kernel

The TAU (Tailored Agentic Units) kernel — a single Go module containing the integrated subsystems that power the TAU agent runtime.

Module

github.com/tailored-agentic-units/kernel

Subsystems

Package	Description
core/	Foundational type vocabulary: protocol constants, response types, configuration, model
agent/	LLM communication: agent interface, HTTP client, providers (Ollama, Azure), request construction, named agent registry
observability/	Event-based observability: Observer, Event, Level (OTel-aligned), SlogObserver, registry
orchestrate/	Multi-agent coordination: hubs, messaging, state graphs, workflow patterns
memory/	Unified context composition: Store interface, FileStore, Cache. Namespaces: memory/, skills/, agents/
tools/	Tool execution: global registry with Register, Execute, List
session/	Conversation management: Session interface, in-memory implementation
mcp/	Model Context Protocol client (under development)
kernel/	Agent runtime loop with config-driven initialization

ConnectRPC Interface

The kernel exposes a single ConnectRPC service (tau.kernel.v1.KernelService) as the boundary between the kernel and external extensions.

service KernelService {
  rpc CreateSession(CreateSessionRequest) returns (CreateSessionResponse);
  rpc Run(RunRequest) returns (stream RunResponse);
  rpc InjectContext(InjectContextRequest) returns (InjectContextResponse);
  rpc GetSession(GetSessionRequest) returns (GetSessionResponse);
}

Proto definitions live in rpc/proto/, generated code in rpc/gen/.

Prerequisites

• Go 1.25.7 or later
• For Ollama: Docker (optionally with nvidia-container-toolkit for GPU acceleration)
• For Azure: Azure CLI authenticated to a tenant with deployed Azure OpenAI models
• For proto codegen: buf, protoc-gen-go, protoc-gen-connect-go

Quick Start

# Start Ollama (local LLM with qwen3:8b auto-loaded)
docker compose up -d

# Run the kernel with a prompt
go run ./cmd/kernel/ \
  -config cmd/kernel/agent.ollama.qwen3.json \
  -prompt "What time is it?"

# Run the prompt-agent testing utility (direct agent interaction)
go run cmd/prompt-agent/main.go \
  -config cmd/prompt-agent/agent.ollama.qwen3.json \
  -prompt "Describe the Go programming language" \
  -stream

Development

# Run all tests
go test ./...

# Vet all packages
go vet ./...

# Lint proto definitions
cd rpc && buf lint

# Regenerate proto code
cd rpc && buf generate

Related

• tau-platform — Ecosystem coordination hub