Influxion is a FastAPI-based microservice for generating PDFs from structured JSON data and HTML/CSS templates.

Contents:

• Installation / Deployment
  • Prerequisites
  • Direct on Ubuntu (Supervisor + NGINX)
  • Local with Docker Compose
  • Local Kubernetes (minikube)
  • Azure Kubernetes Service (AKS)
• Generate PDF Job
  • Authentication
  • Create a job
  • Check job status
  • Download PDF
  • Using Celery background workers (Optional)
• Digital Signatures
  • Configuration
• PDF Standards
• Fonts
  • Including Fonts
  • Font Families Included
• Examples
  • Python example
  • Bash example
  • PowerShell example
• Environment Variables
• Kubernetes Helm Chart Structure
  • 1. Chart scaffold
  • 2. Helpers
  • 3. Vault secret
  • 4. Postgres StatefulSet & Service
  • 5. RabbitMQ Deployment & Service
  • 6. Influxion “app” Deployment & Service
  • 7. Ingress Configuration
  • 8. Influxion “worker” Deployment
  • How it dovetails with deploy_to_aks.ps1
• Azure Active Directory and Key Vault Configuration
  • Register the Influxion API application
  • Define API permissions (scopes)
  • Register the Influxion client application
  • Configure environment variables
  • Enable managed identity and grant Key Vault access
  • Authentication flow
• License
  • MIT License
  • Notice
  • Third-Party Licenses
• Ideas

To try it out, check the Swagger UI or the examples in the examples section.

Features

• Accepts JSON input

• OAuth2 authentication through Entra ID.

• Supports optional custom HTML (Jinja2) and CSS templates

• Supports optional PDF standards (e.g., PDF/A, PDF/UA)

• Supports optional digital signing with Azure Key Vault certificate

• Query job status via /pdf/{job_id}

• Download generated PDF via /pdf/{job_id}/download

• Optional Celery worker for background PDF generation (configure via INFLUXION_USE_CELERY, INFLUXION_CELERY_BROKER_URL, and INFLUXION_CELERY_RESULT_BACKEND)

It uses:

• FastAPI for the API framework,

• Jinja2 for templating,

• Pydantic for data validation,

• WeasyPrint for PDF rendering and supports optional custom templates,

• PyHanko for digital signing of documents with certificates stored in Azure Key Vault.

• Azure Key Vault for secure certificate management.

• Celery for background task processing (optional).