Skip to content

Repository files navigation

Kurrent

Cloud Native Stars Release License Docs

中文版 | English

Make bare metal flow.

周流六虚,上下无常。 — from the I Ching: currents flow through the six voids, above and below, without constancy.

K8s spent a decade making applications cloud-native. Kurrent makes compute cloud-native.

K8s orchestrates the containers. Kurrent orchestrates the compute.

Kurrent is a cloud-native stateless bare-metal delivery paradigm. It pushes statelessness down to the physical compute layer itself: compute nodes (Devices) hold no persistent state — identity (Worker), OS, and data are granted externally by the network and the control plane. Plug in a cable and a node comes alive; compute is unshackled from hardware and flows freely across bare-metal nodes, like current itself.

Read our manifesto: about/en/Manifesto.mdOur Definition of Cloud Native (Chinese original: about/zh/Manifesto.md).

Architecture

The control plane / data plane separation and the three roles — Controller, Storager, Devices — are detailed in about/en/ARCHITECTURE.md (中文: about/zh/ARCHITECTURE.md).

Quick Start

git clone https://github.com/dutyc/kurrent
cd kurrent

cp control_plane/control_plane.env.example control_plane/control_plane.env
cp dnsmasq/dnsmasq.conf.example dnsmasq/dnsmasq.conf
cp dnsmasq/dhcp-hosts.conf.example dnsmasq/dhcp-hosts.conf
# Adapt dnsmasq.conf: NIC name, subnet, gateway
docker compose up -d
  • Web UI: http://<controller-ip>:4838
  • Control Plane API: http://<controller-ip>:4839

Key Features: Compute That Flows, Plug-and-Play

A stateless bare-metal delivery flow: machines join the device pool on first boot, then a few clicks in the Web UI bind them to a Worker with a system disk and a default OS. One Worker can carry multiple system disks — Windows, Ubuntu, Debian, CentOS, ESXi — and switch between them online.

Documentation

Under construction...

Firmware Repo

The firmware engine for Kurrent. Make bare metal flow at the boot layer.

The firmware at the bottom of the boot chain is built by our companion repo Kurrent Firmware — two sides of the same philosophy: this repo makes compute stateless, the firmware repo makes boot firmware stateless.

Roadmap

A cross-platform, cross-architecture cloud-native meta-protocol: one stateless semantics, self-similarly nested across bare metal and hypervisors. See about/en/ROADMAP.md (中文: about/zh/ROADMAP.md).

Community & Contributing

Star / Watch / Discussions / PRs are all welcome. This project embraces AI-assisted development, with one hard requirement: the AI can write the syntax, but architecture understanding must come from a human brain. Please read AI_POLICY.md before submitting a PR.

License

Apache License 2.0

Star History

Star History Chart

About

Stateless bare-metal compute paradigm. K8s orchestrates containers; Kurrent orchestrates compute. Firmware-level network boot + NVMe-oF block storage, orchestrated by a decoupled Control Plane / Agent architecture. Multi-OS verified end-to-end.

Topics

Resources

Stars

22 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages