Skip to content
CAI
Software that uses CAICheck a score

Peopl3s/clean-architecture-litestar-project-template

53.2

Weak · 9 November 2026

3k

lines of production code

Python

primary language

7

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

This system is a Python-based application template built on a clean architecture, utilizing Litestar, SQLAlchemy, and Redis/PostgreSQL. It provides a complete development environment with Docker, CI/CD, and automated setup scripts to simplify project initialization. The codebase is structured with unit of work and database mapping modules, supported by tooling for linting, formatting, and testing.

Features

Automated .env file generation via post-generation hook

A new Python script, hooks/post\_gen\_project.py, has been added to the project. This post-generation hook automatically creates a .env file based on the cookiecutter template context, configuring database, cache, and message broker URLs, along with security and application settings. This simplifies the initial setup process for new projects generated from the template.

hooks · high confidence

Initial project scaffolding with Docker, CI/CD, and architecture templates

The project is initialized with a complete development environment, including a multi-stage Dockerfile, docker-compose configurations for production, development, and testing, and a Makefile with commands for linting, formatting, type-checking, and testing. A .gitignore and .dockerignore are added to exclude build artifacts and environment files. The README documents the clean architecture structure, technology stack (Litestar, SQLAlchemy, Redis/PostgreSQL), and how to run the application. Documentation for Docker, environment setup, database migrations, and tooling (Ruff, MyPy) is also included. New Python modules for unit of work and database mapping are created.

_{{cookiecutter.project\slug}} · high confidence

Dependencies

Updated Python dependencies and added docs requirements

The project's dependency manifest (pyproject.toml) has been updated with newer versions of key libraries, including pydantic 2.12.4, alembic 1.17.2, uvicorn 0.38.0, faststream 0.6.3, and sqlalchemy 2.0.44, among others. Additionally, a new docs/requirements.txt file was added to pin documentation build tools such as Sphinx 8.2.3 and related extensions.

(dependencies) · medium confidence

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

Score

  • CAI 48 → 53 (+5.3)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.

Lenses

  • Code Health 100 → 100 (+0.0)
  • Architecture 84 → 84 (+0.0)
  • Maturity 33 → 55 (+21.5)
  • Readiness 29 → 29 (+0.0)
  • Security 96 → 94 (-2.1)
  • Performance 100 → 100 (+0.0)

Resolved (12)

  • Orphaned file ({{cookiecutter.project_slug}}{{cookiecutter.project_slug}}/application/mappers.py)
  • Orphaned file ({{cookiecutter.project_slug}}{{cookiecutter.project_slug}}/application/use_cases/process_artifact.py)
  • Orphaned file ({{cookiecutter.project_slug}}{{cookiecutter.project_slug}}/config/ioc/providers.py)
  • Orphaned file ({{cookiecutter.project_slug}}{{cookiecutter.project_slug}}/config/settings.py)
  • Orphaned file ({{cookiecutter.project_slug}}{{cookiecutter.project_slug}}/infrastructures/cache/redis_client.py)
  • Orphaned file ({{cookiecutter.project_slug}}{{cookiecutter.project_slug}}/infrastructures/db/mappers/artifact_db_mapper.py)
  • Orphaned file ({{cookiecutter.project_slug}}{{cookiecutter.project_slug}}/infrastructures/db/models/artifact.py)
  • Orphaned file ({{cookiecutter.project_slug}}{{cookiecutter.project_slug}}/infrastructures/db/repositories/artifact.py)
  • Orphaned file ({{cookiecutter.project_slug}}{{cookiecutter.project_slug}}/infrastructures/http/clients.py)
  • Orphaned file ({{cookiecutter.project_slug}}{{cookiecutter.project_slug}}/infrastructures/mappers/artifact.py)
  • Orphaned file ({{cookiecutter.project_slug}}{{cookiecutter.project_slug}}/presentation/api/rest/error_handling.py)
  • TodoComment ({{cookiecutter.project_slug}}{{cookiecutter.project_slug}}/presentation/api/rest/middlewares.py)

New (12)

  • Orphaned file ({{cookiecutter.project_slug}}{{cookiecutter.project_slug}}/application/mappers.py)
  • Orphaned file ({{cookiecutter.project_slug}}{{cookiecutter.project_slug}}/application/use_cases/process_artifact.py)
  • Orphaned file ({{cookiecutter.project_slug}}{{cookiecutter.project_slug}}/config/ioc/providers.py)
  • Orphaned file ({{cookiecutter.project_slug}}{{cookiecutter.project_slug}}/config/settings.py)
  • Orphaned file ({{cookiecutter.project_slug}}{{cookiecutter.project_slug}}/infrastructures/cache/redis_client.py)
  • Orphaned file ({{cookiecutter.project_slug}}{{cookiecutter.project_slug}}/infrastructures/db/mappers/artifact_db_mapper.py)
  • Orphaned file ({{cookiecutter.project_slug}}{{cookiecutter.project_slug}}/infrastructures/db/models/artifact.py)
  • Orphaned file ({{cookiecutter.project_slug}}{{cookiecutter.project_slug}}/infrastructures/db/repositories/artifact.py)
  • Orphaned file ({{cookiecutter.project_slug}}{{cookiecutter.project_slug}}/infrastructures/http/clients.py)
  • Orphaned file ({{cookiecutter.project_slug}}{{cookiecutter.project_slug}}/infrastructures/mappers/artifact.py)
  • Orphaned file ({{cookiecutter.project_slug}}{{cookiecutter.project_slug}}/presentation/api/rest/error_handling.py)
  • TodoComment ({{cookiecutter.project_slug}}{{cookiecutter.project_slug}}/presentation/api/rest/middlewares.py)

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

Peopl3s/clean-architecture-litestar-project-template was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 9 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit b80d37c985653f843cd67d3ad0ada9b36a1b2911 — the exact code this score is about.
  • Scored under rubric-2026.11.2 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.3+preprod-bb0cb800cd0f.