Installation

This guide will help you set up the digitalNXT Agency development environment.

Prerequisites

Before installing digitalNXT Agency, ensure you have the following prerequisites installed:

git clone https://dev.azure.com/ictnv/digitalNXT%20Product%20Libraries/_git/DigitalNXT.Agency
cd DigitalNXT.Agency

Using uv (recommended for speed):

# Create and activate virtual environment
uv venv
source .venv/bin/activate  # On Windows: .\.venv\Scripts\activate

# Install project dependencies
just install

# Copy environment template
cp .env.example .env

# Edit .env file with your configuration
# Add your Azure resource names and API keys

# View all available commands
just --list

# Run tests to verify everything is working
just test

# Activate virtual environment on Windows
.\.venv\Scripts\activate

# Install dependencies
just install

# Activate virtual environment
source .venv/bin/activate

# Install dependencies
just install

If using Visual Studio Code, install these extensions:

Set up pre-commit hooks for code quality:

# Install pre-commit hooks
pre-commit install

# Run manually (optional)
pre-commit run --all-files

If Poetry installation fails:

# Clear Poetry cache
poetry cache clear pypi --all

# Try installing again
poetry install

Ensure you're using Python 3.10 or higher:

python --version
# Should show Python 3.10.x or higher

If virtual environment activation fails:

# Recreate virtual environment
rm -rf .venv
uv venv
source .venv/bin/activate

If you encounter issues during installation:

After successful installation: