Getting Started

Introduction

HyperSaaS is a production-ready SaaS boilerplate built with Django and Next.js. It includes authentication, multi-tenancy, subscription billing, AI-powered chat, and more — so you can focus on building your product.

Quick Start

Prerequisites

• Python 3.12 (Docling doesn't support 3.13 yet)
• Node.js 20.9+
• PostgreSQL with pgvector
• Redis

Installation

# Clone the repository
git clone https://github.com/hypersaas/hypersaas.git

# Backend setup
cd backend
pip install -r requirements/local.txt
python manage.py migrate
python manage.py runserver

# Frontend setup
cd frontend
pnpm install
pnpm dev

What's Included

• Authentication — Email/password sign-up with activation, two-factor sign-in with an authenticator app or emailed codes, and short-lived tokens tied to each sign-in
• Multi-Tenancy — Workspaces and teams with owner, admin and member roles; people join by invitations that expire after 7 days
• Plans & Billing — Free, Pro, Team and Business plans defined in code, synced to Stripe, with trials and a billing portal
• AI Credit — Every AI call priced and counted against the workspace's credit
• AI Chat — Streaming replies, attachments, edit and regenerate, on a LangGraph agent behind a pluggable handler interface
• Knowledge Base — Hybrid RAG with query rewriting and reranking over pgvector, with cited answers
• Evaluation — Commands to benchmark retrieval and answers, on Open RAG Bench or your own documents
• Admin Panel — Django admin with custom views