TLQ - Tiny Little Queue

A minimal message queue that just works

Simple, fast, in-memory message queue for development and testing

docker run -p 1337:1337 ghcr.io/skyaktech/tlq

Latest: v0.4.0

In-Memory & Fast

Zero persistence overhead. Perfect for development and testing.

🎯

Simple API

Clean REST endpoints with smart defaults. Add, get, delete, retry, and monitor your queue.

🔧

Zero Dependencies

Lightweight, standalone binary. Works everywhere with minimal footprint.

Why TLQ?

Most message brokers like RabbitMQ, Redis, or Kafka are powerful but heavy for local development and testing. TLQ is a zero-configuration alternative: a lightweight task queue and message broker designed specifically for development environments. Built in Rust for memory safety and blazing-fast performance, it spins up with a single Docker command. Test your microservices integration and throw it away. No setup, no persistence, no complexity.

Quick Start

🐳 Docker

docker run -p 1337:1337 ghcr.io/skyaktech/tlq

📦 Cargo

cargo install tlq
tlq

Try it out:

# Add a message
curl -X POST localhost:1337/add \
  -H "Content-Type: application/json" \
  -d '{"body":"Hello TLQ!"}'

# Get messages
curl -X POST localhost:1337/get \
  -H "Content-Type: application/json" \
  -d '{"count":1}'

# Check queue stats
curl localhost:1337/stats

Configuration

TLQ works out of the box. Customize behavior with environment variables:

docker run -p 1337:1337 \
  -e TLQ_LOCK_DURATION=60 \
  -e TLQ_MAX_RETRIES=3 \
  -e TLQ_WORKER_INTERVAL=10 \
  ghcr.io/skyaktech/tlq

All settings have sensible defaults. The background reaper automatically manages message lifecycle.

Changelog

v0.4.0 — March 2026

  • New GET /stats endpoint for real-time queue metrics
  • Background reaper worker for automatic message lifecycle management
  • New config options: TLQ_LOCK_DURATION, TLQ_MAX_RETRIES, TLQ_WORKER_INTERVAL

v0.3.0 — November 2025

  • Environment variable configuration (TLQ_PORT, TLQ_MAX_MESSAGE_SIZE, TLQ_LOG_LEVEL)
  • IPv6 support for dual-stack networking
  • Docker images moved to ghcr.io/skyaktech/tlq

v0.2.0 — August 2025

  • Complete REST API with queue operations (add, get, delete, retry, purge)
  • HTTP server with JSON support
  • Health check endpoint (GET /hello)

View all releases on GitHub →