Penguins' Eggs — Packages

This directory contains native packages belonging to the Penguins Linux ecosystem.

The projects are intentionally separated: each tool has a different job.

The ecosystem

                    Linux system
                         │
              ┌──────────┴──────────┐
              │                     │
            Chef           Tailor (debian family only)
              │                     │
        desktop/costumes     desktop/costumes
              │                     │
              └──────────┬──────────┘
                         │
                    penguins-eggs
                         │
                    live ISO
                         │
                    penguins-gui
                    (optional GUI)

The tools can be used independently. They are not different editions of the same program.


🖥️ penguins-gui

See: appimage/README.html


🥚 penguins-eggs

penguins-eggs is the remastering engine.

Its purpose is to take a running Linux system and turn it into a bootable live ISO.

Eggs deals with the core remastering process:

The normal command is:

sudo eggs remaster

Eggs is the core of the ecosystem.


👨‍🍳 penguins-chef

Chef configures systems by applying explicit recipes.

Chef is a standalone tool for system provisioning and configuration. A recipe describes operations that should be performed on a Linux system.

Typical uses include:

For example, to obtain my colibri where I develop eggs:

chef get
sudo chef apply .chef/recipes/costumes/colibri/colibri.yaml
sudo chef apply .chef/recipes/dev/devel.yaml

Chef is therefore concerned primarily with system configuration and provisioning.

It does not replace Eggs.

Think of Chef as the person who cooks the system.


✂️ penguins-tailor (only debian based systems)

Tailor was the first version of chef, and work only on Debian/Devuan/Ubuntu systems.

Tailor dresses the system.

Tailor is the companion tool for applying desktop configurations, themes, packages and other customizations collected in a wardrobe.

A costume can describe things such as:

Typical workflow:

tailor get
tailor list
sudo tailor wear <costume>

Tailor is especially useful when starting from a naked system and preparing it before creating an ISO.


🕰️ penguins-eggs-legacy

penguins-eggs-legacy is the previous generation of Penguins' Eggs.

It is the original TypeScript/Node.js implementation that preceded the current C/Go implementation.

The current penguins-eggs is the active implementation.

Legacy is kept available for:

For a new installation, use penguins-eggs unless you specifically need Legacy.


Which package should I install?

What you want to doPackage
Create a live ISO penguins-eggs
Configure a Linux system from recipes penguins-chef
Customize a desktop with costumes (debian) penguins-tailor
Use penguins-eggs via GUI penguins-gui
Continue using the old Eggs implementation penguins-eggs-legacy

Typical workflows

Build a customized Linux ISO

base Linux system (CLI/naked)
       ↓
     Chef
       ↓
     Eggs
       ↓
    Live ISO

Use Eggs directly

running Linux system
       ↓
     Eggs
       ↓
    Live ISO

Use eggs in a graphical desktop

penguins-gui
       ↓
     Eggs
       ↓
    Live ISO

The tools are complementary, not competing implementations.


Where to start

If you are new to Penguins' Eggs:

1. Install penguins-eggs.

2. Create a standard remaster.

3. If you want a customized desktop, look at penguins-chef or penguins-tailor.

4. If you prefer a desktop application, install penguins-gui.

5. Use legacy only when you have a specific reason to use the previous implementation.