Welcome

Krnl-AI Community

A cognitive runtime for building local-first agents with persistent memory, safety checks, evolving skills, and developer tooling.

Krnl-AI Community is the open, local-first edition of Krnl-AI. It runs entirely on your machine without requiring hosted infrastructure. All state is stored locally via SQLite, and you can bring your own LLM provider (OpenAI, Ollama, Anthropic, etc.).

Quick Start

dotnet tool install -g KrnlAI.Cli
krnlai config set provider ollama
krnlai chat --local

What You Can Build

• Local agents with your preferred LLM
• Persistent memory backed by SQLite with semantic search
• Skills that can be created, refined, exported, and installed
• Safety-aware execution with 20 fundamental rules (R01-R20)
• Editor integrations for VS Code and Visual Studio
• Cross-platform desktop apps via WPF and Tauri

Packages

Package	Purpose
KrnlAI.Cli	Local CLI and interactive TUI
KrnlAI.Sidecar	Local HTTP sidecar for tools and editors
KrnlAI.Contracts	Public DTOs and interfaces
KrnlAI.Embedded	In-process kernel for community apps

SDKs

SDK	Language	Source
Python SDK	Python 3.10+	sdk/python/
.NET SDK	netstandard2.0	sdk/dotnet/

Documentation Map

Section	Description
Getting Started	Install, configure, first run
CLI Reference	All CLI commands and options
Architecture	System design and principles
Cognitive Cycle	10-step cognitive processing pipeline
Memory System	Episodic, semantic, working, emotional memory
Safety System	20 fundamental rules, adversarial guard, ethics
Emotion System	VAD model, pain/reward, emotional memory
SDK Guide	Python and .NET SDK documentation
Sidecar API	HTTP API endpoints reference
Desktop Apps	WPF and Tauri desktop applications
Editor Extensions	VS Code and Visual Studio extensions
Samples	Example projects and patterns
Integrations	LangChain, CrewAI, AutoGen, FastAPI
Contributing	How to contribute to the project

Community

• GitHub Issues — Bug reports and feature requests
• GitHub Discussions — Q&A, ideas, and showcase (when enabled)
• License — MIT