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 is in preparation.

See the integrations documentation for detailed setup instructions.

Install both official adapters through the core package extras:

pip install "userharbor[sqlalchemy,smtp]"

Or install only the adapter you need:

pip install userharbor-sqlalchemy
pip install userharbor-smtp

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.

The FastAPI integration is currently in preparation.

Both adapters can be replaced with custom implementations as long as they match the core protocols.

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