Settings - Capsize-Games/airunner GitHub Wiki

AI Runner Settings

This page documents the default settings used by AI Runner. These values can be customized by editing settings.py or setting the corresponding environment variables (unless otherwise stated) before launching the application.

AIRUNNER_DEFAULT_LLM_HF_PATH

  • Default: w4ffl35/Ministral-8B-Instruct-2410-doublequant
  • Description: Default path to the Hugging Face LLM model.

AIRUNNER_DEFAULT_STT_HF_PATH

  • Default: openai/whisper-tiny
  • Description: Default Hugging Face model path for speech-to-text (STT).

AIRUNNER_DEFAULT_IMAGE_SYSTEM_PROMPT

  • Default: Long JSON-replacement instruction string
  • Description: Prompt used by the image description LLM to transform attribute PLACEHOLDERs based on input JSON.

AIRUNNER_DEFAULT_IMAGE_LLM_GUARDRAILS

  • Default: Safety-focused instructions
  • Description: Guardrails to prevent the generation of unsafe, illegal, or offensive image prompts.

AIRUNNER_DEFAULT_RAG_SEARCH_SYSTEM_PROMPT

  • Description: Prompt used to guide the LLM for ebook/document RAG-style search.

AIRUNNER_DEFAULT_APPLICATION_COMMAND_SYSTEM_PROMPT

  • Description: Prompt that lets the LLM interpret user commands and map them to system actions.

AIRUNNER_DEFAULT_UPDATE_MOOD_SYSTEM_PROMPT

  • Description: Prompt used to extract a single emotion from recent conversation history.

AIRUNNER_DEFAULT_SUMMARIZE_CHAT_SYSTEM_PROMPT

  • Description: Prompt for summarizing chat into a single concise sentence.

AIRUNNER_DEFAULT_CHATBOT_SYSTEM_PROMPT

  • Description: Personality-specific prompt used to generate single-sentence dialogue for characters.

AIRUNNER_DEFAULT_CHATBOT_GUARDRAILS_PROMPT

  • Description: Guardrails for chatbot responses to ensure ethical, respectful output.

Default File Paths

These are default folders for various types of input/output and model data.

AIRUNNER_BASE_PATH

  • Default: ~/.local/share/airunner
  • Description: Base directory for AI Runner persistent data.

Image Generation Settings

AIRUNNER_PHOTO_REALISTIC_NEGATIVE_PROMPT

  • Description: Used to exclude non-photographic elements when generating photo-style images.

AIRUNNER_ILLUSTRATION_NEGATIVE_PROMPT

  • Description: Used to exclude photo-realistic elements when generating illustrations.

AIRUNNER_SD_DEFAULT_VAE_PATH

  • Description: Optional override path for custom VAE when using Stable Diffusion.

AIRUNNER_DEFAULT_SCHEDULER

  • Default: DPM++ 2M Karras
  • Description: Default image generation scheduler.

AIRUNNER_MIN_NUM_INFERENCE_STEPS_IMG2IMG

  • Default: 3
  • Description: Minimum steps allowed for image-to-image generation.

AIRUNNER_MAX_SEED

  • Default: 4294967295
  • Description: Maximum random seed value used in image generation.

AIRUNNER_NSFW_CONTENT_DETECTED_MESSAGE

  • Default: "NSFW content detected"
  • Description: message used in signal when NSFW content is detected

AIRUNNER_VALID_IMAGE_FILES

  • Default: "Image Files (*.png *.jpg *.jpeg)"
  • Description: The types of images that the GUI file system is allowed to work with.

AIRUNNER_ART_ENABLED

  • Default: "1" (true)
  • Description: Toggle whether or not AI art (Stable Diffusion) is enabled.

Color & Theme Settings

These values define default colors and theme names.

AIRUNNER_DEFAULT_BRUSH_PRIMARY_COLOR

  • Default: #99C1F1

AIRUNNER_DEFAULT_BRUSH_SECONDARY_COLOR

  • Default: #000000

AIRUNNER_STATUS_ERROR_COLOR

  • Default: #ff0000

AIRUNNER_STATUS_NORMAL_COLOR_LIGHT

  • Default: #000000

AIRUNNER_STATUS_NORMAL_COLOR_DARK

  • Default: #ffffff

AIRUNNER_DARK_THEME_NAME

  • Default: dark_theme

AIRUNNER_LIGHT_THEME_NAME

  • Default: light_theme

Miscellaneous

AIRUNNER_BUG_REPORT_LINK

  • Description: GitHub issue link for reporting bugs.

AIRUNNER_VULNERABILITY_REPORT_LINK

  • Description: GitHub security advisory link for reporting vulnerabilities.

AIRUNNER_DISCORD_URL

  • Description: Optional Discord invite URL.

AIRUNNER_SLEEP_TIME_IN_MS

  • Default: 50
  • Description: Delay used in some background processing loops.

AIRUNNER_DB_URL

  • Default: SQLite path in user directory
  • Description: Full SQLAlchemy connection string for app database.

LLM Behavior Control

AIRUNNER_LLM_AGENT_MAX_FUNCTION_CALLS

  • Default: 5
  • Description: Maximum function calls an agent can perform before stopping.

AIRUNNER_LLM_AGENT_UPDATE_MOOD_AFTER_N_TURNS

  • Default: 3
  • Description: Controls how often mood updates happen.

AIRUNNER_LLM_AGENT_SUMMARIZE_AFTER_N_TURNS

  • Default: 5
  • Description: Frequency of chat summarization.

AIRUNNER_LLM_PERFORM_ANALYSIS

  • Default: "1" (True)
  • Description: Allow mood and sentiment analysis

AIRUNNER_LLM_PERFORM_CONVERSATION_SUMMARY

  • Default: "1" (True)
  • Description: Allow conversation summaries.

AIRUNNER_LLM_PERFORM_CONVERSATION_RAG

  • Default: "1" (True)
  • Description: Allow RAG on conversations.

AIRUNNER_LLM_PRINT_SYSTEM_PROMPT

  • Default: "0" (False)
  • Description: Allow conversation summaries.

AIRUNNER_LLM_OPENAIROUTER_MODEL

  • Default: "mistralai/mistral-7b-instruct:free"
  • Description: The model path of the OpenRouter model you wish to use.

AIRUNNER_LLM_USE_LOCAL

  • Default: "1" (True)
  • Description: Boolean that determines if you want to use an LLM running on your local hardware.

AIRUNNER_LLM_USE_OPENROUTER

  • Default: "0" (False)
  • Description: Boolean that determines if you want to use an LLM running on OpenRouter API.

AIRUNNER_LLM_OPENROUTER_API_KEY

  • Default: ""
  • Description: Your OpenRouter API key (required if AIRUNNER_LLM_USE_OPENROUTER is True)

AIRUNNER_LLM_USE_OPENAI

  • Default: "0" (False)
  • Description: Boolean that determines if you want to use an LLM runing on OpenAI API.

AIRUNNER_LLM_OPENAI_API_KEY

  • Default: ""
  • Description: Your OpenAI API key (required if AIRUNNER_LLM_USE_OPENAI is True)

AIRUNNER_LLM_USE_WEATHER_PROMPT

  • Default: "1" (True)
  • Description: Boolean to enable / disable weather prompt usage by LLM. This will override chatbot weather prompt settings.

Identity

AIRUNNER_ORGANIZATION

  • Default: Capsize LLC

AIRUNNER_APPLICATION_NAME

  • Default: AI Runner

AIRUNNER_MESSAGE_BACKEND

  • Default: None
  • Description: Can be used to define a custom message routing backend.

Text-to-speech

OpenVoice settings

AIRUNNER_ENABLE_OPEN_VOICE

  • Default: "0"
  • Description: Set to "1" to try experimental OpenVoice text-to-speech support

AIRUNNER_TTS_SPEAKER_RECORDING_PATH=

  • Default: ""
  • Description: Set path to an mp3 file containing a voice you want to clone (example "~/Desktop/bob_ross.mp3")

Advanced Settings

Memory Preferences

  • TF32 Mode: Faster matrix multiplications on Ampere GPUs.
  • Attention Slicing: Reduces VRAM usage with minimal performance impact.
  • Tile VAE: Decodes large image batches with limited VRAM.
  • Sequential CPU Offload: Offloads weights to CPU for memory savings.
  • ToMe Token Merging: Merges redundant tokens for faster inference.

Export Preferences

  • Metadata Options: Includes prompt, negative prompt, scale, seed, and more.