AI Runner Manual - Capsize-Games/airunner GitHub Wiki

General

Shortcuts (Key Bindings)

Each shortcut includes a display name, key binding, description, and the internal signal it triggers.

Action Key Description
Generate Image F1 Triggers Stable Diffusion image generation
Brush Tool B Selects the brush tool
Eraser Tool E Selects the eraser tool
Move Tool V Selects the move tool
Select Tool S Selects the selection tool
Interrupt Process Ctrl+Shift+I Interrupts current AI generation task
Navigate to URL Ctrl+Shift+P Opens a URL input prompt
Quit Application Ctrl+Q Quits AI Runner
Refresh Stylesheet F5 Reloads the current stylesheet

Advanced Features

Memory Optimization

AI Runner provides advanced memory settings to optimize performance:

  • TF32 Mode: Faster matrix multiplications on Ampere GPUs with slightly reduced precision.
  • VAE Slicing: Decodes large image batches with limited VRAM.
  • Attention Slicing: Reduces VRAM usage with minimal impact on inference speed.

Experimental Features

  • Weather-based Chatbot Prompts: Integrates real-time weather data into chatbot conversations using the Open-Meteo API.
  • Command-line Arguments: Includes options like --clear-window-settings and --perform-llm-analysis for debugging and advanced usage.

Safety and Guardrails

  • NSFW Content Detection: Configurable safety checker for image generation.
  • Customizable Guardrails: Default prompts to ensure ethical and safe AI interactions.

LLM

Chatbots

Mood / Personality

Chatbots in AI Runner can adapt their mood and personality based on conversation context. This feature can be customized or disabled in the settings.

Weather

Weather is an experimental feature that makes use of the Open-Meteo API.

To enable, set your zipcode in AI Runner Preferences > User Settings > Zipcode

image

And check the Use Weather Prompt option under AI Runner Preferences > Chatbot

image

The weather API is usable without a key. Requests are cached and results can be presented in your preferred temperature unit.

As one might guess, weather data is limited to the zipcode that is set in the user preferences. This feature could be expanded in many ways, including agent tools, more data retrieval, data displayed in the GUI and more. For now it allows you to do things like conversationally ask if you need a coat, or simply talk about the weather like one might do with a human.

Weather integration allows chatbots to provide weather-based responses. Enable this feature by setting your zipcode in Preferences > User Settings > Zipcode and checking the Use Weather Prompt option under Preferences > Chatbot.

RAG

Text-to-speech

Speech-to-text

Art

Supported file types

  • Safetensors

Supported Model versions

  • Stable Diffusion 1.5
  • SDXL / SDXL Turbo / SDXL Lightning

Supported Model types

  • Text-to-image
  • Image-to-image
  • Inpaint / Outpaint
  • Controlnet
  • LoRA
  • Embeddings

Where to get models

By default AI Runner comes with no Stable Diffusion models. You must acquire those on your own.

Where to place art models

[AI Runner path]/art/models/[VERSION]/[PIPELINE]

Example:

~/airunner/art/models/SDXL/txt2img/some_ai_art_model.safetensors

By default the AI Runner Stable Diffusion settings interface will update available models and your newly downloaded model will show in the dropdown.

Supported Features

  • Memory Optimization: Includes TF32, VAE slicing, and attention slicing for efficient image generation.
  • Safety Features: NSFW content detection and customizable prompts for ethical AI usage.

LoRA

Embeddings