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.

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.

Client Libraries

🦀 Rust

cargo add tlq-client

crates.io →

📦 Node.js

npm install tlq-client

npm →

🐍 Python

pip install tlq-client

PyPI →

🐹 Go

go get github.com/skyaktech/tlq-client-go

pkg.go.dev →

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 →

GitHub 🐳 Container Registry 📚 Documentation