TLQ (Tiny Little Queue)

A minimal message queue that just works.

📖 Full Documentation →

Quick Start

Install

# Using Cargo
cargo install tlq

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

# Docker with custom configuration
docker run -e TLQ_PORT=8080 -p 8080:8080 ghcr.io/skyaktech/tlq
docker run -e TLQ_MAX_MESSAGE_SIZE=1048576 -e TLQ_LOG_LEVEL=debug -p 1337:1337 ghcr.io/skyaktech/tlq

Use

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

# Get a message (auto-locks it)
curl -X POST localhost:1337/get \
  -H "Content-Type: application/json" \
  -d '{"count":1}'

# Delete after success
curl -X POST localhost:1337/delete \
  -H "Content-Type: application/json" \
  -d '{"ids":["<message-id>"]}'

# Or retry after failure
curl -X POST localhost:1337/retry \
  -H "Content-Type: application/json" \
  -d '{"ids":["<message-id>"]}'

Features

• In-memory - Zero persistence overhead
• Simple API - Just add, get, delete, retry
• Auto-locking - Messages lock on retrieval
• Client libraries - Rust, Node.js, Python, Go

Configuration

You can configure TLQ via environment variables (all optional; defaults shown):

• TLQ_PORT: TCP port to listen on. Default: 1337
• TLQ_MAX_MESSAGE_SIZE: Maximum message body size in bytes. Default: 65536
• TLQ_LOG_LEVEL: Log verbosity (trace, debug, info, warn, error). Default: info

Examples:

TLQ_PORT=8080 tlq
TLQ_MAX_MESSAGE_SIZE=1048576 TLQ_LOG_LEVEL=debug tlq

Why TLQ?

Perfect for:

• Development & testing
• Lightweight job processing
• Microservice communication
• Any scenario where persistence isn't critical

License

MIT

Author

Nebojsa Jakovljevic