---
title: Shortlist
emoji: 🎯
colorFrom: blue
colorTo: purple
sdk: docker
app_port: 7860
pinned: false
---

# Shortlist — AI-Powered Portfolio Architect API

Backend API for Shortlist — an AI agent system that reverse-engineers what recruiters look for, then helps you build exactly that.

## Endpoints

| Endpoint | Description |
|---|---|
| `GET /health` | Health check |
| `GET /health/deep` | Deep health check (DB + LLM) |
| `GET /docs` | Swagger UI |
| `POST /api/v1/jd/analyze` | JD Analysis |
| `POST /api/v1/capstone/generate` | Capstone Project Generator |
| `POST /api/v1/repo/analyze` | GitHub Repo Analyzer |
| `POST /api/v1/scaffold/generate` | Scaffold Generator |
| `POST /api/v1/portfolio/optimize` | Portfolio Optimizer |
| `POST /api/v1/fitness/score` | Resume Fitness Scorer |

## Tech Stack

- **FastAPI** + Pydantic v2
- **LangGraph** + langchain-groq (Llama 3.3 70B)
- **Supabase** (PostgreSQL + Auth + RLS)