The Horilla Setup CLI is a lightweight, cross-platform command-line tool designed to streamline the initialization, migration, upgrade, and dependency management processes across the Horilla ecosystem — including HRMS v1, HRMS v2, and the newly released Horilla CRM.

It automates repetitive setup tasks like environment preparation, Git cloning, dependency installation, and migration handling — ensuring a smooth, consistent workflow for developers and deployment teams.

✓ Quick project setup for HRMS (v1 & v2) and CRM ✓ Version-aware migrations including HRMS v1 → v2 upgrade ✓ Automated dependency installation from requirements.txt ✓ Seamless project upgrades via Git pull ✓ Cross-platform support (Windows, Linux, macOS) ✓ Single command workflow for setup, migration, and updates

pip install horillasetup

If you’re improving or modifying the tool:

git clone https://github.com/horilla-opensource/setup.git cd horilla-ctl pip install -e .

-e installs the package in editable mode, so changes take effect instantly.

Show all available commands:

horillasetup --help

horillasetup build hrms-v1

horillasetup build hrms-v2

horillasetup build crm

The build command will:

• Clone the correct Horilla repo (branch-specific)
• Copy project files into the working directory
• Install Python dependencies
• Provide environment setup instructions

horillasetup migrate hrms-v1

horillasetup migrate hrms-v2

horillasetup migrate crm

Migration steps include:

• Running makemigrations
• Applying migrations
• Collecting static files

Pull latest code updates from Git:

horillasetup upgrade hrms-v1

horillasetup upgrade hrms-v2

horillasetup upgrade crm

To migrate an existing v1 database into v2:

horillasetup migrate hrms-v2 --existing

This performs:

• Safe clearing of old migration entries
• Faked compatibility migrations
• Full v2 migration + static collection

horillasetup install-deps

Installs all packages from requirements.txt.

# Build a fresh CRM project horillasetup build crm # Run CRM migrations horillasetup migrate crm # Upgrade project later horillasetup upgrade crm

• 🔌 Plugin-based scaffolding for new Horilla modules
• 🔍 Automated version & dependency conflict detection
• 📦 Project template generator
• 🧰 Extended DevOps tools integration