refac: modernize type annotations (PEP 604 / PEP 585)

backend/open_webui/migrations/env.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 """Alembic environment configuration.
 
 Configures the migration context for both offline (SQL script generation)
@@ -23,7 +25,7 @@ if config.config_file_name is not None:
     fileConfig(config.config_file_name, disable_existing_loggers=False)
 
 # Re-apply JSON formatter after fileConfig replaces handlers.
-if LOG_FORMAT == "json":
+if LOG_FORMAT == 'json':
     from open_webui.env import JSONFormatter
 
     for handler in logging.root.handlers:
@@ -41,7 +43,7 @@ if _ssl_params:
     DB_URL = reattach_ssl_params_to_url(_url_no_ssl, _ssl_params)
 
 if DB_URL:
-    config.set_main_option("sqlalchemy.url", DB_URL.replace("%", "%%"))
+    config.set_main_option('sqlalchemy.url', DB_URL.replace('%', '%%'))
 
 
 # ── Migration runners ────────────────────────────────────────────────────────
@@ -49,12 +51,12 @@ if DB_URL:
 
 def run_migrations_offline() -> None:
     """Generate SQL script without a live database connection."""
-    url = config.get_main_option("sqlalchemy.url")
+    url = config.get_main_option('sqlalchemy.url')
     context.configure(
         url=url,
         target_metadata=target_metadata,
         literal_binds=True,
-        dialect_opts={"paramstyle": "named"},
+        dialect_opts={'paramstyle': 'named'},
     )
     with context.begin_transaction():
         context.run_migrations()
@@ -62,14 +64,12 @@ def run_migrations_offline() -> None:
 
 def _build_connectable():
     """Create the appropriate SQLAlchemy engine for the configured DB URL."""
-    if DB_URL and DB_URL.startswith("sqlite+sqlcipher://"):
-        if not DATABASE_PASSWORD or DATABASE_PASSWORD.strip() == "":
-            raise ValueError(
-                "DATABASE_PASSWORD is required when using sqlite+sqlcipher:// URLs"
-            )
+    if DB_URL and DB_URL.startswith('sqlite+sqlcipher://'):
+        if not DATABASE_PASSWORD or DATABASE_PASSWORD.strip() == '':
+            raise ValueError('DATABASE_PASSWORD is required when using sqlite+sqlcipher:// URLs')
 
-        db_path = DB_URL.replace("sqlite+sqlcipher://", "")
-        if db_path.startswith("/"):
+        db_path = DB_URL.replace('sqlite+sqlcipher://', '')
+        if db_path.startswith('/'):
             db_path = db_path[1:]
 
         def _sqlcipher_creator():
@@ -79,11 +79,11 @@ def _build_connectable():
             conn.execute(f"PRAGMA key = '{DATABASE_PASSWORD}'")
             return conn
 
-        return create_engine("sqlite://", creator=_sqlcipher_creator, echo=False)
+        return create_engine('sqlite://', creator=_sqlcipher_creator, echo=False)
 
     return engine_from_config(
         config.get_section(config.config_ini_section, {}),
-        prefix="sqlalchemy.",
+        prefix='sqlalchemy.',
         poolclass=pool.NullPool,
     )
 

backend/open_webui/migrations/util.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 """Alembic migration utilities."""
 
 from alembic import op

backend/open_webui/migrations/versions/018012973d35_add_indexes.py

@@ -6,8 +6,8 @@ Create Date: 2025-08-13 03:00:00.000000
 
 """
 
-from alembic import op
 import sqlalchemy as sa
+from alembic import op
 
 revision = '018012973d35'
 down_revision = 'd31026856c01'

backend/open_webui/migrations/versions/1af9b942657b_migrate_tags.py

@@ -6,13 +6,13 @@ Create Date: 2024-10-09 21:02:35.241684
 
 """
 
-from alembic import op
-import sqlalchemy as sa
-from sqlalchemy.sql import table, select, update, column
-from sqlalchemy.engine.reflection import Inspector
-
 import json
 
+import sqlalchemy as sa
+from alembic import op
+from sqlalchemy.engine.reflection import Inspector
+from sqlalchemy.sql import column, select, table, update
+
 revision = '1af9b942657b'
 down_revision = '242a2047eae0'
 branch_labels = None

backend/open_webui/migrations/versions/242a2047eae0_update_chat_table.py

@@ -6,12 +6,12 @@ Create Date: 2024-10-09 21:02:35.241684
 
 """
 
-from alembic import op
-import sqlalchemy as sa
-from sqlalchemy.sql import table, select, update
-
 import json
 
+import sqlalchemy as sa
+from alembic import op
+from sqlalchemy.sql import select, table, update
+
 revision = '242a2047eae0'
 down_revision = '6a39f3d8e55c'
 branch_labels = None

backend/open_webui/migrations/versions/2f1211949ecc_update_message_and_channel_member_table.py

@@ -8,9 +8,9 @@ Create Date: 2025-11-27 03:07:56.200231
 
 from typing import Sequence, Union
 
-from alembic import op
-import sqlalchemy as sa
 import open_webui.internal.db
+import sqlalchemy as sa
+from alembic import op
 
 # revision identifiers, used by Alembic.
 revision: str = '2f1211949ecc'

backend/open_webui/migrations/versions/374d2f66af06_add_prompt_history_table.py

@@ -6,11 +6,11 @@ Create Date: 2026-01-23 17:15:00.000000
 
 """
 
-from typing import Sequence, Union
 import uuid
+from typing import Sequence, Union
 
-from alembic import op
 import sqlalchemy as sa
+from alembic import op
 
 revision: str = '374d2f66af06'
 down_revision: Union[str, None] = 'c440947495f3'

backend/open_webui/migrations/versions/3781e22d8b01_update_message_table.py

@@ -6,8 +6,8 @@ Create Date: 2024-12-30 03:00:00.000000
 
 """
 
-from alembic import op
 import sqlalchemy as sa
+from alembic import op
 
 revision = '3781e22d8b01'
 down_revision = '7826ab40b532'

backend/open_webui/migrations/versions/37f288994c47_add_group_member_table.py

@@ -6,13 +6,13 @@ Create Date: 2025-11-17 03:45:25.123939
 
 """
 
-import uuid
-import time
 import json
+import time
+import uuid
 from typing import Sequence, Union
 
-from alembic import op
 import sqlalchemy as sa
+from alembic import op
 
 # revision identifiers, used by Alembic.
 revision: str = '37f288994c47'

backend/open_webui/migrations/versions/38d63c18f30f_add_oauth_session_table.py

@@ -8,8 +8,8 @@ Create Date: 2025-09-08 14:19:59.583921
 
 from typing import Sequence, Union
 
-from alembic import op
 import sqlalchemy as sa
+from alembic import op
 
 # revision identifiers, used by Alembic.
 revision: str = '38d63c18f30f'

backend/open_webui/migrations/versions/3ab32c4b8f59_update_tags.py

@@ -6,13 +6,13 @@ Create Date: 2024-10-09 21:02:35.241684
 
 """
 
-from alembic import op
-import sqlalchemy as sa
-from sqlalchemy.sql import table, select, update, column
-from sqlalchemy.engine.reflection import Inspector
-
 import json
 
+import sqlalchemy as sa
+from alembic import op
+from sqlalchemy.engine.reflection import Inspector
+from sqlalchemy.sql import column, select, table, update
+
 revision = '3ab32c4b8f59'
 down_revision = '1af9b942657b'
 branch_labels = None

backend/open_webui/migrations/versions/3af16a1c9fb6_update_user_table.py

@@ -8,8 +8,8 @@ Create Date: 2025-08-21 02:07:18.078283
 
 from typing import Sequence, Union
 
-from alembic import op
 import sqlalchemy as sa
+from alembic import op
 
 # revision identifiers, used by Alembic.
 revision: str = '3af16a1c9fb6'

backend/open_webui/migrations/versions/3e0e00844bb0_add_knowledge_file_table.py

@@ -6,16 +6,15 @@ Create Date: 2025-12-02 06:54:19.401334
 
 """
 
+import json
+import time
+import uuid
 from typing import Sequence, Union
 
-from alembic import op
-import sqlalchemy as sa
-from sqlalchemy import inspect
 import open_webui.internal.db
-
-import time
-import json
-import uuid
+import sqlalchemy as sa
+from alembic import op
+from sqlalchemy import inspect
 
 # revision identifiers, used by Alembic.
 revision: str = '3e0e00844bb0'

backend/open_webui/migrations/versions/4ace53fd72c8_update_folder_table_datetime.py

@@ -6,8 +6,8 @@ Create Date: 2024-10-23 03:00:00.000000
 
 """
 
-from alembic import op
 import sqlalchemy as sa
+from alembic import op
 
 revision = '4ace53fd72c8'
 down_revision = 'af906e964978'

backend/open_webui/migrations/versions/4de81c2a3af1_add_pinned_note_table.py

@@ -8,10 +8,9 @@ Create Date: 2026-05-09 04:29:27.651341
 
 from typing import Sequence, Union
 
-from alembic import op
-import sqlalchemy as sa
 import open_webui.internal.db
-
+import sqlalchemy as sa
+from alembic import op
 
 # revision identifiers, used by Alembic.
 revision: str = '4de81c2a3af1'
@@ -20,10 +19,11 @@ branch_labels: Union[str, Sequence[str], None] = None
 depends_on: Union[str, Sequence[str], None] = None
 
 
-import uuid
 import time
-from sqlalchemy import select, update, insert
-from sqlalchemy.sql import table, column
+import uuid
+
+from sqlalchemy import insert, select, update
+from sqlalchemy.sql import column, table
 
 
 def upgrade() -> None:

backend/open_webui/migrations/versions/56359461a091_add_calendar_tables.py

@@ -8,9 +8,8 @@ Create Date: 2026-04-19 16:20:58.162045
 
 from typing import Sequence, Union
 
-from alembic import op
 import sqlalchemy as sa
-
+from alembic import op
 
 # revision identifiers, used by Alembic.
 revision: str = '56359461a091'

backend/open_webui/migrations/versions/57c599a3cb57_add_channel_table.py

@@ -6,8 +6,8 @@ Create Date: 2024-12-22 03:00:00.000000
 
 """
 
-from alembic import op
 import sqlalchemy as sa
+from alembic import op
 
 revision = '57c599a3cb57'
 down_revision = '922e7a387820'

backend/open_webui/migrations/versions/6283dc0e4d8d_add_channel_file_table.py

@@ -8,9 +8,9 @@ Create Date: 2025-12-10 15:11:39.424601
 
 from typing import Sequence, Union
 
-from alembic import op
-import sqlalchemy as sa
 import open_webui.internal.db
+import sqlalchemy as sa
+from alembic import op
 
 # revision identifiers, used by Alembic.
 revision: str = '6283dc0e4d8d'

backend/open_webui/migrations/versions/6a39f3d8e55c_add_knowledge_table.py

@@ -6,11 +6,12 @@ Create Date: 2024-10-01 14:02:35.241684
 
 """
 
-from alembic import op
-import sqlalchemy as sa
-from sqlalchemy.sql import table, column, select
 import json
 
+import sqlalchemy as sa
+from alembic import op
+from sqlalchemy.sql import column, select, table
+
 revision = '6a39f3d8e55c'
 down_revision = 'c0fbf31ca0db'
 branch_labels = None

backend/open_webui/migrations/versions/7826ab40b532_update_file_table.py

@@ -6,8 +6,8 @@ Create Date: 2024-12-23 03:00:00.000000
 
 """
 
-from alembic import op
 import sqlalchemy as sa
+from alembic import op
 
 revision = '7826ab40b532'
 down_revision = '57c599a3cb57'

backend/open_webui/migrations/versions/7e5b5dc7342b_init.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 """Initial Alembic schema — creates all base tables.
 
 Revision ID: 7e5b5dc7342b
@@ -7,14 +9,13 @@ Create Date: 2024-06-24 13:15:33.808998
 
 from typing import Sequence, Union
 
+import open_webui.internal.db  # noqa: F401
 import sqlalchemy as sa
 from alembic import op
-
-import open_webui.internal.db  # noqa: F401
 from open_webui.internal.db import JSONField
 from open_webui.migrations.util import get_existing_tables
 
-revision: str = "7e5b5dc7342b"
+revision: str = '7e5b5dc7342b'
 down_revision: Union[str, None] = None
 branch_labels: Union[str, Sequence[str], None] = None
 depends_on: Union[str, Sequence[str], None] = None
@@ -25,162 +26,162 @@ depends_on: Union[str, Sequence[str], None] = None
 
 _TABLES: list[tuple[str, list[sa.Column], list]] = [
     (
-        "auth",
+        'auth',
         [
-            sa.Column("id", sa.String(), nullable=False),
-            sa.Column("email", sa.String(), nullable=True),
-            sa.Column("password", sa.Text(), nullable=True),
-            sa.Column("active", sa.Boolean(), nullable=True),
+            sa.Column('id', sa.String(), nullable=False),
+            sa.Column('email', sa.String(), nullable=True),
+            sa.Column('password', sa.Text(), nullable=True),
+            sa.Column('active', sa.Boolean(), nullable=True),
         ],
-        [sa.PrimaryKeyConstraint("id")],
+        [sa.PrimaryKeyConstraint('id')],
     ),
     (
-        "chat",
+        'chat',
         [
-            sa.Column("id", sa.String(), nullable=False),
-            sa.Column("user_id", sa.String(), nullable=True),
-            sa.Column("title", sa.Text(), nullable=True),
-            sa.Column("chat", sa.Text(), nullable=True),
-            sa.Column("created_at", sa.BigInteger(), nullable=True),
-            sa.Column("updated_at", sa.BigInteger(), nullable=True),
-            sa.Column("share_id", sa.Text(), nullable=True),
-            sa.Column("archived", sa.Boolean(), nullable=True),
+            sa.Column('id', sa.String(), nullable=False),
+            sa.Column('user_id', sa.String(), nullable=True),
+            sa.Column('title', sa.Text(), nullable=True),
+            sa.Column('chat', sa.Text(), nullable=True),
+            sa.Column('created_at', sa.BigInteger(), nullable=True),
+            sa.Column('updated_at', sa.BigInteger(), nullable=True),
+            sa.Column('share_id', sa.Text(), nullable=True),
+            sa.Column('archived', sa.Boolean(), nullable=True),
         ],
-        [sa.PrimaryKeyConstraint("id"), sa.UniqueConstraint("share_id")],
+        [sa.PrimaryKeyConstraint('id'), sa.UniqueConstraint('share_id')],
     ),
     (
-        "chatidtag",
+        'chatidtag',
         [
-            sa.Column("id", sa.String(), nullable=False),
-            sa.Column("tag_name", sa.String(), nullable=True),
-            sa.Column("chat_id", sa.String(), nullable=True),
-            sa.Column("user_id", sa.String(), nullable=True),
-            sa.Column("timestamp", sa.BigInteger(), nullable=True),
+            sa.Column('id', sa.String(), nullable=False),
+            sa.Column('tag_name', sa.String(), nullable=True),
+            sa.Column('chat_id', sa.String(), nullable=True),
+            sa.Column('user_id', sa.String(), nullable=True),
+            sa.Column('timestamp', sa.BigInteger(), nullable=True),
         ],
-        [sa.PrimaryKeyConstraint("id")],
+        [sa.PrimaryKeyConstraint('id')],
     ),
     (
-        "document",
+        'document',
         [
-            sa.Column("collection_name", sa.String(), nullable=False),
-            sa.Column("name", sa.String(), nullable=True),
-            sa.Column("title", sa.Text(), nullable=True),
-            sa.Column("filename", sa.Text(), nullable=True),
-            sa.Column("content", sa.Text(), nullable=True),
-            sa.Column("user_id", sa.String(), nullable=True),
-            sa.Column("timestamp", sa.BigInteger(), nullable=True),
+            sa.Column('collection_name', sa.String(), nullable=False),
+            sa.Column('name', sa.String(), nullable=True),
+            sa.Column('title', sa.Text(), nullable=True),
+            sa.Column('filename', sa.Text(), nullable=True),
+            sa.Column('content', sa.Text(), nullable=True),
+            sa.Column('user_id', sa.String(), nullable=True),
+            sa.Column('timestamp', sa.BigInteger(), nullable=True),
         ],
-        [sa.PrimaryKeyConstraint("collection_name"), sa.UniqueConstraint("name")],
+        [sa.PrimaryKeyConstraint('collection_name'), sa.UniqueConstraint('name')],
     ),
     (
-        "file",
+        'file',
         [
-            sa.Column("id", sa.String(), nullable=False),
-            sa.Column("user_id", sa.String(), nullable=True),
-            sa.Column("filename", sa.Text(), nullable=True),
-            sa.Column("meta", JSONField(), nullable=True),
-            sa.Column("created_at", sa.BigInteger(), nullable=True),
+            sa.Column('id', sa.String(), nullable=False),
+            sa.Column('user_id', sa.String(), nullable=True),
+            sa.Column('filename', sa.Text(), nullable=True),
+            sa.Column('meta', JSONField(), nullable=True),
+            sa.Column('created_at', sa.BigInteger(), nullable=True),
         ],
-        [sa.PrimaryKeyConstraint("id")],
+        [sa.PrimaryKeyConstraint('id')],
     ),
     (
-        "function",
+        'function',
         [
-            sa.Column("id", sa.String(), nullable=False),
-            sa.Column("user_id", sa.String(), nullable=True),
-            sa.Column("name", sa.Text(), nullable=True),
-            sa.Column("type", sa.Text(), nullable=True),
-            sa.Column("content", sa.Text(), nullable=True),
-            sa.Column("meta", JSONField(), nullable=True),
-            sa.Column("valves", JSONField(), nullable=True),
-            sa.Column("is_active", sa.Boolean(), nullable=True),
-            sa.Column("is_global", sa.Boolean(), nullable=True),
-            sa.Column("updated_at", sa.BigInteger(), nullable=True),
-            sa.Column("created_at", sa.BigInteger(), nullable=True),
+            sa.Column('id', sa.String(), nullable=False),
+            sa.Column('user_id', sa.String(), nullable=True),
+            sa.Column('name', sa.Text(), nullable=True),
+            sa.Column('type', sa.Text(), nullable=True),
+            sa.Column('content', sa.Text(), nullable=True),
+            sa.Column('meta', JSONField(), nullable=True),
+            sa.Column('valves', JSONField(), nullable=True),
+            sa.Column('is_active', sa.Boolean(), nullable=True),
+            sa.Column('is_global', sa.Boolean(), nullable=True),
+            sa.Column('updated_at', sa.BigInteger(), nullable=True),
+            sa.Column('created_at', sa.BigInteger(), nullable=True),
         ],
-        [sa.PrimaryKeyConstraint("id")],
+        [sa.PrimaryKeyConstraint('id')],
     ),
     (
-        "memory",
+        'memory',
         [
-            sa.Column("id", sa.String(), nullable=False),
-            sa.Column("user_id", sa.String(), nullable=True),
-            sa.Column("content", sa.Text(), nullable=True),
-            sa.Column("updated_at", sa.BigInteger(), nullable=True),
-            sa.Column("created_at", sa.BigInteger(), nullable=True),
+            sa.Column('id', sa.String(), nullable=False),
+            sa.Column('user_id', sa.String(), nullable=True),
+            sa.Column('content', sa.Text(), nullable=True),
+            sa.Column('updated_at', sa.BigInteger(), nullable=True),
+            sa.Column('created_at', sa.BigInteger(), nullable=True),
         ],
-        [sa.PrimaryKeyConstraint("id")],
+        [sa.PrimaryKeyConstraint('id')],
     ),
     (
-        "model",
+        'model',
         [
-            sa.Column("id", sa.Text(), nullable=False),
-            sa.Column("user_id", sa.Text(), nullable=True),
-            sa.Column("base_model_id", sa.Text(), nullable=True),
-            sa.Column("name", sa.Text(), nullable=True),
-            sa.Column("params", JSONField(), nullable=True),
-            sa.Column("meta", JSONField(), nullable=True),
-            sa.Column("updated_at", sa.BigInteger(), nullable=True),
-            sa.Column("created_at", sa.BigInteger(), nullable=True),
+            sa.Column('id', sa.Text(), nullable=False),
+            sa.Column('user_id', sa.Text(), nullable=True),
+            sa.Column('base_model_id', sa.Text(), nullable=True),
+            sa.Column('name', sa.Text(), nullable=True),
+            sa.Column('params', JSONField(), nullable=True),
+            sa.Column('meta', JSONField(), nullable=True),
+            sa.Column('updated_at', sa.BigInteger(), nullable=True),
+            sa.Column('created_at', sa.BigInteger(), nullable=True),
         ],
-        [sa.PrimaryKeyConstraint("id")],
+        [sa.PrimaryKeyConstraint('id')],
     ),
     (
-        "prompt",
+        'prompt',
         [
-            sa.Column("command", sa.String(), nullable=False),
-            sa.Column("user_id", sa.String(), nullable=True),
-            sa.Column("title", sa.Text(), nullable=True),
-            sa.Column("content", sa.Text(), nullable=True),
-            sa.Column("timestamp", sa.BigInteger(), nullable=True),
+            sa.Column('command', sa.String(), nullable=False),
+            sa.Column('user_id', sa.String(), nullable=True),
+            sa.Column('title', sa.Text(), nullable=True),
+            sa.Column('content', sa.Text(), nullable=True),
+            sa.Column('timestamp', sa.BigInteger(), nullable=True),
         ],
-        [sa.PrimaryKeyConstraint("command")],
+        [sa.PrimaryKeyConstraint('command')],
     ),
     (
-        "tag",
+        'tag',
         [
-            sa.Column("id", sa.String(), nullable=False),
-            sa.Column("name", sa.String(), nullable=True),
-            sa.Column("user_id", sa.String(), nullable=True),
-            sa.Column("data", sa.Text(), nullable=True),
+            sa.Column('id', sa.String(), nullable=False),
+            sa.Column('name', sa.String(), nullable=True),
+            sa.Column('user_id', sa.String(), nullable=True),
+            sa.Column('data', sa.Text(), nullable=True),
         ],
-        [sa.PrimaryKeyConstraint("id")],
+        [sa.PrimaryKeyConstraint('id')],
     ),
     (
-        "tool",
+        'tool',
         [
-            sa.Column("id", sa.String(), nullable=False),
-            sa.Column("user_id", sa.String(), nullable=True),
-            sa.Column("name", sa.Text(), nullable=True),
-            sa.Column("content", sa.Text(), nullable=True),
-            sa.Column("specs", JSONField(), nullable=True),
-            sa.Column("meta", JSONField(), nullable=True),
-            sa.Column("valves", JSONField(), nullable=True),
-            sa.Column("updated_at", sa.BigInteger(), nullable=True),
-            sa.Column("created_at", sa.BigInteger(), nullable=True),
+            sa.Column('id', sa.String(), nullable=False),
+            sa.Column('user_id', sa.String(), nullable=True),
+            sa.Column('name', sa.Text(), nullable=True),
+            sa.Column('content', sa.Text(), nullable=True),
+            sa.Column('specs', JSONField(), nullable=True),
+            sa.Column('meta', JSONField(), nullable=True),
+            sa.Column('valves', JSONField(), nullable=True),
+            sa.Column('updated_at', sa.BigInteger(), nullable=True),
+            sa.Column('created_at', sa.BigInteger(), nullable=True),
         ],
-        [sa.PrimaryKeyConstraint("id")],
+        [sa.PrimaryKeyConstraint('id')],
     ),
     (
-        "user",
+        'user',
         [
-            sa.Column("id", sa.String(), nullable=False),
-            sa.Column("name", sa.String(), nullable=True),
-            sa.Column("email", sa.String(), nullable=True),
-            sa.Column("role", sa.String(), nullable=True),
-            sa.Column("profile_image_url", sa.Text(), nullable=True),
-            sa.Column("last_active_at", sa.BigInteger(), nullable=True),
-            sa.Column("updated_at", sa.BigInteger(), nullable=True),
-            sa.Column("created_at", sa.BigInteger(), nullable=True),
-            sa.Column("api_key", sa.String(), nullable=True),
-            sa.Column("settings", JSONField(), nullable=True),
-            sa.Column("info", JSONField(), nullable=True),
-            sa.Column("oauth_sub", sa.Text(), nullable=True),
+            sa.Column('id', sa.String(), nullable=False),
+            sa.Column('name', sa.String(), nullable=True),
+            sa.Column('email', sa.String(), nullable=True),
+            sa.Column('role', sa.String(), nullable=True),
+            sa.Column('profile_image_url', sa.Text(), nullable=True),
+            sa.Column('last_active_at', sa.BigInteger(), nullable=True),
+            sa.Column('updated_at', sa.BigInteger(), nullable=True),
+            sa.Column('created_at', sa.BigInteger(), nullable=True),
+            sa.Column('api_key', sa.String(), nullable=True),
+            sa.Column('settings', JSONField(), nullable=True),
+            sa.Column('info', JSONField(), nullable=True),
+            sa.Column('oauth_sub', sa.Text(), nullable=True),
         ],
         [
-            sa.PrimaryKeyConstraint("id"),
-            sa.UniqueConstraint("api_key"),
-            sa.UniqueConstraint("oauth_sub"),
+            sa.PrimaryKeyConstraint('id'),
+            sa.UniqueConstraint('api_key'),
+            sa.UniqueConstraint('oauth_sub'),
         ],
     ),
 ]

backend/open_webui/migrations/versions/81cc2ce44d79_update_channel_file_and_knowledge_table.py

@@ -8,9 +8,9 @@ Create Date: 2025-12-10 16:07:58.001282
 
 from typing import Sequence, Union
 
-from alembic import op
-import sqlalchemy as sa
 import open_webui.internal.db
+import sqlalchemy as sa
+from alembic import op
 
 # revision identifiers, used by Alembic.
 revision: str = '81cc2ce44d79'

backend/open_webui/migrations/versions/8452d01d26d7_add_chat_message_table.py

@@ -6,13 +6,13 @@ Create Date: 2026-02-01 04:00:00.000000
 
 """
 
-import time
 import json
 import logging
+import time
 from typing import Sequence, Union
 
-from alembic import op
 import sqlalchemy as sa
+from alembic import op
 
 log = logging.getLogger(__name__)
 

backend/open_webui/migrations/versions/90ef40d4714e_update_channel_and_channel_members_table.py

@@ -8,9 +8,9 @@ Create Date: 2025-11-30 06:33:38.790341
 
 from typing import Sequence, Union
 
-from alembic import op
-import sqlalchemy as sa
 import open_webui.internal.db
+import sqlalchemy as sa
+from alembic import op
 
 # revision identifiers, used by Alembic.
 revision: str = '90ef40d4714e'

backend/open_webui/migrations/versions/922e7a387820_add_group_table.py

@@ -6,8 +6,8 @@ Create Date: 2024-11-14 03:00:00.000000
 
 """
 
-from alembic import op
 import sqlalchemy as sa
+from alembic import op
 
 revision = '922e7a387820'
 down_revision = '4ace53fd72c8'

backend/open_webui/migrations/versions/9f0c9cd09105_add_note_table.py

@@ -6,8 +6,8 @@ Create Date: 2025-05-03 03:00:00.000000
 
 """
 
-from alembic import op
 import sqlalchemy as sa
+from alembic import op
 
 revision = '9f0c9cd09105'
 down_revision = '3781e22d8b01'

backend/open_webui/migrations/versions/a1b2c3d4e5f6_add_skill_table.py

@@ -8,9 +8,8 @@ Create Date: 2026-02-11 09:30:00.000000
 
 from typing import Sequence, Union
 
-from alembic import op
 import sqlalchemy as sa
-
+from alembic import op
 from open_webui.migrations.util import get_existing_tables
 
 revision: str = 'a1b2c3d4e5f6'

backend/open_webui/migrations/versions/a3dd5bedd151_add_tasks_and_summary_to_chat.py

@@ -8,8 +8,8 @@ Create Date: 2026-03-29 22:15:00.000000
 
 from typing import Sequence, Union
 
-from alembic import op
 import sqlalchemy as sa
+from alembic import op
 
 # revision identifiers, used by Alembic.
 revision: str = 'a3dd5bedd151'

backend/open_webui/migrations/versions/a5c220713937_add_reply_to_id_column_to_message.py

@@ -8,8 +8,8 @@ Create Date: 2025-09-27 02:24:18.058455
 
 from typing import Sequence, Union
 
-from alembic import op
 import sqlalchemy as sa
+from alembic import op
 
 # revision identifiers, used by Alembic.
 revision: str = 'a5c220713937'

backend/open_webui/migrations/versions/af906e964978_add_feedback_table.py

@@ -6,8 +6,8 @@ Create Date: 2024-10-20 17:02:35.241684
 
 """
 
-from alembic import op
 import sqlalchemy as sa
+from alembic import op
 
 # Revision identifiers, used by Alembic.
 revision = 'af906e964978'

backend/open_webui/migrations/versions/b10670c03dd5_update_user_table.py

@@ -6,15 +6,13 @@ Create Date: 2025-11-28 04:55:31.737538
 
 """
 
-from typing import Sequence, Union
-
-from alembic import op
-import sqlalchemy as sa
-
-
-import open_webui.internal.db
 import json
 import time
+from typing import Sequence, Union
+
+import open_webui.internal.db
+import sqlalchemy as sa
+from alembic import op
 
 # revision identifiers, used by Alembic.
 revision: str = 'b10670c03dd5'

backend/open_webui/migrations/versions/b2c3d4e5f6a7_add_scim_column_to_user_table.py

@@ -8,8 +8,8 @@ Create Date: 2026-02-13 14:19:00.000000
 
 from typing import Sequence, Union
 
-from alembic import op
 import sqlalchemy as sa
+from alembic import op
 
 # revision identifiers, used by Alembic.
 revision: str = 'b2c3d4e5f6a7'

backend/open_webui/migrations/versions/b7c8d9e0f1a2_add_last_read_at_to_chat.py

@@ -6,9 +6,8 @@ Create Date: 2026-04-01 04:00:00.000000
 
 """
 
-from alembic import op
 import sqlalchemy as sa
-
+from alembic import op
 
 # revision identifiers, used by Alembic.
 revision = 'b7c8d9e0f1a2'

backend/open_webui/migrations/versions/c1d2e3f4a5b6_add_shared_chat_table.py

@@ -9,8 +9,8 @@ Create Date: 2026-04-16 23:00:00.000000
 import time
 import uuid
 
-from alembic import op
 import sqlalchemy as sa
+from alembic import op
 
 revision = 'c1d2e3f4a5b6'
 down_revision = 'e1f2a3b4c5d6'

backend/open_webui/migrations/versions/c29facfe716b_update_file_table_path.py

@@ -6,11 +6,12 @@ Create Date: 2024-10-20 17:02:35.241684
 
 """
 
-from alembic import op
-import sqlalchemy as sa
 import json
-from sqlalchemy.sql import table, column
-from sqlalchemy import String, Text, JSON, and_
+
+import sqlalchemy as sa
+from alembic import op
+from sqlalchemy import JSON, String, Text, and_
+from sqlalchemy.sql import column, table
 
 revision = 'c29facfe716b'
 down_revision = 'c69f45358db4'

backend/open_webui/migrations/versions/c440947495f3_add_chat_file_table.py

@@ -8,8 +8,8 @@ Create Date: 2025-12-21 20:27:41.694897
 
 from typing import Sequence, Union
 
-from alembic import op
 import sqlalchemy as sa
+from alembic import op
 
 # revision identifiers, used by Alembic.
 revision: str = 'c440947495f3'

backend/open_webui/migrations/versions/c69f45358db4_add_folder_table.py

@@ -6,8 +6,8 @@ Create Date: 2024-10-16 02:02:35.241684
 
 """
 
-from alembic import op
 import sqlalchemy as sa
+from alembic import op
 
 revision = 'c69f45358db4'
 down_revision = '3ab32c4b8f59'

backend/open_webui/migrations/versions/ca81bd47c050_add_config_table.py

@@ -10,8 +10,8 @@ from typing import Sequence, Union
 import sqlalchemy as sa
 from alembic import op
 
-revision: str = "ca81bd47c050"
-down_revision: Union[str, None] = "7e5b5dc7342b"
+revision: str = 'ca81bd47c050'
+down_revision: Union[str, None] = '7e5b5dc7342b'
 branch_labels: Union[str, Sequence[str], None] = None
 depends_on: Union[str, Sequence[str], None] = None
 
@@ -19,18 +19,18 @@ depends_on: Union[str, Sequence[str], None] = None
 def upgrade() -> None:
     """Create a key-value config table with versioning."""
     op.create_table(
-        "config",
-        sa.Column("id", sa.Integer, primary_key=True),
-        sa.Column("data", sa.JSON(), nullable=False),
-        sa.Column("version", sa.Integer, nullable=False),
+        'config',
+        sa.Column('id', sa.Integer, primary_key=True),
+        sa.Column('data', sa.JSON(), nullable=False),
+        sa.Column('version', sa.Integer, nullable=False),
         sa.Column(
-            "created_at",
+            'created_at',
             sa.DateTime(),
             nullable=False,
             server_default=sa.func.now(),
         ),
         sa.Column(
-            "updated_at",
+            'updated_at',
             sa.DateTime(),
             nullable=True,
             server_default=sa.func.now(),
@@ -41,4 +41,4 @@ def upgrade() -> None:
 
 def downgrade() -> None:
     """Drop the config table."""
-    op.drop_table("config")
+    op.drop_table('config')

backend/open_webui/migrations/versions/d31026856c01_update_folder_table_data.py

@@ -6,8 +6,8 @@ Create Date: 2025-07-13 03:00:00.000000
 
 """
 
-from alembic import op
 import sqlalchemy as sa
+from alembic import op
 
 revision = 'd31026856c01'
 down_revision = '9f0c9cd09105'

backend/open_webui/migrations/versions/d4e5f6a7b8c9_add_automation_tables.py

@@ -7,8 +7,8 @@ Create Date: 2026-03-30
 
 from typing import Union
 
-from alembic import op
 import sqlalchemy as sa
+from alembic import op
 
 revision: str = 'd4e5f6a7b8c9'
 down_revision: Union[str, None] = 'a3dd5bedd151'

backend/open_webui/migrations/versions/e1f2a3b4c5d6_add_is_pinned_to_note.py

@@ -6,8 +6,8 @@ Create Date: 2026-04-14 22:00:00.000000
 
 """
 
-from alembic import op
 import sqlalchemy as sa
+from alembic import op
 
 revision = 'e1f2a3b4c5d6'
 down_revision = 'b7c8d9e0f1a2'

backend/open_webui/migrations/versions/f1e2d3c4b5a6_add_access_grant_table.py

@@ -11,13 +11,12 @@ Access control semantics:
 - {read: {...}, write: {...}}: Custom permissions -> insert specific grants
 """
 
-from typing import Sequence, Union
 import time
 import uuid
+from typing import Sequence, Union
 
-from alembic import op
 import sqlalchemy as sa
-
+from alembic import op
 from open_webui.migrations.util import get_existing_tables
 
 revision: str = 'f1e2d3c4b5a6'