looptroopai/looptroop repository overview

⁠LoopTroop

⁠Quickstart

Run LoopTroop locally with persistent storage:

docker run -d \
  --name looptroop \
  -p 57321:57321 \
  -v looptroop_data:/app/data \
  -v /var/run/docker.sock:/var/run/docker.sock \
  looptroopai/looptroop:latest

Open http://localhost:57321 in your browser.

⁠Docker Compose Example

version: '3.8'
services:
  looptroop:
    image: looptroopai/looptroop:latest
    container_name: looptroop
    ports:
      - "57321:57321"
    volumes:
      - looptroop_data:/app/data
      - /var/run/docker.sock:/var/run/docker.sock
    restart: unless-stopped

volumes:
  looptroop_data:

⁠Key Features

• LLM Council Planning: Multiple models debate, vote on, and assemble execution plans.
• Isolated Worktrees: Every task executes in dedicated Git worktrees without touching your working branch.
• Ralph Loops: Automated test, lint, and error recovery before code is merged.
• Transparent & Local: Full audit logs, local SQLite storage, and direct control over your workspace.

⁠Configuration & Ports

• Port 57321: Main web UI and local server API.
• Volume /app/data: Persistent storage for SQLite database state and project history. Always mount a named volume or host directory so data persists across container updates.

⁠Links & Resources

• Source Code & Issues: github.com/looptroop-ai/LoopTroop⁠
• Documentation: looptroop.ovh/docs⁠
• Core Philosophy: looptroop.ovh/docs/core-philosophy⁠
• License: MIT