aiui Environment Variables

Reference for the AIUI_* and PRAISONAI_HOME variables that configure the Chat + Canvas UI

Set these variables in your shell before praisonai ui or praisonai claw to change the layout, timeouts, upload limits and where data is stored.

Diagram

AIUI_LAYOUT
AIUI_REPLY_IDLE_TIMEOUT
AIUI_MAX_BODY_MB
AIUI_DATA_DIR

🐚 Shell env

praisonai ui / claw

⚙️ aiui runtime

💬 Chat + Canvas

Quick Start

  1. Install
    bash
    pip install "praisonai[ui]"
  2. Launch with a variable
    bash
    AIUI_LAYOUT=chat praisonai ui

    The UI opens as a plain chat, without the canvas.

Variables

VariableDefaultEffectWhen to set
AIUI_LAYOUT(unset)Overrides the app’s chosen layout. One of chat-canvas, chat, workbench, command, guided, mission.One-run overrides (e.g. a demo without the canvas).
AIUI_REPLY_IDLE_TIMEOUT600Seconds a reply may send nothing before it’s cancelled. 0 turns it off.Long-running tools, batch jobs.
AIUI_MAX_BODY_MB25Cap on request body size, in MiB. 0 turns it off.Large file uploads.
AIUI_DATA_DIR~/.praisonaiuiWhere aiui stores its own settings.Docker volumes, shared dev machines.
PRAISONAI_HOME~/.praisonaiWhere PraisonAI stores its data, including chat history (sessions).Docker volumes, CI isolation.

AIUI_LAYOUT

The bundled UIs open in chat-canvas. Pick another layout for one run, or switch at runtime with ⌘K.

bash
AIUI_LAYOUT=chat praisonai ui          # No canvas, just chat

AIUI_REPLY_IDLE_TIMEOUT

A reply that sends nothing for this many seconds is cancelled, just like pressing Stop.

bash
AIUI_REPLY_IDLE_TIMEOUT=0 praisonai ui # Never time out replies

AIUI_MAX_BODY_MB

Request bodies (including uploads) larger than this are rejected.

bash
AIUI_MAX_BODY_MB=500 praisonai claw    # Allow 500 MiB uploads

AIUI_DATA_DIR and PRAISONAI_HOME

Chat history lives under ~/.praisonai/sessions; UI settings live in ~/.praisonaiui. Set both to keep everything on a mounted volume.

bash
AIUI_DATA_DIR=/data/aiui PRAISONAI_HOME=/data/praisonai praisonai ui

Best Practices

Persist data in Docker

Set both AIUI_DATA_DIR and PRAISONAI_HOME to paths on a mounted volume, otherwise history or settings are lost when the container restarts.

Raise the idle timeout instead of disabling it

For slow tools, a larger AIUI_REPLY_IDLE_TIMEOUT (e.g. 1800) still protects you from stuck replies.

Related