{"id":21327,"library":"fastapi-sessions","title":"FastAPI Sessions","description":"A ready-to-use session library for FastAPI, providing customizable frontends, verifiers, and backends. Current version 0.3.2, released 2023 as maintenance mode; no active development.","status":"maintenance","version":"0.3.2","language":"python","source_language":"en","source_url":"https://github.com/jordanisaacs/fastapi-sessions","tags":["fastapi","sessions","authentication","session-management"],"install":[{"cmd":"pip install fastapi-sessions","lang":"bash","label":"default"}],"dependencies":[{"reason":"Required dependency for the library to work.","package":"fastapi","optional":false},{"reason":"For data validation and model definitions.","package":"pydantic","optional":false},{"reason":"For session signing and verification.","package":"itsdangerous","optional":false}],"imports":[{"wrong":"from fastapi_sessions import SessionManager","symbol":"SessionManager","correct":"from fastapi_sessions import SessionManager"}],"quickstart":{"code":"from fastapi import FastAPI, HTTPException\nfrom fastapi_sessions import SessionManager\nfrom fastapi_sessions.backends.in_memory import InMemoryBackend\nfrom fastapi_sessions.frontends import SessionFrontend\n\napp = FastAPI()\nbackend = InMemoryBackend()\nfrontend = SessionFrontend(secret_key=\"my-secret-key\")\nmanager = SessionManager(backend=backend, frontend=frontend)\n\n@app.post(\"/login\")\nasync def login(username: str):\n    session_id = await manager.create_session(data={\"user\": username})\n    return {\"session_id\": session_id}\n\n@app.get(\"/me\")\nasync def get_me(session_id: str):\n    session = await manager.get_session(session_id)\n    if not session:\n        raise HTTPException(status_code=401, detail=\"Invalid session\")\n    return session.data","lang":"python","description":"Minimal example: create a session on login, retrieve it on a protected endpoint."},"warnings":[{"fix":"Migrate to Starlette's SessionMiddleware from starlette.middleware.sessions.","message":"Library is in maintenance mode; no active development or bug fixes are expected. Consider alternatives like session-based auth with Starlette's built-in session middleware.","severity":"deprecated","affected_versions":">= 0.3.0, < 0.4.0"},{"fix":"Configure a production-ready backend: `from fastapi_sessions.backends.redis import RedisBackend` and provide a Redis connection.","message":"The default in-memory backend is not suitable for production; sessions are lost on server restart. Use a persistent backend like RedisBackend (from fastapi_sessions.backends.redis).","severity":"gotcha","affected_versions":"all"},{"fix":"Adjust imports and instantiation to include a frontend and verifier as per the new documentation.","message":"Version 0.3.0 introduced a breaking rewrite: the API changed from a single SessionManager to customizable Frontend and Verifier components. Older code using SessionManager directly without frontends will break.","severity":"breaking","affected_versions":"upgrading from <0.3.0 to >=0.3.0"}],"env_vars":null,"search_vec":"'0.3.2':20 '2023':22 'activ':27 'authent':31 'backend':17 'current':18 'customiz':13 'develop':28 'fastapi':1,11,29 'frontend':14 'librari':9 'mainten':24 'manag':34 'mode':25 'provid':12 'readi':5 'ready-to-us':4 'releas':21 'session':2,8,30,33 'session-manag':32 'use':7 'verifi':15 'version':19","created_at":"2026-04-27T16:59:19.086453+00:00","updated_at":"2026-04-27T16:59:19.086453+00:00","problems":{"verify_error":"Traceback (most recent call last):\n  File \"<string>\", line 1, in <module>\nImportError: cannot import name 'SessionManager' from 'fastapi_sessions' (/tmp/tmpqq5syb2f/venv/lib/python3.12/site-packages/fastapi_sessions/__init__.py)"},"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"0.3.2","cli_name":"","cli_version":null,"type":"library","homepage":null,"github":"https://github.com/jordanisaacs/fastapi-sessions","docs":"https://jordanisaacs.github.io/fastapi-sessions/","changelog":null,"pypi":"https://pypi.org/project/fastapi-sessions/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["web-framework","auth-security"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"import_fail","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-07-10","install_tag":null}}