abdofallah/iqraai-background repository overview

⁠

⁠Iqra AI - Background Processor

Iqra AI is an orchestration infrastructure designed to bridge the gap between the chaos of LLMs and the reliability of business code.

This image contains the Background Processor for Iqra AI. It operates as an asynchronous background worker dedicated to system health and housekeeping. It handles continuous platform optimizations such as clearing out stale data, managing cache invalidation, and executing routine maintenance tasks to keep the cluster running smoothly.

⁠Quick Start (Docker Compose)

The Background Processor runs autonomously but requires standard port mapping and hardware monitoring mounts to integrate with the main cluster.

version: '3.8'

services:
  background:
    image: abdofallah/iqraai-background:latest
    container_name: iqra-background
    restart: always
    ports:
      - "9999:9999"
    volumes:
      # Hardware monitoring mounts (Read-Only access to host metrics)
      - /proc:/host/proc:ro
      - /sys:/host/sys:ro
      
      # Configuration mount (Read-Only)
      - ./appsettings.json.background:/app/appsettings.json:ro

⁠Configuration

Before running the container, you must provide the configuration file. Download the example template here: 👉 appsettings.json.example⁠

Make sure Hardware:IsDockerContainer is set to true in the configuration if hardware monitoring mounts are being used (as else it will use the containers /proc & /sys where as setting it to true looks for /host/proc & /host/sys in the container).

⁠Links & Resources

• GitHub Repository: abdofallah/IqraAI⁠
• Website: iqra.bot⁠
• Self-Hosting Docs: docs.iqra.bot/developers/self-hosting⁠