Python Virtual Environment

This guide walks you through installing Zango within a Python virtual environment. Virtual environments create isolated environments for your projects, ensuring dependencies are managed separately for each project.

Pre-requisites

• Python 3.8 or later installed on your system.
• pip (Python package manager) installed.
• Basic knowledge of command-line operations.

---

Step 1: Create a Project Directory

Create a directory for your project to keep things organized:

mkdir my_zango_project
cd my_zango_project

---

Step 2: Create a Virtual Environment

Run the following command to create a virtual environment:

python -m venv venv

This creates a directory named venv in your project folder.

---

Step 3: Activate the Virtual Environment

macOS/Linux

source venv/bin/activate

Windows

venv\Scripts\activate

Once activated, your command prompt will display (venv) at the beginning, indicating the virtual environment is active.

---

Step 4: Install Zango

With the virtual environment active, install Zango using pip:

pip install Zango

This downloads and installs Zango and its dependencies in the isolated environment.

---

Step 5: Verify the Installation

After installation, confirm that Zango is installed correctly:

zango --version

This should display the version of Zango installed.

---

Next steps

Now that Zango is installed, set up the pre-requisites (PostgreSQL and Redis) before creating your first project.

Prerequisites

Set up PostgreSQL and Redis — the two services Zango requires before you create a project.

Read the prerequisites →

Creating a Zango Project

Once pre-requisites are in place, use the Zango CLI to scaffold your first project.

Create your project →