Skip to content

Configuration & Environment Variables ​

AIST intentionally keeps its configuration surface minimal — zero client config files (config.yaml is not used) and zero required server environment variables.

Client Environment Variables ​

VariableRequiredDefaultPurpose
AIST_SERVERNoStored server_url or https://aistrun.ccOverrides the server URL in aist login, token loading, and run.sh
AIST_RELEASE_BASE_URLNo${AIST_SERVER}/releases/client(run.sh only) Overrides client archive mirror URL for custom testing
AIST_YESNoUnset(uninstall.sh only) Set AIST_YES=1 to confirm uninstallation in non-interactive shells
LC_ALL / LC_MESSAGES / LANGNoOS localeInspected once when ~/.aist/preferences.json does not exist yet to infer initial zh or en language

Server & Docker Compose Environment Variables ​

VariableScopeDefaultPurpose
AIST_SERVER_ADDRserver process:8090HTTP listen address inside the server process / container
AIST_SERVER_VERSIONdeploy/server/compose.yamllatestImage tag pulled from ghcr.io/llaoj/aist-server
AIST_SERVER_BINDdeploy/server/compose.yaml127.0.0.1:8090Host ip:port mapped to container :8090
AIST_SERVER_DATAdeploy/server/compose.yaml./dataHost directory mounted at /var/lib/aist
Custom <ENCRYPTION_ENV>server serve --encryptionEnv=<VAR>DisabledOptional 32-character secret for PocketBase AES-256-GCM encryption of Settings and upstream_providers.api_key

Per-User / Invite-Code settings JSON Schema ​

Stored in users.settings and invite_codes.settings on the server:

json
{
  "session": {
    "max_sessions": 10,
    "compaction": {
      "keep_tokens": 20000,
      "trigger_ratio": 0.85
    }
  },
  "blacklist": [
    "rm -rf /",
    "mkfs *",
    "shutdown"
  ]
}
FieldFallback When <= 0 or OmittedDescription
session.max_sessions10Number of recent local sessions kept under ~/.aist/sessions/
session.compaction.keep_tokens20000Approximate uncompacted tail token budget kept intact
session.compaction.trigger_ratio0.85Fraction of (context_window - max_output_tokens) that triggers compaction
blacklist[]Glob patterns enforced by both <command_blacklist> prompt block and client AST guard

Proxy Timeout Defaults (Client → Server) ​

TimeoutValue
Overall completion request timeout10m
Response header timeout5m
Response body read timeout15m

Licensed under AGPL-3.0 (Commercial licensing available: contact@aistrun.cc)