[update-readmes] Mode: rewrite — migrating to template structure...

lkf

This project provides a Linux Kernel Framework (LKF) that is both distribution-agnostic and architecture-agnostic. It enables developers and system integrators to build, compile, customize, and redistribute Linux kernels. It is designed for users who need a flexible and modular approach to kernel development, including tasks like ricing, patching, and creating custom kernel distributions.

Architecture

The Linux Kernel Framework (LKF) consists of modular components designed to support kernel development, customization, and redistribution. The framework is implemented primarily in shell scripts and includes optional C-based tools. Key components include:

• Core: Contains essential scripts and modules for kernel operations.
• Config: Stores configuration files for kernel builds.
• Profiles: Provides predefined kernel profiles for customization.
• Patches: Includes patch files for kernel modifications.
• Examples: Offers example configurations and workflows.
• Tools: Hosts optional utilities like kdress and unzboot for additional functionality.
• Nix: Contains Nix environment files for reproducible builds.

The Makefile defines targets for installation, uninstallation, testing, and building optional tools. The lkf.sh script serves as the main entry point, with a wrapper script installed to simplify execution. The directory structure is as follows:

.
├── .devcontainer
├── .editorconfig
├── .github
├── .gitignore
├── .gitlab-ci.yml
├── CHANGELOG.md
├── CONTRIBUTING.md
├── LICENSE
├── Makefile
├── README.md
├── SECURITY.md
├── ci
├── config
├── core
├── examples
├── lkf.sh
├── nix
├── patches
├── profiles
├── remix.toml
├── tests
└── tools

Install

git clone https://github.com/Interested-Deving-1896/lkf.git
cd lkf

Usage

Configuration

CI

The repository uses GitHub Actions for continuous integration and automation. The following workflows are defined:

1. ci.yml

   • Runs linting, builds the project, and executes tests.
   • Trigger: On pull requests and pushes to the main branch.
   • No secrets required.

2. mirror-osp-to-ooc.yaml

   • Mirrors the repository from an open-source platform to an organizational repository.
   • Trigger: Manual dispatch or scheduled runs.
   • Required secrets: OOC_REPO_TOKEN (access token for the organizational repository).

3. trigger-artifact-mirror.yml

   • Triggers artifact mirroring to external storage or repositories.
   • Trigger: Manual dispatch.
   • Required secrets: ARTIFACT_STORAGE_KEY (key for external storage access).

Mirror chain

This repo is maintained in Interested-Deving-1896/lkf and mirrored through:

Interested-Deving-1896/lkf  ──►  OpenOS-Project-OSP/lkf  ──►  OpenOS-Project-Ecosystem-OOC/lkf

Changes flow downstream automatically via the hourly mirror chain in fork-sync-all. Direct commits to OSP or OOC are detected and opened as PRs back to Interested-Deving-1896.

Contributors

• @Interested-Deving-1896: 6 commits
• @dependabot[bot]: 1 commit

Origins

Original project — no upstream fork.

Resources

No additional resource files found.

License

GPL-2.0 © 2026 Interested-Deving-1896