{"id":29767915,"url":"https://github.com/codeyousef/horizonos","last_synced_at":"2025-07-27T02:40:07.365Z","repository":{"id":303393928,"uuid":"1015320764","full_name":"codeyousef/HorizonOS","owner":"codeyousef","description":null,"archived":false,"fork":false,"pushed_at":"2025-07-21T16:49:46.000Z","size":4160,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-21T17:45:20.266Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/codeyousef.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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-07-07T10:25:09.000Z","updated_at":"2025-07-21T16:48:55.000Z","dependencies_parsed_at":"2025-07-07T11:43:30.254Z","dependency_job_id":"520a64de-e00d-4c0c-8709-ab157db160f3","html_url":"https://github.com/codeyousef/HorizonOS","commit_stats":null,"previous_names":["codeyousef/horizonos"],"tags_count":39,"template":false,"template_full_name":null,"purl":"pkg:github/codeyousef/HorizonOS","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeyousef%2FHorizonOS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeyousef%2FHorizonOS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeyousef%2FHorizonOS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeyousef%2FHorizonOS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codeyousef","download_url":"https://codeload.github.com/codeyousef/HorizonOS/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeyousef%2FHorizonOS/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267289697,"owners_count":24064733,"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-07-27T02:00:11.917Z","response_time":82,"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":[],"created_at":"2025-07-27T02:40:05.847Z","updated_at":"2025-07-27T02:40:07.352Z","avatar_url":"https://github.com/codeyousef.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# HorizonOS\n\nAn immutable Linux distribution built on Arch Linux with OSTree for atomic updates, featuring a revolutionary Kotlin DSL for type-safe system configuration and the world's first graph-native desktop environment.\n\n## 🌟 What Makes HorizonOS Special\n\n- **Type-Safe Configuration**: Kotlin DSL replaces traditional YAML/TOML with compile-time validation\n- **Immutable Infrastructure**: OSTree provides atomic updates and rollbacks\n- **Graph Desktop**: Revolutionary UI paradigm where everything is a node with semantic relationships\n- **Local-First Privacy**: Built-in LLM integration runs entirely locally with hardware optimization\n- **Enterprise Ready**: Comprehensive networking, security, and automation capabilities\n\n## 🚀 Quick Start\n\n### Building HorizonOS\n\n```bash\n# Build OSTree commit\nsudo ./scripts/scripts/build-test.sh\n\n# Build bootable ISO\nsudo ./scripts/scripts/build-iso.sh\n\n# Test in QEMU\nqemu-system-x86_64 -m 4G -enable-kvm -cdrom build/out/horizonos-*.iso\n```\n\n### Kotlin DSL Configuration\n\n```bash\n# Setup Kotlin DSL environment\n./scripts/setup-kotlin-dsl.sh\n\n# Navigate to DSL directory\ncd src/kotlin-config\n\n# Run tests\n./gradlew test\n\n# Compile a configuration\n./gradlew compileConfig -PconfigFile=examples/desktop.horizonos.kts\n```\n\n## 📋 Roadmap \u0026 Implementation Status\n\n### ✅ **Phase 1: Core Infrastructure (COMPLETED)**\n\n#### Immutable System Foundation\n- [x] **OSTree Integration** - Atomic updates and rollbacks\n- [x] **Btrfs Layout** - Structured subvolumes (@, @home, @var, @snapshots)\n- [x] **Build System** - Arch-based with custom ISO generation\n- [x] **Installation System** - Custom installer with OSTree deployment\n\n#### Kotlin DSL Core (100% Complete)\n- [x] **Core Configuration DSL** - Packages, services, users, repositories\n- [x] **AI/LLM Integration** - Local execution with Ollama, hardware optimization\n- [x] **Automation Framework** - RPA workflows, teaching modes, browser automation\n- [x] **Network Configuration** - Interfaces, WiFi, VPN, firewall, DNS, bridges, VLANs\n- [x] **Compiler Pipeline** - Parser, validator, multi-format generator\n- [x] **Runtime Components** - Live updates, change detection, state management\n- [x] **Comprehensive Testing** - 86+ tests with 100% pass rate\n- [x] **Documentation** - API docs, guides, examples\n\n### 🔄 **Phase 2: System Configuration Modules (IN PROGRESS)**\n\n#### Core System Modules (25% Complete)\n- [x] **Network Module** - Complete networking configuration with enterprise features\n- [ ] **Boot \u0026 Kernel Module** - Bootloader, kernel parameters, modules *(Next)*\n- [ ] **Hardware Module** - GPU drivers, display, power management\n- [ ] **Storage Module** - Filesystems, RAID, encryption, snapshots\n- [ ] **Security Module** - PAM, sudo, SSH, SELinux/AppArmor, certificates\n\n#### Service \u0026 Environment Modules (0% Complete)\n- [ ] **Enhanced Services** - Databases, web servers, containers, monitoring\n- [ ] **Development Environment** - Language toolchains, IDEs, virtual environments\n- [ ] **Shell \u0026 Environment** - Shell configuration, dotfiles, environment variables\n\n### 🎯 **Phase 3: Desktop Revolution (IN PROGRESS - 55% Complete)**\n\n#### Graph Desktop Implementation (55% Complete)\n- [x] **Rendering Engine** - WebGPU/wgpu-rs based graph visualization with WGSL shaders\n- [x] **Node System** - Complete node architecture with 8 node types (Application, File, Person, Task, Device, AIAgent, Concept, System)\n- [x] **Semantic Relationships** - Smart edge types with automated relationship discovery and strength analysis\n- [x] **Layout Algorithms** - 6 complete algorithms: force-directed, hierarchical, circular, grid, cluster, temporal\n- [ ] **Multi-touch Support** - Gestures, pinch-zoom, rotation *(Next)*\n- [ ] **AI Integration** - Node suggestions, auto-organization, semantic search\n- [ ] **Real-time Collaboration** - Multi-user graph editing and synchronization\n\n#### Enhanced Desktop Experience (0% Complete)\n- [ ] **Wayland Compositor** - Custom compositor optimized for graph interactions\n- [ ] **Traditional Mode** - Fallback to conventional desktop paradigms\n- [ ] **Theme System** - Deep customization of visual appearance\n- [ ] **Accessibility** - Full a11y support for graph navigation\n\n### 🏢 **Phase 4: Enterprise Features (PLANNED)**\n\n#### Advanced Configuration (0% Complete)\n- [ ] **Configuration Templates** - Reusable patterns and inheritance\n- [ ] **Multi-Environment Support** - Dev/staging/production configurations\n- [ ] **Migration Tools** - Import from NixOS, Ansible, Docker Compose\n- [ ] **Visual Configuration** - GUI builder for complex configurations\n\n#### Enterprise Integration (0% Complete)\n- [ ] **Directory Services** - LDAP, Active Directory integration\n- [ ] **Certificate Management** - Automated cert provisioning and rotation\n- [ ] **Compliance** - SOC2, HIPAA, GDPR configuration templates\n- [ ] **Monitoring** - Built-in observability and alerting\n\n## 🛠 Technical Architecture\n\n### Core Technologies\n- **Base OS**: Arch Linux (rolling release)\n- **Update System**: OSTree (atomic updates)\n- **Filesystem**: Btrfs (snapshots, subvolumes)\n- **Configuration**: Kotlin DSL (type-safe, compile-time validated)\n- **Build System**: Gradle + Custom scripts\n- **Package Management**: Pacman (with OSTree overlay)\n\n### Key Advantages Over NixOS\n1. **Better Ergonomics**: Intuitive Kotlin syntax vs functional Nix language\n2. **IDE Integration**: Full IntelliJ/VSCode support with auto-completion\n3. **Type Safety**: Compile-time validation prevents configuration errors\n4. **Semantic Types**: `firewall.allow.ssh` vs `networking.firewall.allowedTCPPorts = [22]`\n5. **Live Updates**: Partial configuration application without rebuilds\n6. **Visual Diff**: See exactly what changes before applying\n7. **Graph-Native**: First-class support for graph-based computing\n\n### Directory Structure\n```\nhorizonos/\n├── src/\n│   ├── kotlin-config/          # Kotlin DSL implementation\n│   │   ├── src/main/kotlin/    # Core DSL code\n│   │   ├── src/test/kotlin/    # Comprehensive test suite\n│   │   └── examples/           # Configuration examples\n│   └── desktop/                # Graph Desktop Environment\n│       ├── graph-engine/       # WebGPU rendering engine\n│       ├── graph-nodes/        # Node system implementation\n│       ├── graph-edges/        # Edge and relationship system\n│       ├── graph-layout/       # Layout algorithms (6 complete)\n│       ├── graph-interaction/  # Input and interaction handling\n│       ├── graph-ai/           # AI integration layer\n│       ├── graph-workspaces/   # Workspace management\n│       ├── graph-integration/  # System integration\n│       ├── graph-config/       # Configuration and theming\n│       └── graph-bridge/       # Traditional mode compatibility\n├── scripts/                    # Build and deployment scripts\n├── config/                     # Development configuration\n├── docs/                       # Architecture and API documentation\n└── build/                      # Build artifacts (gitignored)\n```\n\n## 📚 Documentation\n\n- **[Developer Guide](src/kotlin-config/docs/DEVELOPER_GUIDE.md)** - Complete development setup and workflow\n- **[Automation Guide](src/kotlin-config/docs/AUTOMATION_GUIDE.md)** - RPA and workflow automation\n- **[Implementation Progress](kotlin-dsl-implementation-progress.md)** - Detailed development roadmap\n- **[Graph Desktop Progress](GRAPH_DESKTOP_PROGRESS.md)** - Graph desktop environment implementation status\n- **[API Reference](src/kotlin-config/docs/)** - Complete DSL API documentation\n\n## 🧪 Example Configuration\n\n```kotlin\nhorizonOS {\n    hostname = \"my-horizonos\"\n    timezone = \"America/New_York\"\n    locale = \"en_US.UTF-8\"\n\n    // Type-safe package management\n    packages {\n        group(\"base\") {\n            install(\"base\", \"linux\", \"btrfs-progs\")\n        }\n        group(\"desktop\") {\n            install(\"plasma-meta\", \"firefox\")\n        }\n    }\n\n    // Network configuration with semantic firewall rules\n    network {\n        networkInterface(\"eth0\") {\n            ipv4 { method = IPv4Method.DHCP }\n        }\n        \n        firewall {\n            allow {\n                ssh(from = \"192.168.1.0/24\")\n                https()\n                port(8080, from = \"localhost\")\n            }\n        }\n        \n        wifi {\n            network(\"HomeWiFi\") {\n                password = \"secret123\"\n                security = WiFiSecurity.WPA3_PSK\n            }\n        }\n    }\n\n    // AI/LLM integration\n    ai {\n        enabled = true\n        model(\"llama3\") {\n            provider = \"ollama\"\n            size = ModelSize.MEDIUM\n            capabilities(TEXT_GENERATION, CODE_GENERATION)\n        }\n        privacy = Privacy.LOCAL_ONLY\n    }\n\n    // Automation workflows\n    automation {\n        workflow(\"daily-update\") {\n            trigger { time(\"02:00\") }\n            actions { runCommand(\"pacman -Syu --noconfirm\") }\n        }\n    }\n}\n```\n\n## 🔬 Development Status\n\nHorizonOS is in active development with focus on core system modules and the revolutionary graph desktop implementation.\n\n## 🎯 Project Goals\n\n- **Replace traditional config management** with type-safe, validated configurations\n- **Pioneer graph-based computing** as the next evolution of desktop interfaces  \n- **Achieve enterprise reliability** through immutable infrastructure\n- **Maintain rolling release** benefits while ensuring system stability\n- **Privacy by design** with local-first AI and zero telemetry\n\n## 📊 Current Statistics\n\n### Kotlin DSL\n- **86+ Tests** - Comprehensive test coverage\n- **2000+ Lines** - Kotlin DSL implementation\n- **10+ Modules** - System configuration coverage\n- **5+ Examples** - Real-world configuration demonstrations\n- **100% Type Safety** - Compile-time validation for all configurations\n\n### Graph Desktop Environment\n- **4/10 Core Components** - Complete (Rendering, Nodes, Edges, Layout)\n- **6 Layout Algorithms** - Force-directed, hierarchical, circular, grid, cluster, temporal\n- **8 Node Types** - Application, File, Person, Task, Device, AIAgent, Concept, System\n- **8 Edge Types** - Contains, DependsOn, CommunicatesWith, CreatedBy, RelatedTo, Temporal, TaggedAs, WorksOn\n- **3000+ Lines** - Rust implementation with WebGPU/wgpu-rs\n- **50+ Tests** - Comprehensive test coverage for all components\n\n---\n\n**HorizonOS**: Where immutable infrastructure meets intelligent automation and revolutionary user experiences.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodeyousef%2Fhorizonos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodeyousef%2Fhorizonos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodeyousef%2Fhorizonos/lists"}