AI ITSM - Python Service Desk Platform

A production-ready, multi-tenant IT Service Management (ITSM) platform built for teams that need ServiceNow-style ticketing without the enterprise price tag. Includes AI-powered ticket categorization and priority triage, SLA tracking with automated escalation, a searchable knowledge base with AI-matched article suggestions, a full agent dashboard, an admin panel for multi-tenant management, and built-in reporting.

Built on a modern, scalable stack: Next.js + TypeScript frontend, FastAPI backend, PostgreSQL database, Redis/Celery for background jobs, and JWT-based authentication. Fully containerized with Docker for easy deployment.

Ideal for developers looking to launch their own IT service desk product, agencies offering white-label ITSM to clients, or businesses wanting a self-hosted alternative to expensive enterprise tools.

Live demo available - try the full ticket lifecycle, AI triage, and SLA tracking yourself.

Features

• Multi-tenant architecture (isolated data per organization)
• AI-powered ticket auto-categorization and priority triage
• SLA tracking with automated alerts/escalation
• Knowledge base with AI-matched article suggestions
• Agent dashboard for ticket management
• Admin panel for tenant and user management
• Reporting and analytics
• JWT authentication with role-based access
• Dockerized for easy deployment

Requirements

• Node.js (for Next.js frontend)
• Python 3.10+ (for FastAPI backend)
• PostgreSQL database
• Redis (for Celery background tasks)
• Docker (recommended for deployment)

Instructions

Prerequisites

• Docker Desktop (Windows/macOS) or Docker Engine with Compose v2 (Linux)
• ~8 GB RAM recommended
• Ports 3000 (UI) and 8000 (API) free

Setup

1. Copy the example environment file: cp .env.example .env (Windows PowerShell: Copy-Item .env.example .env)
2. Open .env - optionally add your own GROQ_API_KEY for AI-powered triage (leave blank to use the built-in local heuristic instead). Change JWT_SECRET before any real deployment.
3. Run: docker compose up --build
4. Wait until the backend and frontend containers are healthy.

Access

• App:
• API docs:

Demo login (auto-seeded on first boot, workspace: acme, password for all: DemoPass123!)

• Admin: admin@acme.example
• Agent: agent@acme.example
• End user: user@acme.example

To create your own workspace instead, sign up at /signup as the first admin.

Modules included: Incidents, Problems, Changes, Assets, Knowledge Base, SLA, Self-Service Portal, Dashboards & Reports

Full setup notes and a click-through demo guide are included in docs/SETUP.md and docs/DEMO.md.