Atomic Ansible (v3.0)

A powerful configuration management system for Fedora Silverblue (GNOME) and Fedora Kinoite (KDE), powered by Ansible.

Important

v3.0 is a complete rewrite. We have migrated from bash scripts to a modular Ansible architecture. While user-space configs (dotfiles, themes, flatpaks) run without sudo, base OS modifications (like removing RPM bloatware and installing Virtualization tools) will prompt for your password via Ansible's become.

Key Features

• Hybrid Privilege Model: User-space configurations happen without sudo, while OS-level changes securely prompt for authorization.
• Automatic Multi-Distro Support: Detects if you are on Silverblue or Kinoite and applies the correct environment.
• Bloatware Removal: Systematically removes default GNOME or KDE RPMs/Flatpaks to give you a pristine base system.
• Virtualization & Development: Installs libvirt, qemu-kvm, and sets up the Brave repository automatically.
• Minimalist CLI: Optimized output using the unixy callback for a clean, distraction-free experience.
• Toolbox Sync: Automatically synchronizes your host theme, icons, and fonts to all your Toolbox containers.
• Safe Maintenance: Integrated Flatpak updates and home directory reset utilities.

Requirements

• Fedora Atomic (Silverblue or Kinoite)
• Ansible installed in your user environment or a venv.

Quick Start

git clone https://github.com/kairosci/atomix.git
cd atomix

# Run the full setup (Automatic detection)
make setup

# Or run specific desktop configurations
make silverblue
make kinoite

Available Commands

Command	Description
make setup	Detects distro and applies full configuration
make silverblue	Runs only the GNOME/Silverblue playbook
make kinoite	Runs only the KDE/Kinoite playbook
make ollama	Prompts to install the Ollama Toolbox container
make update	Updates user-level Flatpaks and cleans up
make reset-home	Resets dotfiles (with confirmation)
make VERBOSE="-v"	Run any command with Ansible verbosity

Structure

.
├── Makefile                # Main entry point
├── ansible.cfg             # Optimized Ansible settings
├── ansible/
│   ├── playbooks/          # Main orchestration files
│   └── roles/              # Specialized kebab-case roles
│       ├── system-config   # Dotfiles and aliases
│       ├── package-config  # Flatpak remotes
│       ├── toolbox-config  # Theme synchronization
│       ├── gnome-*        # GNOME specific theme/ext
│       └── kde-*          # KDE specific theme/config

Performance & Debugging

Atomic Ansible v3.0 uses the unixy output plugin to eliminate the "stars" and noise of standard Ansible. For deep debugging, use the verbosity flag:

make setup VERBOSE="-vvv"

License

Apache License 2.0