feat: run chat api with python -m askui.chat

also:
- make default chat api port consistent to allow
  for easier testing

Author: adi-wan-askui

.vscode/launch.json

@@ -28,7 +28,7 @@
             "preLaunchTask": "Create .env.tmp file",
             "postDebugTask": "Delete .env.tmp file",
             "module": "uvicorn",
-            "args": ["src.askui.chat.api.app:app","--reload","--port","8000"],
+            "args": ["src.askui.chat.api.app:app","--reload","--port","9261"],
             "envFile": "${workspaceFolder}/.env.tmp",
             "env": {
                 "ASKUI_WORKSPACES__LOG__FORMAT": "logfmt",

README.md

@@ -792,19 +792,22 @@ To use the chat, configure the following environment variables:
 - `ASKUI_TOKEN`: AskUI Vision Agent behind chat uses currently the AskUI API
 - `ASKUI_WORKSPACE_ID`: AskUI Vision Agent behind chat uses currently the AskUI API
 - `ASKUI__CHAT_API__DATA_DIR` (optional, defaults to `$(pwd)/chat`): Currently, the AskUI chat stores all data in a directory locally. You can change the default directory by setting this environment variable.
+- `ASKUI__CHAT_API__HOST` (optional, defaults to `127.0.0.1`): The host to bind the chat API to.
+- `ASKUI__CHAT_API__PORT` (optional, defaults to `9261`): The port to bind the chat API to.
+- `ASKUI__CHAT_API__LOG_LEVEL` (optional, defaults to `info`): The log level to use for the chat API.
 
 #### Installation
 
 ```bash
-pdm install # is going to install the dependencies of the api
+pip install askui[chat]
 ```
 
 You may need to give permissions on the fast run of the Chat UI to demonstrate actions (aka record clicks).
 
 #### Usage
 
 ```bash
-pdm run chat:api # is going to start the api at port 8000
+python -m askui.chat
 ```
 
 You can use the chat to record a workflow and redo it later. For that, just tell the agent to redo all previous steps.

pyproject.toml

@@ -54,7 +54,7 @@ lint = "ruff check src tests"
 "lint:fix" = "ruff check --fix src tests"
 typecheck = "mypy"
 "typecheck:all" = "mypy src tests"
-"chat:api" = "uvicorn askui.chat.api.app:app --reload --port 8000"
+"chat:api" = "uvicorn askui.chat.api.app:app --reload --port 9261"
 "mcp:dev" = "mcp dev src/askui/mcp/__init__.py"
 
 [dependency-groups]

src/askui/chat/__main__.py

@@ -0,0 +1,15 @@
+import uvicorn
+
+from askui.chat.api.app import app
+from askui.chat.api.dependencies import get_settings
+
+if __name__ == "__main__":
+    settings = get_settings()
+    uvicorn.run(
+        app,
+        host=settings.host,
+        port=settings.port,
+        log_level=settings.log_level,
+        reload=False,
+        workers=1,
+    )

src/askui/chat/api/settings.py

@@ -15,3 +15,17 @@ class Settings(BaseSettings):
         default_factory=lambda: Path.cwd() / "chat",
         description="Base directory for storing chat data",
     )
+    host: str = Field(
+        default="127.0.0.1",
+        description="Host for the chat API",
+    )
+    log_level: str | int = Field(
+        default="info",
+        description="Log level for the chat API",
+    )
+    port: int = Field(
+        default=9261,
+        description="Port for the chat API",
+        ge=1024,
+        le=65535,
+    )