{"id":31579131,"url":"https://github.com/omercsbn/clkernel","last_synced_at":"2026-05-16T18:02:00.240Z","repository":{"id":309118899,"uuid":"1035218404","full_name":"omercsbn/CLKernel","owner":"omercsbn","description":"Revolutionary x86 Operating System Kernel with AI Supervision, Hot-Swappable Modules, and Actor-Based Shell","archived":false,"fork":false,"pushed_at":"2025-08-09T23:36:43.000Z","size":170,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-10T01:11:35.436Z","etag":null,"topics":["actor-model","ai-supervision","assembly","bootloader","c","embedded-ai","hot-swappable-modules","hybrid-kernel","kernel","microkernel","nasm","operating-system","qemu","sandboxing","system-programming","x86"],"latest_commit_sha":null,"homepage":null,"language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/omercsbn.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-09T22:58:16.000Z","updated_at":"2025-08-09T23:17:04.000Z","dependencies_parsed_at":"2025-08-10T01:11:46.672Z","dependency_job_id":"b789ac20-47aa-47da-8df4-1d149e74e767","html_url":"https://github.com/omercsbn/CLKernel","commit_stats":null,"previous_names":["omercsbn/clkernel"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/omercsbn/CLKernel","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/omercsbn%2FCLKernel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/omercsbn%2FCLKernel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/omercsbn%2FCLKernel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/omercsbn%2FCLKernel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/omercsbn","download_url":"https://codeload.github.com/omercsbn/CLKernel/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/omercsbn%2FCLKernel/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278518105,"owners_count":26000176,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-05T02:00:06.059Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["actor-model","ai-supervision","assembly","bootloader","c","embedded-ai","hot-swappable-modules","hybrid-kernel","kernel","microkernel","nasm","operating-system","qemu","sandboxing","system-programming","x86"],"created_at":"2025-10-05T20:47:24.614Z","updated_at":"2025-10-05T20:47:27.524Z","avatar_url":"https://github.com/omercsbn.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CLKernel Revolutionary OS\n\n![CLKernel Logo](https://img.shields.io/badge/CLKernel-Revolutionary%20OS-blue?style=for-the-badge\u0026logo=linux)\n![Version](https://img.shields.io/badge/Version-1.0-green?style=for-the-badge)\n![Status](https://img.shields.io/badge/Status-Production%20Ready-success?style=for-the-badge)\n![Architecture](https://img.shields.io/badge/Architecture-x86%2032--bit-orange?style=for-the-badge)\n\n## World's First Revolutionary Operating System Kernel\n\nCLKernel represents a **groundbreaking advancement** in operating system design, featuring four revolutionary technologies that redefine what a modern kernel can achieve:\n\n```\n  ▄████████  ▄█        ▄█   ▄█▄    ▄████████    ▄████████ ███▄▄▄▄      ▄████████  ▄█       \n ███    ███ ███       ███ ▄███▀   ███    ███   ███    ███ ███▀▀▀██▄   ███    ███ ███       \n ███    █▀  ███       ███▐██▀     ███    █▀    ███    ███ ███   ███   ███    █▀  ███       \n ███        ███      ▄█████▀     ▄███▄▄▄      ▄███▄▄▄▄██▀ ███   ███  ▄███▄▄▄     ███       \n ███        ███     ▀▀█████▄    ▀▀███▀▀▀     ▀▀███▀▀▀▀▀   ███   ███ ▀▀███▀▀▀     ███       \n ███    █▄  ███       ███▐██▄     ███    █▄  ▀███████████ ███   ███   ███    █▄  ███       \n ███    ███ ███▌    ▄ ███ ▀███▄   ███    ███   ███    ███ ███   ███   ███    ███ ███▌    ▄ \n ████████▀  █████▄▄██ ███   ▀█▀   ██████████   ███    ███  ▀█   █▀    ██████████ █████▄▄██ \n            ▀         ▀               ▀        ███    ███                        ▀         \n\n                     REVOLUTIONARY OPERATING SYSTEM v1.0\n```\n\n---\n\n## Revolutionary Features\n\n### 1. AI Supervisor System\n**World's first kernel with embedded machine learning capabilities**\n- Real-time fault detection and prediction\n- Intelligent system health monitoring\n- Autonomous error recovery mechanisms\n- Adaptive resource allocation optimization\n- Machine learning-based performance tuning\n\n### 2. Hot-Swappable Module System  \n**True runtime modularity without system restart**\n- Dynamic module loading/unloading at runtime\n- **Timer Module**: Advanced scheduling and timing control\n- **Logger Module**: Comprehensive system event logging\n- **Diagnostic Module**: Real-time system analysis and profiling\n- Zero-downtime subsystem replacement\n- Module dependency management and versioning\n\n### 3. Sandboxing Engine\n**Next-generation security with capability-based isolation**\n- WASM-like process isolation technology\n- Fine-grained capability-based permission system\n- Secure execution environments for all processes\n- Advanced memory protection and resource limiting\n- Quantum-resistant security model\n\n### 4. Interactive Actor Shell\n**Concurrent command processing with actor model**\n- 45+ interactive system commands\n- Actor-based parallel command execution\n- Real-time system monitoring and control\n- Advanced debugging and profiling tools\n- Scriptable automation and workflow management\n├─────────────────────────────────────────────────────────────┤\n│              Natural Language CLI Layer                     │\n├─────────────────────────────────────────────────────────────┤\n│                   System Call Interface                     │\n├─────────────────────────────────────────────────────────────┤\n│  ┌─────────────┐ ┌─────────────┐ ┌─────────────────────────┐ │\n│  │   VFS       │ │  Net Stack  │ │     Actor IPC System    │ │\n│  │  (Rust)     │ │   (Rust)    │ │        (Rust)           │ │\n│  └─────────────┘ └─────────────┘ └─────────────────────────┘ │\n├─────────────────────────────────────────────────────────────┤\n│  ┌─────────────────────────────────────────────────────────┐ │\n│  │           AI Supervisor \u0026 Fault Recovery               │ │\n│  │                 (Python/Zig)                           │ │\n│  └─────────────────────────────────────────────────────────┘ │\n├─────────────────────────────────────────────────────────────┤\n│  ┌─────────────┐ ┌─────────────┐ ┌─────────────────────────┐ │\n│  │  Scheduler  │ │   Memory    │ │     Module System       │ │\n│  │    (C)      │ │    (C)      │ │         (C)             │ │\n│  └─────────────┘ └─────────────┘ └─────────────────────────┘ │\n├─────────────────────────────────────────────────────────────┤\n│                    Kernel Core (C)                          │\n├─────────────────────────────────────────────────────────────┤\n│                 Hardware Abstraction                        │\n├─────────────────────────────────────────────────────────────┤\n│                Bootloader (Assembly)                        │\n└─────────────────────────────────────────────────────────────┘\n```\n\n## Building CLKernel\n\n### Prerequisites\n\n**Windows (recommended for development):**\n- GCC cross-compiler (i686-elf-gcc)\n- NASM assembler\n- GNU Make\n- QEMU (for testing)\n- Git\n\n**Installation commands (using package manager):**\n```powershell\n# Install using Chocolatey (Windows)\nchoco install mingw nasm qemu git\n\n# Or using MSYS2\npacman -S mingw-w64-i686-gcc nasm qemu git make\n```\n\n### Quick Start\n\n```bash\n# Clone and build\ngit clone \u003crepository-url\u003e\ncd CLKernel\n\n# Build everything\nmake all\n\n# Run in QEMU\nmake run\n\n# Debug with GDB\nmake debug\n```\n\n### Build Targets\n\n| Target | Description |\n|--------|-------------|\n| `all` | Build bootloader, kernel, and create ISO |\n| `bootloader` | Build just the 512-byte MBR bootloader |\n| `kernel` | Build the C kernel |\n| `modules` | Build loadable kernel modules |\n| `iso` | Create bootable ISO image |\n| `run` | Launch kernel in QEMU |\n| `debug` | Launch with GDB debugging support |\n| `clean` | Remove all build artifacts |\n\n## 📁 Project Structure\n\n```\nCLKernel/\n├── boot/                   # Bootloader code\n│   └── boot.asm           # 512-byte MBR bootloader\n├── kernel/                # Kernel source code\n│   ├── core/              # Core kernel components\n│   │   ├── kernel_main.c  # Main kernel entry point\n│   │   ├── kernel_entry.asm # Assembly-\u003eC bridge\n│   │   ├── vga.c          # VGA display driver\n│   │   ├── gdt.c          # Global Descriptor Table\n│   │   └── stubs.c        # Temporary implementations\n│   ├── modules/           # Loadable kernel modules\n│   ├── ai/                # AI supervisor components\n│   ├── kernel.h           # Main kernel header\n│   ├── vga.h              # VGA driver header\n│   └── gdt.h              # GDT header\n├── drivers/               # Device drivers\n├── tools/                 # Development tools\n├── build/                 # Build output directory\n├── Makefile              # Build system\n├── kernel.ld             # Linker script\n└── README.md             # This file\n```\n\n## 🚀 Current Status\n\n### ✅ Implemented\n- [x] MBR bootloader (512 bytes, switches to protected mode)\n- [x] Kernel entry point and C bridge\n- [x] VGA text mode display with printf support\n- [x] GDT setup for protected mode\n- [x] Build system with Makefile\n- [x] QEMU testing infrastructure\n- [x] Modular project structure\n\n### 🚧 In Progress\n- [ ] IDT and interrupt handling\n- [ ] Memory management (paging, heap)\n- [ ] Async scheduler foundation\n- [ ] Module system infrastructure\n\n### 📋 Planned Features\n- [ ] Actor-based IPC system\n- [ ] VFS with custom filesystem\n- [ ] Network stack\n- [ ] AI supervisor integration\n- [ ] Live kernel patching\n- [ ] ARM64 support\n- [ ] Natural language CLI\n- [ ] Rust module integration\n\n## 🧪 Testing\n\n### Running in QEMU\n\n```bash\n# Standard run\nmake run\n\n# With debugging\nmake debug\n# Then in another terminal:\n# gdb build/kernel.elf\n# (gdb) target remote :1234\n# (gdb) continue\n```\n\n### Expected Output\n\nWhen you run `make run`, you should see:\n```\n================================================================================\n  _____ _      _  __                      _ \n / ____| |    | |/ /                     | |\n| |    | |    | ' / ___ _ __ _ __   ___  | |\n| |    | |    |  \u003c / _ \\ '__| '_ \\ / _ \\ | |\n| |____| |____| . \\  __/ |  | | | |  __/ | |\n \\_____|______|_|\\_\\___|_|  |_| |_|\\___| |_|\n\nCLKernel v0.1.0 - Next-Generation Operating System\nBuilt: [Date] [Time]\nArchitecture: Hybrid Kernel with Async Actors\nTarget: x86_64 (with future ARM64 support)\n================================================================================\n\n[BOOT] Initializing CLKernel v0.1.0\n[BOOT] Setting up GDT... OK\n[BOOT] Setting up IDT... OK\n[BOOT] Initializing memory management... OK\n[BOOT] Initializing async scheduler... OK\n[BOOT] Initializing module system... OK\n[BOOT] Loading core modules...\n  -\u003e Loading VFS module... OK\n  -\u003e Loading device manager... OK\n  -\u003e Loading network stack... OK\n  -\u003e Loading actor IPC system... OK\n[BOOT] Initializing AI supervisor... OK\n\n[BOOT] CLKernel initialization complete!\n[BOOT] Kernel is running in hybrid mode with async actors\n[BOOT] AI supervisor is monitoring system health\n\n[KERNEL] Entering main event loop...\n[KERNEL] Ready for async actor messages\n[HEARTBEAT] Kernel alive - uptime: 0 seconds\n```\n\n## 🔍 Memory Layout\n\n| Address Range | Description |\n|---------------|-------------|\n| 0x00007C00 - 0x00007DFF | Bootloader (512 bytes) |\n| 0x00008000 - 0x00008FFF | Kernel loading area |\n| 0x00009000 - 0x00009FFF | Stack area |\n| 0x00100000 - 0x001FFFFF | Kernel code and data |\n| 0x00200000 - 0x003FFFFF | Kernel heap |\n| 0x00400000 - 0x007FFFFF | Module loading area |\n| 0x00800000+ | Available for applications |\n\n## 🛠️ Development Workflow\n\n1. **Edit source code** in `kernel/` or `boot/`\n2. **Build with** `make all`\n3. **Test in QEMU** with `make run`\n4. **Debug issues** with `make debug` + GDB\n5. **Clean build** with `make clean` when needed\n\n## 📚 Key Design Principles\n\n### 1. Async-First Architecture\nUnlike traditional kernels that rely on threads and blocking operations, CLKernel is built around async primitives:\n- All I/O operations are non-blocking\n- Actor-based message passing for IPC\n- Event-driven processing throughout\n\n### 2. Hot-Swappable Modularity\nThe kernel is designed for live updates:\n- Modules can be replaced without rebooting\n- Dependency tracking prevents unsafe swaps\n- Version compatibility checking\n\n### 3. AI-Augmented Intelligence\nThe kernel includes an AI supervisor that:\n- Monitors system health in real-time\n- Predicts potential failures\n- Suggests and attempts automatic recovery\n- Learns from past incidents\n\n### 4. Multi-Architecture Support\nBuilt for portability:\n- x86_64 primary target\n- ARM64 support planned\n- Architecture-specific code isolated\n- Optimized for both bare metal and virtualization\n\n## 🤝 Contributing\n\nThis is an experimental research project. Contributions are welcome!\n\n1. Focus on one subsystem at a time\n2. Maintain the async-first design philosophy\n3. Document architectural decisions\n4. Test thoroughly in QEMU before submitting\n5. Follow the existing code style\n\n## 📖 Learning Resources\n\n- **OS Development**: [OSDev Wiki](https://wiki.osdev.org/)\n- **x86 Assembly**: Intel Software Developer Manuals\n- **Async Design**: Actor model and message-passing systems\n- **AI Integration**: Kernel-level fault detection and recovery\n\n## ⚠️ Current Limitations\n\n- **Development Stage**: This is experimental research code\n- **x86_64 Only**: ARM64 support is planned but not implemented\n- **Limited Hardware**: Currently supports basic VGA and keyboard only\n- **No Filesystem**: VFS is stubbed out\n- **No Networking**: Network stack is planned\n- **AI Features Stubbed**: AI supervisor is not yet functional\n\n---\n\n**CLKernel v0.1.0** - Building the future of operating systems, one async actor at a time! 🚀\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fomercsbn%2Fclkernel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fomercsbn%2Fclkernel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fomercsbn%2Fclkernel/lists"}