kaapi-guardrails

A repo for our experiments with Guardrails so can be integrated with Kaapi

Kaapi Guardrails

Pre-requisites

• docker Docker
• uv for Python package and environment management.

Project Setup

You can just fork or clone this repository and use it as is.

✨ It just works. ✨

Configure

Create env file using example file

cp .env.example .env

You can then update configs in the .env files to customize your configurations.

⚠️ Some services depend on these environment variables being set correctly. Missing or invalid values may cause startup issues.

Bootstrap & development mode

You have two options to start this dockerized setup, depending on whether you want to reset the database:

Option A: Run migrations & seed data (will reset DB)

Use the prestart profile to automatically run database migrations and seed data. This profile also resets the database, so use it only when you want a fresh start.

docker compose --profile prestart up

Option B: Start normally without resetting DB

If you don't want to reset the database, start the project directly:

docker compose watch

This will start all services in watch mode for development — ideal for local iterations.

Rebuilding Images

docker compose up --build -d

This is also necessary when:

• Dependencies change in pyproject.toml or uv.lock
• You modify Dockerfile configurations
• Changes aren't being reflected in the running containers

Backend Development

Backend docs: backend/README.md.

Deployment

Deployment docs: deployment.md.

Development

General development docs: development.md.

This includes using Docker Compose, custom local domains, .env configurations, etc.

Release Notes

Check the file release-notes.md.

Credits

This project was created using full-stack-fastapi-template. A big thank you to the team for creating and maintaining the template!!!