Django Installation and Setup

Introduction

Django is a powerful, high-level Python web framework that enables rapid development and clean, pragmatic design. Before you can start building Django applications, it’s essential to install and configure your environment properly. This guide walks you through Django installation and setup from scratch.

Prerequisites

To begin, ensure that you have Python installed on your system. Django requires Python 3. If you’re unsure whether Python is installed, run the following command:

python --version

If not installed, download Python from the official Python website and install it before proceeding.

Setting Up a Virtual Environment

Using a virtual environment is recommended when working with Django projects. It keeps dependencies isolated and avoids conflicts with other Python packages.

# Install virtualenv if not already installed
pip install virtualenv

# Create a virtual environment
virtualenv myenv

# Activate the virtual environment (Windows)
myenv\Scripts\activate

# For macOS/Linux
source myenv/bin/activate

Installing Django

Once your virtual environment is activated, install Django using pip:

pip install django

You can verify the installation by checking the version:

django-admin --version

Starting a Django Project

To create a new Django project, use the following command:

django-admin startproject myproject

This will create a new directory named myproject with the necessary files and structure. Move into your project directory to start the development server:

cd myproject
python manage.py runserver

You can now open your browser and navigate to http://127.0.0.1:8000/ to see the default Django welcome page.

Project Structure Overview

Here’s a quick breakdown of the project folder structure:

• manage.py – A command-line utility for interacting with your project.
• myproject/ – Contains settings, URLs, and WSGI/ASGI configuration.

Creating a Django App

Django encourages modular development. Each module is called an “app.” You can create your first app using:

python manage.py startapp myapp

This will generate a folder myapp with default files to define views, models, and templates for your application.

Running Migrations

Django uses migrations to manage changes to your models and database. Run the following commands to apply initial migrations:

python manage.py makemigrations
python manage.py migrate

Conclusion

Setting up Django is the first step toward building robust Python web applications. By installing Django in a virtual environment, starting a project, and creating your first app, you lay the foundation for further development. With your environment ready, you can now start building views, templates, and models to bring your project to life.