This project serves as a template for creating Python projects in the Dense Analysis preferred manner. See Development steps below for initial setup, and after boostraping a new project edit project files as you see fit to start off your Python project.

NOTE: This project template is released to the public domain free of charge, and you may freely remove and replace the LICENSE file and copyright notice when building your projects so you may use a license of our choice without crediting Dense Analysis. We simply wish to help you get started with Python projects quickly.

Set up virtualenv initially for local development like so:

pyenv install
python -m pip install uv
uv sync

This repo currently targets Python 3.15.0a8; pyenv install will pick that up from .python-version.

If you are creating a new project, you can quickly set it up with the convenience script, which will delete itself after it's run.

./bootstrap-project.sh new_project_name

You can check the project for errors like so:

# Run the linter and autofix warnings/errors.
uv run ruff check --fix
# Run the type checker to spot typing issues.
uv run pyright
# Run unit and integration tests.
uv run pytest

To add dependencies, use one of the following commands:

uv add some_package
uv add --dev some_package

You can run the project with docker compose like so:

docker compose up

You can test the docker image like so:

docker build --no-cache -t example_project:latest .
docker run -it --rm example_project:latest

The production image uses al3xos/python-distroless:3.14.4-debian13, then copies in the 3.15.0a8 runtime from the slim builder image because no distroless alpha tag is published.