{"id":45404016,"url":"https://github.com/cxlinux-ai/cx-distro","last_synced_at":"2026-02-21T20:43:38.316Z","repository":{"id":333011572,"uuid":"1129055441","full_name":"cxlinux-ai/cx-distro","owner":"cxlinux-ai","description":"CX Linux ISO Builder — AI-native Linux distribution. Ubuntu/Debian base with embedded LLM. Download the AI Linux OS.","archived":false,"fork":false,"pushed_at":"2026-02-21T07:28:22.000Z","size":214990,"stargazers_count":5,"open_issues_count":48,"forks_count":9,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-21T14:25:11.866Z","etag":null,"topics":["ai-linux","ai-linux-distro","ai-native-linux","ai-operating-system","ai-os","amd-gpu","cortex-linux","debian-ai","embedded-llm","iso-builder","linux-ai","linux-distribution","linux-kernel","nvidia-drivers","reproducible-builds","secure-boot","ubuntu-ai"],"latest_commit_sha":null,"homepage":"https://cxlinux.ai/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cxlinux-ai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-06T14:41:55.000Z","updated_at":"2026-02-21T07:28:24.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/cxlinux-ai/cx-distro","commit_stats":null,"previous_names":["cortexlinux/cortex-distro","cxlinux-ai/cx-distro"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/cxlinux-ai/cx-distro","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cxlinux-ai%2Fcx-distro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cxlinux-ai%2Fcx-distro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cxlinux-ai%2Fcx-distro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cxlinux-ai%2Fcx-distro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cxlinux-ai","download_url":"https://codeload.github.com/cxlinux-ai/cx-distro/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cxlinux-ai%2Fcx-distro/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29692541,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-21T18:18:25.093Z","status":"ssl_error","status_checked_at":"2026-02-21T18:18:22.435Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["ai-linux","ai-linux-distro","ai-native-linux","ai-operating-system","ai-os","amd-gpu","cortex-linux","debian-ai","embedded-llm","iso-builder","linux-ai","linux-distribution","linux-kernel","nvidia-drivers","reproducible-builds","secure-boot","ubuntu-ai"],"created_at":"2026-02-21T20:43:37.777Z","updated_at":"2026-02-21T20:43:38.311Z","avatar_url":"https://github.com/cxlinux-ai.png","language":"Shell","readme":"# CX Distro\n\n**Debian-based Distribution Engineering for CX Linux**\n\n[![License](https://img.shields.io/badge/license-BSL%201.1-orange.svg)](LICENSE)\n[![Debian](https://img.shields.io/badge/base-Debian%2013%20trixie-A81D33.svg)](https://debian.org)\n[![Build](https://img.shields.io/github/actions/workflow/status/cxlinux-ai/cx-distro/build-iso.yml?branch=main)](https://github.com/cxlinux-ai/cx-distro/actions)\n\n## Overview\n\n`cx-distro` handles everything related to building and distributing CX Linux as a Debian-based operating system. This includes ISO generation, package repository management, automated installation, and supply-chain security.\n\n**CX Linux** is an AI-native operating system that translates natural language commands into Linux operations, eliminating traditional documentation complexity for server management.\n\n## Quick Start\n\n### Build ISO (Debian/Ubuntu host required)\n\n```bash\n# Clone repository\ngit clone https://github.com/cxlinux-ai/cx-distro.git\ncd cx-distro\n\n# Install dependencies (requires sudo)\nsudo apt-get install -y live-build debootstrap squashfs-tools xorriso \\\n    isolinux syslinux-efi grub-pc-bin grub-efi-amd64-bin \\\n    mtools dosfstools dpkg-dev devscripts debhelper fakeroot gnupg\n\n# Build offline ISO (recommended)\nchmod +x scripts/build.sh\nsudo ./scripts/build.sh offline\n\n# Or use Makefile\nmake deps  # Install dependencies\nmake iso   # Build ISO\n```\n\n### Output\n\nAfter a successful build:\n```\noutput/\n├── cx-linux-0.1.0-amd64-offline.iso      # Bootable ISO\n├── cx-linux-0.1.0-amd64-offline.iso.sha256\n├── packages/\n│   ├── cx-archive-keyring_*.deb\n│   ├── cx-core_*.deb\n│   └── cx-full_*.deb\n└── sbom/\n    ├── cx-linux-0.1.0.cdx.json           # CycloneDX SBOM\n    └── cx-linux-0.1.0.spdx.json          # SPDX SBOM\n```\n\n## Architecture\n\n```\ncx-distro/\n├── iso/                        # ISO build configuration\n│   ├── live-build/             # Debian live-build configs\n│   │   ├── auto/               # Build automation scripts\n│   │   └── config/             # Package lists, hooks, includes\n│   └── preseed/                # Automated installation preseeds\n├── packages/                   # Debian package definitions\n│   ├── cx-archive-keyring/ # GPG keyring package\n│   ├── cx-core/            # Minimal installation meta-package\n│   └── cx-full/            # Full installation meta-package\n├── repository/                 # APT repository tooling\n│   └── scripts/                # repo-manage.sh\n├── sbom/                       # SBOM generation (CycloneDX/SPDX)\n├── branding/                   # Plymouth theme, wallpapers\n├── scripts/                    # Build automation\n│   └── build.sh                # Master build script\n├── tests/                      # Verification tests\n│   ├── verify-iso.sh\n│   ├── verify-packages.sh\n│   └── verify-preseed.sh\n├── .github/workflows/          # CI/CD pipelines\n├── Makefile                    # Build targets\n└── README.md\n```\n\n## Key Components\n\n| Component | Description |\n|-----------|-------------|\n| **ISO Builder** | Reproducible ISO image pipeline using Debian live-build |\n| **APT Repository** | Signed package repository with GPG key management |\n| **Meta-packages** | cx-core (minimal), cx-full (complete) |\n| **First-boot** | Preseed automation and idempotent provisioning |\n| **SBOM** | Software Bill of Materials (CycloneDX/SPDX) |\n\n## Installation Profiles\n\n### cx-core (Minimal)\n- Base system with Python 3.11+\n- Security sandbox (Firejail, AppArmor)\n- SSH server\n- CX package manager dependencies\n\n### cx-full (Recommended)\nEverything in cx-core plus:\n- Docker and container tools\n- Network security (nftables, fail2ban)\n- Monitoring (Prometheus node exporter)\n- Web server (nginx) and TLS (certbot)\n- GPU support prerequisites\n- Modern CLI tools (htop, btop, fzf, ripgrep, bat)\n\n## Automated Installation\n\nCX Linux supports fully unattended installation via preseed:\n\n```bash\n# Boot parameter for automated install\npreseed/file=/cdrom/preseed/cx.preseed\n```\n\n### Preseed Features\n- UEFI and BIOS support\n- LVM partitioning (default)\n- Optional LUKS encryption\n- SSH key injection\n- Admin user creation\n- CX repository configuration\n\n## APT Repository\n\nCX uses a signed APT repository with deb822 format:\n\n```\n# /etc/apt/sources.list.d/cx.sources\nTypes: deb\nURIs: https://repo.cxlinux-ai.com/apt\nSuites: cx cx-updates cx-security\nComponents: main\nSigned-By: /usr/share/keyrings/cx-archive-keyring.gpg\n```\n\n### Repository Management\n\n```bash\n# Initialize repository\n./repository/scripts/repo-manage.sh init\n\n# Add package\n./repository/scripts/repo-manage.sh add packages/cx-core_0.1.0-1_all.deb\n\n# Publish (sign and generate metadata)\nCX_GPG_KEY_ID=ABCD1234 ./repository/scripts/repo-manage.sh publish\n\n# Create snapshot\n./repository/scripts/repo-manage.sh snapshot\n\n# Export for offline use\n./repository/scripts/repo-manage.sh export cx-offline-repo\n```\n\n## Security\n\n### Supply Chain\n- Signed ISO images (SHA256/SHA512)\n- Signed APT repository (GPG)\n- SBOM generation (CycloneDX, SPDX)\n- Reproducible builds (goal)\n\n### System Hardening\n- AppArmor profiles\n- Firejail sandboxing\n- Secure sysctl defaults\n- SSH hardening\n- nftables firewall\n\n## Build Targets\n\n```bash\nmake help           # Show all targets\nmake iso            # Build full offline ISO\nmake iso-netinst    # Build minimal network installer\nmake package        # Build all Debian packages\nmake package PKG=cx-core  # Build specific package\nmake sbom           # Generate SBOM\nmake test           # Run verification tests\nmake clean          # Remove build artifacts\nmake deps           # Install build dependencies\n```\n\n## Topics Covered\n\nThis repository implements 9 major topics from the CX Linux planning:\n\n- [x] Automated installation and first-boot provisioning\n- [x] CX package repository and apt trust model\n- [x] Debian base selection and compatibility contract\n- [ ] Debian packaging strategy for CX components\n- [ ] GPU driver enablement and packaging (NVIDIA/AMD)\n- [x] ISO image build system (live-build)\n- [ ] Kernel, firmware, and hardware enablement plan\n- [x] Reproducible builds, artifact signing, and SBOM outputs\n- [ ] Upgrade, rollback, and version pinning\n\n## Requirements\n\n### Build Host\n- Debian 12+ or Ubuntu 24.04+\n- 10GB+ free disk space\n- Internet connection (for package downloads)\n- Root/sudo access\n\n### Target Hardware\n- x86_64 (amd64) architecture\n- UEFI or Legacy BIOS\n- 2GB+ RAM (4GB+ recommended)\n- 20GB+ storage\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n### Development Workflow\n\n1. Fork the repository\n2. Create a feature branch\n3. Make changes\n4. Run tests: `make test`\n5. Submit PR\n\n## Related Repositories\n\n- [cx-terminal](https://github.com/cxlinux-ai/cx-core) - AI-powered terminal emulator\n- [website](https://github.com/cxlinux-ai/website) - cxlinux-ai.com\n\n## License\n\nBSL 1.1 - See [LICENSE](LICENSE)\n\n## Support\n\n- Documentation: https://cxlinux-ai.com/docs\n- Issues: https://github.com/cxlinux-ai/cx-distro/issues\n- Discord: https://discord.gg/cxlinux-ai\n\n---\n\n**Copyright 2025 AI Venture Holdings LLC**\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcxlinux-ai%2Fcx-distro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcxlinux-ai%2Fcx-distro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcxlinux-ai%2Fcx-distro/lists"}