Setup & Installation

Python 3.10+ – Download Python

Node.js & npm (for Tailwind CSS) – Download Node.js

PostgreSQL (or SQLite for development) – Download PostgreSQL

Git – Download Git

1. Clone the Repository

First, open a terminal and run:

git clone https://github.com/Alpha-team-project/Alpha-player-django.git

2. Set Up a Virtual Environment

Creating a virtual environment helps manage dependencies.

python -m venv venv

3. Install Backend Dependencies

Next, install the required Python packages:

pip install -r requirements.txt

4. Set Up Environment Variables

Create a .env file in the root directory and add:

cp .env.example .env

For SQLite (development), you don’t need database settings.

5. Apply Database Migrations

Run the following command to create database tables:

python manage.py migrate

6. Create a Superuser (Admin Panel Access)

To access the Django Admin panel, create a superuser:

python manage.py createsuperuser

Enter a username, email, and password when prompted.

7. Install & Build Tailwind CSS

Tailwind CSS is used for frontend styling.

python manage.py tailwind build

This compiles the CSS whenever you make changes.

8. Run the Development Server

Now, start the Django server:

python manage.py runserver

Open http://127.0.0.1:8000/ in your browser.

Now, Alpha Player should be running on your local machine! 🚀

docker-compose up -d --build

Login page click to see

Sign up page click to see

Dashboard page click to see

Browse musics click to see

Music detail page click to see