🔐 PalStack Auth Module

A complete, modular authentication system for FastAPI applications with smart network-aware access control.

Features

• 🌐 Smart Mode - Open at home, secure away
• 🔑 API Keys - Long-lived tokens for services
• 👤 User Accounts - Sessions with bcrypt passwords
• 📧 Email Integration - Password reset and invitations
• 🎨 Beautiful UI - React and React Native components included

Quick Start

# Install backend
pip install -r backend/requirements.txt

# Copy files to your project
cp backend/* your-project/app/

# Add to your main.py
from .auth import get_current_auth

See INTEGRATION_GUIDE.md for complete setup instructions.

Authentication Modes

Mode	Use Case	Home Access	External Access
smart	Home servers	✅ Open	🔐 Login
none	Single user	✅ Open	✅ Open
api_key_only	API-first	🔑 Key	🔑 Key
full	Max security	🔐 Login	🔐 Login

Documentation

• INTEGRATION_GUIDE.md - Step-by-step setup
• API_REFERENCE.md - Complete API docs
• SECURITY.md - Security best practices

License

MIT License - See LICENSE file

Part of PalStack

"That's what pals do – they show up and help with the everyday stuff."

Built for self-hosted applications that respect your privacy.