TOOL / SCRIPT
Aetherix AKA Alchemy: Dev Environment Orchestrator
betaBeta: This tool is functional and actively used, but still being refined. Some features may change as I continue improving it based on real-world usage. Found a bug or have suggestions? Open an issue on GitHub.
Transform bare Linux systems into fully-configured development environments through the power of cosmic alchemy. Automates installation of Docker, Nginx, PostgreSQL, and 20+ essential dev tools.
time Saved
90%
components
20+
setup
< 30 min
What It Does
Aetherix is the project. Alchemy is the command. A modular system setup script that automates the entire development environment configuration process through cosmic transformation. It handles Docker, Nginx, PostgreSQL, Zsh, Vim, VS Code, and 20+ other tools with intelligent dependency resolution, health checks, and rollback capabilities. One alchemy command transforms a fresh Linux install into a production-ready dev environment.
The Problem
Setting up a new development machine meant spending 3-6 hours installing and configuring dozens of tools, remembering all the configuration steps, and debugging when things inevitably broke. Every new project or team member onboarding was a time sink, and maintaining consistency across environments was nearly impossible.
The Solution
Aetherix automates the entire process with a modular, extensible architecture powered by alchemy commands. It handles dependencies intelligently, validates installations, and provides rollback on failures. Now I can set up a complete dev environment in under 30 minutes, and team members can replicate my exact setup with one command.
Key Features
Modular architecture with 20+ component modules
Interactive component selection with multi-select UI
Smart dependency resolution and ordering
Resume interrupted installations from last checkpoint
Installation analytics and performance tracking
Comprehensive health checks and validation
Automatic rollback on failures
Dry-run mode for safe previewing
Beautiful CLI with real-time progress tracking
Configuration persistence across invocations
Usage Examples
Quick Start
Get started with interactive component selection
# Transform your system with alchemy
./alchemy
# Or use the enhanced version
./alchemy-features
# Preview without installing
./alchemy --dry-runAdvanced Options
Advanced features for power users
# Enable debug logging
./alchemy --debug
# Resume interrupted installation
./alchemy-features --resume
# View installation analytics
./alchemy-features --analyticsInteractive Selection
Fine-grained control over what gets installed
# Interactive component selection
./alchemy-features --interactive
# Check component status
./alchemy --components-help
# View available presets
./alchemy --helpWhat's Next
Features I'm thinking about adding slowly:
macOS support for cross-platform development
Windows support for cross-platform development
Ability to add scripts such as DBM, NGX, or more
Cloud provider integration (AWS, GCP, Azure)
Kubernetes cluster setup automation
Custom component marketplace
Team configuration sharing and versioning
License - MIT
© 2025 Shamlo Ameer
This tool is open source and free to use. You're welcome to use, modify, and distribute it for any purpose, including commercial projects. Attribution is appreciated but not required.
✓ You can:
- •Use for personal or commercial projects
- •Modify and adapt to your needs
- •Distribute and share freely
- •Include in your own projects
ℹ️ Please note:
- •Provided "as is" without warranty
- •Attribution appreciated but optional
- •No liability for any damages
Questions or feedback? zothstic@gmail.com