Papyrus server

REST API server for Papyrus, a cross platform book management application.

Getting started

Install dependencies:

uv sync --extra dev

Run the database:

docker compose up -d database mailpit

Run database migrations:

uv run alembic upgrade head

Run the server:

uv run uvicorn papyrus.main:app --reload --port 8080

Generate local PowerSync keys for auth testing:

./scripts/generate_dev_powersync_keys.sh

Development

Run tests:

uv run pytest --cov --cov-report html

Auth Testing

Local auth testing supports Mailpit for SMTP capture, a dev auth sandbox at /__dev/auth-sandbox, and opt-in provider smoke tests.

See docs/auth-testing.md for the exact .env values, Google OAuth setup, and end-to-end test workflow.

For Flutter client integration guidance, see docs/flutter-auth-integration.md.