🌎 Genesis

This repository contains the Ansible configuration to automate the setup and maintenance of my personal computer, vps and more. The goal is to turn my machine configuration into "Infrastructure as Code" (IaC), allowing me to rebuild or sync my environment quickly and consistently.

Quick Start (One-Liner)

To set up a fresh machine, just run:

curl -sSL https://raw.githubusercontent.com/stanleygomes/genesis/refs/heads/master/bootstrap.sh | bash

This command will install git, ansible, clone this repository, and run the setup.

---

Manual Getting Started

What does this project do?

• Manages system packages (Apt, Flatpak, Snap etc).
• Configures development environments (Node.js with pnpm, Java, Python, Go, PHP).
• Installs and configures AI tools (Antigravity CLI, GitHub Copilot CLI, Antigravity IDE etc).
• Setups CLI/TUI tools with desktop shortcuts (LazyDocker, etc).
• Customizes the shell and terminal (Zsh with Oh My Zsh, Bash, aliases, GNOME Terminal settings).

Requisites

Before running the playbooks, you need to have Ansible installed on your machine. If you use bootstrap.sh, you don't need to install Ansible manually.

Note

How to install: https://docs.ansible.com/projects/ansible/latest/installation_guide/intro_installation.html

Usage

1. Interactive Installer (Recommended)

The easiest way to set up is using the interactive installer:

./bootstrap.sh

This will open a menu where you can:

• Select multiple playbooks (using Space).
• Choose optional components for specific categories (sub-menus).
• See a summary before the installation begins.

2. Manual Execution (via Makefile)

To run a specific configuration or multiple configurations:

make run CONFIG="bash desktop"

3. Run in dry-run mode:

make check CONFIG="desktop"

📂 Project Structure

⚙️ configs/            # Specific tool configurations (VS Code, etc.)
📊 group_vars/         # Global configuration variables (all.yml)
📜 playbooks/          # Setup playbooks (common.yml, desktop.yml, etc.)
🧩 roles/              # Modular Ansible roles (terminal, docker, etc.)
🛠️ Makefile            # Helper tasks to run, check, list playbooks
🐚 bootstrap.sh        # One-liner script to bootstrap environment
💻 setup.py            # Interactive Python menu installer
inventory              # Ansible host definition (localhost)