cell0-os 1.0.0

package/LICENSE

@@ -0,0 +1,31 @@
+                    GNU GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2026 Cell 0 Collective
+
+ This program is free software: you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation, either version 3 of the License, or
+ (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+Also add information on how to contact you by electronic and paper mail.
+
+  You should also get your employer (if you work as a programmer) or school,
+if any, to sign a "copyright disclaimer" for the program, if necessary.
+For more information on this, and how to apply and follow the GNU GPL, see
+<https://www.gnu.org/licenses/>.
+
+  The GNU General Public License does not permit incorporating your program
+into proprietary programs.  If your program is a subroutine library, you
+may consider it more useful to permit linking proprietary applications with
+the library.  If this is what you want to do, use the GNU Lesser General
+Public License instead of this License.  But first, please read
+<https://www.gnu.org/licenses/why-not-lgpl.html>.

package/README.md

@@ -0,0 +1,343 @@
+# 🧬 cell0-os
+
+<p align="center">
+  <strong>The Sovereign Edge Operating System</strong>
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/badge/version-0.1.0-blue.svg" alt="Version">
+  <img src="https://img.shields.io/badge/license-GPL%20v3.0-green.svg" alt="License">
+  <img src="https://img.shields.io/badge/tests-passing-brightgreen.svg" alt="Tests">
+  <img src="https://img.shields.io/badge/docker-ready-2496ed.svg?logo=docker" alt="Docker">
+</p>
+
+<p align="center">
+  <a href="#installation">Install</a> •
+  <a href="#features">Features</a> •
+  <a href="#architecture">Architecture</a> •
+  <a href="#security">Security</a> •
+  <a href="#contributing">Contribut</a>
+</p>
+
+---
+
+## Installation
+
+### npm (Recommended)
+
+```bash
+npm install -g cell0-os
+cell0 onboard --install-daemon
+```
+
+### Docker
+
+```bash
+docker run -d \
+  --name cell0 \
+  -p 18800:18800 \
+  -v ~/.cell0:/data \
+  yigremtamiru/cell0-os:latest
+```
+
+### Quick Start
+
+```bash
+# Clone and setup
+git clone https://github.com/YigremTamiru/cell0-os.git ~/cell0
+cd ~/cell0 && ./install.sh
+
+# Start the gateway
+cell0 gateway --port 18800
+```
+
+---
+
+## Features
+
+### 🔐 Post-Quantum Cryptography (12 Layers)
+
+Defense-in-depth with 12 parallel cryptographic systems spanning classical, modern, post-quantum, and quantum domains:
+
+| Layer | Systems | Status |
+|-------|---------|--------|
+| **Classical** | AES-256-GCM, ChaCha20-Poly1305, SHA3-256/512 | ✅ |
+| **Modern** | Ed25519, X25519, BLS12-381 | ✅ |
+| **Post-Quantum** | CRYSTALS-Kyber, CRYSTALS-Dilithium | ✅ |
+| **Quantum** | BB84 QKD, Quantum Signatures | ✅ |
+| **ZKP** | zk-STARK (transparent, post-quantum) | ✅ |
+
+### 🛡️ Sovereign Security Model
+
+Your data, your rules — entirely local-first:
+
+- **Default-deny architecture** — Nothing runs without explicit authorization
+- **Allowlist-only access** — No implicit permissions, ever
+- **Capability-based security** — Fine-grained token-based access control
+- **NFEK biometric authentication** — ECG/PPG-based identity verification
+- **Append-only hash-ledgers** — Tamper-evident audit trails
+
+### 💬 WhatsApp Web QR Mode
+
+Connect WhatsApp instantly without phone pairing hassles:
+
+```bash
+cell0 channel add whatsapp --mode qr
+# Scan QR code with your phone — done in 5 seconds
+```
+
+- No SMS verification required
+- No phone number exchange
+- Direct Web QR pairing
+
+### 🖥️ Arrow-Key TUI Onboarding
+
+OpenClaw-style interactive setup:
+
+```bash
+$ cell0 onboard
+
+? Select deployment mode: (Use arrow keys)
+❯ Local-only  
+  Cloud tunnel  
+
+? Choose LLM provider: (Use arrow keys)
+❯ Moonshot (Kimi)  
+  OpenAI (GPT-4)  
+  Anthropic (Claude)  
+  Ollama (Local)  
+
+? Configure channels: (Press <space> to select)
+☑ Web UI
+☐ Telegram
+☑ WhatsApp
+☐ Discord
+```
+
+### 🤖 Multi-Provider AI
+
+Intelligent provider selection with automatic failover across 30+ models:
+
+| Provider | Models | Best For |
+|----------|--------|----------|
+| **Moonshot** | Kimi K2.5, v1 series | Long context, reasoning |
+| **OpenAI** | GPT-4o, o1, o3 | General purpose |
+| **Anthropic** | Claude 3.5 Sonnet, Opus | Safety, analysis |
+| **Google** | Gemini 2.0 Flash, 1.5 Pro | Multimodal |
+| **Ollama** | Llama, Mistral, CodeLlama | Local inference (FREE) |
+| **MLX** | Quantized models | Apple Silicon (FREE) |
+
+```bash
+# Use any provider
+cell0 config set provider moonshot/kimi-k2.5
+cell0 config set provider openai/gpt-4o
+cell0 config set provider ollama/llama3.2
+```
+
+### 📡 Multi-Channel Support
+
+Unified interface across all messaging platforms:
+
+| Channel | Status | Features |
+|---------|--------|----------|
+| **Telegram** | ✅ Ready | Bot API, groups, reactions |
+| **Discord** | ✅ Ready | Slash commands, embeds, DMs |
+| **WhatsApp** | ✅ Ready | QR mode, groups, voice notes |
+| **Web UI** | ✅ Ready | Terminal aesthetic, markdown |
+| **Slack** | 🚧 Soon | Workspace apps |
+
+```bash
+# Add channels interactively
+cell0 channel add telegram --bot-token <token>
+cell0 channel add discord --bot-token <token>
+cell0 channel add whatsapp --mode qr
+```
+
+---
+
+## Architecture
+
+### MCIC Kernel
+
+The **Mandatory Civilization Interface Core** is the foundation of cell0-os:
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  LAYER 6: INTERFACE FIELD (User Space)                      │
+│  • TUI/Web UI • Skills • Tools                              │
+├─────────────────────────────────────────────────────────────┤
+│  LAYER 5: PERSONA RUNTIME (Ring 3)                          │
+│  • TPV-resonant AI • Provider routing • Agent dispatch      │
+├─────────────────────────────────────────────────────────────┤
+│  LAYER 4: CIVILIZATION RUNTIME (Ring 1)                     │
+│  • HGW workspace • Coalition formation • Consensus          │
+├─────────────────────────────────────────────────────────────┤
+│  LAYER 3: CELL 0 KERNEL — MCIC (Ring 0) ⭐                  │
+│  • OC enforcement • SYPAS bus • Capability security         │
+│  • Agent scheduler • Memory management                      │
+├─────────────────────────────────────────────────────────────┤
+│  LAYER 2: NFEK — NEURO-FUZZY EXISTENCE KEY                  │
+│  • Biometric authentication • Live reconstruction           │
+├─────────────────────────────────────────────────────────────┤
+│  LAYER 1: CRYPTOGRAPHIC PLENUM (12 Systems)                 │
+│  • Classical/Modern/PQ/Quantum/ZKP • Root of Trust          │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### 12 Security Layers
+
+Defense-in-depth architecture where breaking security requires compromising **all 12 layers simultaneously**:
+
+1. **Quantum Void** — Hardware entropy source
+2. **Cryptographic Plenum** — 12 parallel crypto systems
+3. **NFEK Biometrics** — ECG/PPG identity verification
+4. **UEFI Anchor** — TPM 2.0 measured boot
+5. **MCIC Hypervisor** — VMX root mode isolation
+6. **Cell 0 Kernel** — Bare-metal Rust, capability-based
+7. **Civilization Runtime** — HGW consciousness architecture
+8. **Body Interface** — VirtIO drivers, sandboxed I/O
+9. **Persona Runtime** — TPV-resonant AI layer
+10. **Interface Field** — User-facing TUI/Web
+11. **SYFPASS Mesh** — Quantum-resistant networking
+12. **Planetary Consciousness** — Swarm consensus
+
+### Channel Drivers
+
+Pluggable channel architecture for unified messaging:
+
+```
+┌─────────────────────────────────────────┐
+│         Channel Manager                 │
+├─────────┬─────────┬─────────┬───────────┤
+│Telegram │Discord  │WhatsApp │  Web UI   │
+│ Driver  │ Driver  │ Driver  │  Driver   │
+├─────────┴─────────┴─────────┴───────────┤
+│         Unified Message Bus             │
+├─────────────────────────────────────────┤
+│         Agent Dispatch Layer            │
+└─────────────────────────────────────────┘
+```
+
+---
+
+## Security
+
+### Default-Deny Architecture
+
+```rust
+// Nothing is allowed by default
+deny all;
+
+// Explicit allowlist only
+allow provider::moonshot::kimi-k2.5;
+allow channel::telegram::bot_commands;
+allow tool::filesystem::read_only;
+```
+
+### Allowlist-Only Access
+
+- No implicit permissions
+- Every capability requires explicit token grant
+- Tokens are cryptographically bound to identity
+- Automatic expiration and rotation
+
+### Quantum-Resistant
+
+Future-proof against quantum attacks:
+
+- **CRYSTALS-Kyber** — NIST-approved post-quantum KEM
+- **CRYSTALS-Dilithium** — NIST-approved post-quantum signatures
+- **zk-STARK** — Transparent ZK proofs (post-quantum secure)
+- **Hybrid encryption** — Classical + PQ combined
+- **Crypto agility** — Rapid algorithm migration
+
+```bash
+# Verify quantum-resistant status
+cell0 security audit --report
+
+# Rotate to latest algorithms
+cell0 crypto rotate --quantum-safe
+```
+
+---
+
+## CLI Reference
+
+```bash
+# Core commands
+cell0 onboard              # Interactive setup wizard
+cell0 gateway              # Run gateway in foreground
+cell0 daemon install       # Install background daemon
+cell0 daemon start|stop    # Control daemon
+cell0 status               # System status
+cell0 doctor               # Diagnostic check
+
+# Configuration
+cell0 config set <key> <value>
+cell0 config get <key>
+cell0 config list
+
+# Channel management
+cell0 channel add <type> [options]
+cell0 channel remove <id>
+cell0 channel list
+
+# AI providers
+cell0 provider list
+cell0 provider set <provider/model>
+cell0 provider test
+
+# Security
+cell0 security audit
+cell0 crypto status
+cell0 crypto rotate
+```
+
+---
+
+## Contributing
+
+We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+### Quick Start
+
+```bash
+# Fork and clone
+git clone https://github.com/YOUR_USERNAME/cell0-os.git
+cd cell0-os
+
+# Install dependencies
+pip install -r requirements-dev.txt
+
+# Run tests
+make test
+
+# Start developing
+```
+
+### Development Guidelines
+
+- **Security First** — All changes undergo security review
+- **Test Coverage** — Maintain >80% coverage
+- **Documentation** — Update docs with code changes
+- **Commit Messages** — Follow conventional commits
+
+---
+
+## License
+
+Cell 0 OS is released under the **GNU General Public License v3.0**
+
+See [LICENSE](LICENSE) for full text.
+
+---
+
+<p align="center">
+  <sub>Built with 💜 by the Cell 0 Collective</sub>
+</p>
+
+<p align="center">
+  <a href="https://kulluai.com">Website</a> •
+  <a href="https://github.com/YigremTamiru/cell0-os">GitHub</a> •
+  <a href="https://discord.gg/cell0">Discord</a>
+</p>