Integrations¶

UserHarbor core does not include database or email-provider implementations. Those responsibilities are handled by adapters that implement the core UserStore and EmailSender protocols.

Official integrations:

• userharbor-sqlalchemy provides a SQLAlchemy-based UserStore
• userharbor-smtp provides an SMTP-based EmailSender
• userharbor-fastapi provides FastAPI routes and dependency helpers

See the integrations documentation for detailed setup instructions.

Install the official adapters through the core package extras:

pip install "userharbor[sqlalchemy,smtp,fastapi]"

Or install only the adapter you need:

pip install userharbor-sqlalchemy
pip install userharbor-smtp
pip install userharbor-fastapi

The FastAPI adapter can also be installed through its dedicated core extra:

pip install "userharbor[fastapi]"

When to use each adapter¶

Use userharbor-sqlalchemy when your application already uses SQLAlchemy or when you want UserHarbor data stored in a relational database.

Use userharbor-smtp when your email provider exposes SMTP credentials and you want a simple email sender without provider-specific SDKs.

Use userharbor-fastapi when your application uses FastAPI and you want ready-to-use account routes, bearer-session authentication, and dependency helpers for current users, roles, and permissions.

All adapters can be replaced with custom implementations as long as they match the core protocols or compose a configured UserHarbor instance.

See Custom integrations for guidance on building your own storage, email, framework, or provider adapter.