AAI Backend

The backend library between Auth0 and the AAI portal front end. Technical design document for this project lives in this Google doc.

Requirements

Ensure you have the following installed:

• python 3.13+
• uv (installation instructions)

Installation

Follow these steps to set up the project:

1. Clone the Repository:

   git clone https://github.com/AustralianBioCommons/aai-backend.git
   cd aai-backend

2. Set Up a Virtual Environment: Create and activate a virtual environment:

   uv venv
   source .venv/bin/activate

3. Install Dependencies:

   uv sync

   For dev:

   uv sync --extra dev

4. Install pre-commit:

   pre-commit install

Run the Application

Use uv to run the FastAPI application:

uv run fastapi dev main.py

Run Tests

Execute the test suite using pytest:

uv run pytest

Run the Linter

This command will automatically fix issues where possible:

uv run -- ruff check . --fix

Manually run pre-commit

pre-commit run --all-files

Deployment

Currently the service is deployed to AWS via the CDK scripts in deploy/, and updated on each commit to main.

Secrets/configuration variables for the deployment are stored in the GitHub Secrets for the repository.