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 /statsendpoint 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)