Skip to content

đź“Ą Installation Guide

Prerequisites

Before installing Alien Invasion, make sure you have the following installed:

  • Python 3.8 or higher
  • Pygame 2.5.0 or higher
  • Node.js (for development tools)
  • Git

Installation Steps

1. Clone the Repository

git clone https://github.com/avilesxd/code-destroy-aliens.git
cd code-destroy-aliens

2. Install Dependencies

Windows

# Install Node.js dependencies
npm install

# Create and activate virtual environment
python -m venv env
env\Scripts\activate

# Install Python dependencies
pip install -r requirements.txt

Linux/MacOS

# Install Node.js dependencies
npm install

# Create and activate virtual environment
python3 -m venv env
source env/bin/activate

# Install Python dependencies
pip install -r requirements.txt

3. Verify Installation

# Run the game in development mode
npm run dev

# Or run directly
python main.py

Troubleshooting

Common Issues

  1. Python not found

    • Make sure Python is installed and added to your PATH
    • Verify installation with python --version

  2. Pygame installation fails

    • Make sure you have the required build tools
    • On Windows, you might need Visual C++ Build Tools
    • On Linux, install development libraries: sudo apt-get install python3-dev

  3. Virtual environment issues

    • If activation fails, try using the full path to the activation script
    • Make sure you're using the correct activation command for your OS

Getting Help

If you encounter any issues not covered here:

  1. Check the Troubleshooting Guide
  2. Open an issue

Next Steps