Pixel OS

pixelos-banner pixelos-banner

Pixel OS

Pixel OS is Midori AI’s family of container-first Linux distributions designed for development and AI/ML workloads.

  • PixelArch OS: Arch Linux-based, lightweight, and Docker-optimized.
  • PixelGen OS: Gentoo Linux-based, source-built, performance-focused, and highly customizable.

Subsections of Pixel OS

PixelArch OS

pixelarch-logo pixelarch-logo

PixelArch OS: A Docker-Optimized Arch Linux Distribution

PixelArch OS is a lightweight and efficient Arch Linux distribution designed for containerized environments. It provides a streamlined platform for developing, deploying, and managing Docker-based workflows.

Key Features:

  • Arch-Based: Built on the foundation of Arch Linux, known for its flexibility and extensive package selection.
  • Docker-Optimized: Tailored for efficient Docker usage, allowing for seamless integration with your containerized workflows.
  • Frequent Updates: Regularly receives security and performance updates, ensuring a secure and up-to-date environment.
  • Package Management: Utilizes the powerful yay package manager alongside the traditional pacman, providing a flexible and efficient way to manage software packages.
  • Minimal Footprint: Designed to be lightweight and resource-efficient, ideal for running in Docker containers.

PixelArch Flavors: A Tiered Approach

PixelArch is offered in a tiered structure, with each level building upon the previous, providing increasing functionality and customization options:

  • Level 1: Quartz - The foundation; a minimal base system, providing a clean slate for your specific needs.
  • Level 2: Amethyst - Core utilities; includes essential tools like curl, wget, and docker, alongside several quality-of-life enhancements.
  • Level 3: Topaz - Development focused; pre-configured with key development languages and tools, including python, nodejs, and rust.
  • Level 4: Emerald - Remote access and desktop environment; provides secure remote shell and tunnel capabilities (via tmate, rdp, or ssh) and a full Enlightenment Desktop.

Getting Started

​
​

Image Size - 530mb

  • Step 1. Setup the OS (distrobox create -i lunamidori5/pixelarch:quartz -n PixelArch --root)
  • Step 2. Enter the OS (distrobox enter PixelArch --root)

Image Size - 870mb

  • Step 1. Setup the OS (distrobox create -i lunamidori5/pixelarch:amethyst -n PixelArch --root)
  • Step 2. Enter the OS (distrobox enter PixelArch --root)

Image Size - 1.15gb

  • Step 1. Setup the OS (distrobox create -i lunamidori5/pixelarch:topaz -n PixelArch --root)
  • Step 2. Enter the OS (distrobox enter PixelArch --root)

Image Size - 3.5gb

  • Step 1. Setup the OS (distrobox create -i lunamidori5/pixelarch:emerald -n PixelArch --root)
  • Step 2. Enter the OS (distrobox enter PixelArch --root)

1. Create a docker-compose.yaml

Pick a flavor and create a docker-compose.yaml with the matching config:

​

Image Size - 530mb

services:
  pixelarch-os:
    image: lunamidori5/pixelarch:quartz
    tty: true
    restart: always
    privileged: false
    command: ["sleep", "infinity"]

Image Size - 870mb

services:
  pixelarch-os:
    image: lunamidori5/pixelarch:amethyst
    tty: true
    restart: always
    privileged: true
    command: ["sleep", "infinity"]
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock

Image Size - 1.15gb

services:
  pixelarch-os:
    image: lunamidori5/pixelarch:topaz
    tty: true
    restart: always
    privileged: true
    command: ["sleep", "infinity"]
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock

Image Size - 3.5gb

services:
  pixelarch-os:
    image: lunamidori5/pixelarch:emerald
    tty: true
    restart: always
    privileged: true
    command: ["sleep", "infinity"]
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock

2. Start the container in detached mode

docker compose up -d

3. Access the container shell

docker compose exec pixelarch-os /bin/bash

Midori AI recommends switching to Linux instead of Windows. If you still want to use PixelArch in WSL2, follow the steps below. No Windows-specific support is provided.

1. Setup the docker image

docker run -t --name wsl_export lunamidori5/pixelarch:quartz ls /

2. Export the PixelArch filesystem from docker

docker export wsl_export > /mnt/c/temp/pixelarch.tar

3. Clean up the docker image

docker rm wsl_export

4. Import PixelArch into WSL

cd C:\\temp
mkdir E:\\wslDistroStorage\\pixelarch
wsl --import Pixelarch E:\\wslDistroStorage\\pixelarch .\\pixelarch.tar

1. Use PixelArch shell

​

Image Size - 530mb

docker run -it --rm lunamidori5/pixelarch:quartz /bin/bash

Image Size - 870mb

docker run -it --rm lunamidori5/pixelarch:amethyst /bin/bash

Image Size - 1.15gb

docker run -it --rm lunamidori5/pixelarch:topaz /bin/bash

Image Size - 3.5gb

docker run -it --rm lunamidori5/pixelarch:emerald /bin/bash

Package Management

Use the yay package manager to install and update software:

yay -Syu <package_name>

Example:

yay -Syu vim

This will install or update the vim text editor.

Note:

  • Replace <package_name> with the actual name of the package you want to install or update.
  • The -Syu flag performs a full system update, including package updates and dependencies.

Support and Assistance

If you encounter any issues or require further assistance, please feel free to reach out through the following channels:

PixelGen OS

pixelgen-logo pixelgen-logo

PixelGen OS: A Docker-Optimized Gentoo Linux Distribution

PixelGen OS is a Gentoo Linux-based operating system designed for advanced users who want maximum performance and customization in containerized environments. It leverages Gentoo’s source-based package management within Docker containers, providing flexible, optimized builds for specialized workloads.

Key Features:

  • Gentoo-Based: Built on Gentoo Linux for deep system customization.
  • Source-Based Compilation: Compile packages with your preferred CFLAGS, USE flags, and optimization settings.
  • Docker-Optimized: Designed for consistent container deployments while keeping Gentoo’s flexibility.
  • Portage Package Manager: Uses Portage (emerge) for fine-grained dependency and build control.
  • Pacaptr Compatibility Layer: Includes pacaptr for yay/pacman-style command aliases to ease transitions.
  • Performance-Focused: Ships with an opinionated make.conf you can tune for your target hardware.

Getting Started

​

1. Create a docker-compose.yaml

services:
  pixelgen-os:
    image: lunamidori5/pixelgen
    tty: true
    restart: always
    privileged: true
    command: ["sleep", "infinity"]

2. Start the container in detached mode

docker compose up -d

3. Access the container shell

docker compose exec pixelgen-os /bin/bash

1. Clone the repository

git clone https://github.com/lunamidori5/Midori-AI-Pixelarch-OS.git

2. Build the PixelGen image

cd Midori-AI-Pixelarch-OS/pixelgen_os
docker build -t pixelgen -f gentoo_dockerfile .

3. Run the image

docker run -it --rm pixelgen /bin/bash

Package Management

Use the yay package manager to install and update software:

yay -Syu <package_name>

Example:

yay -Syu vim

This will install or update the vim text editor.

  • Replace <package_name> with the actual name of the package you want to install or update.
  • The -Syu flag performs a full system update, including package updates and dependencies.

Support and Assistance

If you encounter any issues or require further assistance, please feel free to reach out through the following channels: