Metadata-Version: 2.4
Name: kernell-os-sdk
Version: 2.7.0
Summary: First public release of an agentic runtime for M2M coordination. Machines coordinate, verify, and settle value autonomously.
Project-URL: Homepage, https://kernell.site
Project-URL: Repository, https://github.com/Greco-Italico/kernell-os-sdk
Project-URL: Documentation, https://kernell.site/docs/sdk
Author-email: Kernell OS <dev@kernell.site>
License: MIT
Keywords: agents,ai,autonomous,commerce,kernell,llm,m2m,orchestration
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Requires-Dist: cryptography<44,>=42.0
Requires-Dist: fastapi>=0.100.0
Requires-Dist: httpx<1,>=0.27
Requires-Dist: prometheus-client<1,>=0.20
Requires-Dist: psutil<7,>=5.9
Requires-Dist: pydantic<3,>=2.7
Requires-Dist: redis<6,>=5.0
Requires-Dist: structlog<26,>=24.0
Requires-Dist: tenacity<10,>=8.2
Requires-Dist: uvicorn>=0.25.0
Provides-Extra: all
Requires-Dist: anthropic>=0.25; extra == 'all'
Requires-Dist: cryptography>=41.0.0; extra == 'all'
Requires-Dist: docker>=7.0; extra == 'all'
Requires-Dist: fastapi>=0.100.0; extra == 'all'
Requires-Dist: openai>=1.0; extra == 'all'
Requires-Dist: redis>=5.0; extra == 'all'
Requires-Dist: uvicorn>=0.25.0; extra == 'all'
Provides-Extra: cluster
Requires-Dist: httpx>=0.25.0; extra == 'cluster'
Requires-Dist: redis>=5.0; extra == 'cluster'
Provides-Extra: gui
Requires-Dist: cryptography>=41.0.0; extra == 'gui'
Requires-Dist: fastapi>=0.100.0; extra == 'gui'
Requires-Dist: uvicorn>=0.25.0; extra == 'gui'
Provides-Extra: llm
Requires-Dist: anthropic>=0.25; extra == 'llm'
Requires-Dist: openai>=1.0; extra == 'llm'
Provides-Extra: memory
Requires-Dist: redis>=5.0; extra == 'memory'
Provides-Extra: sandbox
Requires-Dist: docker>=7.0; extra == 'sandbox'
Provides-Extra: test
Requires-Dist: coverage>=7.4.0; extra == 'test'
Requires-Dist: fakeredis[lua]>=2.20.0; extra == 'test'
Requires-Dist: freezegun>=1.4.0; extra == 'test'
Requires-Dist: httpx>=0.27.0; extra == 'test'
Requires-Dist: hypothesis>=6.0.0; extra == 'test'
Requires-Dist: prometheus-client>=0.20.0; extra == 'test'
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'test'
Requires-Dist: pytest-cov>=4.1.0; extra == 'test'
Requires-Dist: pytest-mock>=3.12.0; extra == 'test'
Requires-Dist: pytest>=8.0.0; extra == 'test'
Requires-Dist: responses>=0.25.0; extra == 'test'
Description-Content-Type: text/markdown

<div align="center">
  <h1>🧠 Kernell OS</h1>
  <h3>The First Installable Agentic Environment with Built-in Economy</h3>
</div>

---

## ⚡ What You Install

```bash
pip install kernell-os-sdk
kernell init --full
kernell dashboard
```

👉 You don’t install a library.
👉 You install a **complete agentic environment**.

---

# 🖥️ The Dashboard is the OS

Kernell OS is not CLI-first. It is **dashboard-first**.

### 👉 This is where everything happens:
* You run tasks
* You monitor execution
* You build agents (DevLayer)
* You interact with the system
* You access the marketplace
* You manage your AI economy

> **The dashboard is the human interface to your agentic system.**

---

## 🧩 DevLayer — Build Inside the System

Inside the dashboard, you get:
* agent builder
* workflow editor
* execution inspector
* policy tuning
* dataset tools

👉 No external tooling required.

---

## 🧠 The Core: Task Classification Engine

Everything in Kernell depends on one thing:
👉 **Understanding the task correctly**

### 🔹 PolicyLite (Local)
* small fine-tuned model
* runs locally
* ultra fast
* near-zero cost

### 🔹 Classifier-Pro (Remote)
* advanced model hosted by Kernell
* used only when needed
* higher accuracy

### ⚙️ How it works

```text
Task → PolicyLite
        ↓
   confident → execute locally
   uncertain → escalate to Classifier-Pro
```

👉 You only pay when escalation happens.

---

## 💰 Kernell Pay (Economic Layer)

Kernell includes a native economic system.

### 💠 KERN Token
Used for:
* premium routing decisions
* classifier-pro queries
* marketplace interactions
* agent execution payments

### 🎁 Airdrops
On install, users receive:
* free credits (KERN)
* enough to explore the system
* test routing, marketplace, and agents

---

## 🌐 Marketplace (Autonomous Economy)

Agents can:
* execute tasks
* offer services
* interact with other agents
* generate value

### Examples:
* summarization agents
* research agents
* automation workflows
* data labeling agents

### 💸 Payments
* automatic
* verifiable
* tied to execution results

---

## 🔐 KAP Protocol (Security Layer)

Kernell runs on a native protocol:

### Guarantees:
* secure execution boundaries
* verifiable task outcomes
* structured telemetry
* audit-ready interactions

👉 This is what enables trust in the marketplace.

---

## ⚙️ Execution Engine

Kernell automatically:
* decomposes tasks
* selects models
* applies fallback
* optimizes cost
* aggregates results

---

## 📊 Telemetry & Learning

Every action generates:
* routing decisions
* cost
* latency
* success/failure
* policy signals

Used for:
* debugging
* dataset generation
* policy improvement

---

## 🔁 Self-Improving System

```text
Execution → Telemetry → Dataset → Training → Better Routing
```

---

## ⚡ What Makes Kernell Different

### 1. It’s Not a Tool — It’s an Environment
Everything lives inside the system.

### 2. It Has a Native Economy
Most AI tools:
❌ no pricing intelligence
❌ no value exchange

Kernell:
✅ built-in payments
✅ task-based economy

### 3. It Optimizes Automatically
You don’t choose models. Kernell does.

### 4. It Learns From Real Usage
No static configs. Only evolving intelligence.

### 5. It Has a Human Interface
Dashboard ≠ monitoring
👉 Dashboard = control layer

---

## 🚀 Differentiating Features

* agentic environment (not SDK)
* DevLayer (built-in development)
* PolicyLite + Classifier-Pro system
* Kernell Pay (native economy)
* marketplace for autonomous agents
* KAP protocol (secure execution)

---

## 💥 Real Value

Kernell typically achieves:
* 💰 50–98% cost reduction
* ⚡ lower latency
* 📊 stable quality

---

## ⚡ Final Truth

Kernell is not a wrapper. It is not a library. It is not a tool.

It is:
> **An operating environment for intelligent systems — with its own economy.**
