Cloud-native, stateless, AI-agent-first meta search engine. Drop-in SearXNG replacement for the GroktoCrawl stack.

SlopSearX is a horizontally scalable, stateless meta search engine designed for AI agent consumption. It replaces SearXNG in the GroktoCrawl stack with:

• JSON output by default — structured responses designed for programmatic consumption
• YAML+Markdown native output — structured + readable for AI agent contexts via format=yaml
• SearXNG-compatible API — drop-in replacement for existing consumers
• Plugin engine adapters — one file per engine, @register_engine, zero orchestrator changes
• Category routing — SearXNG-compatible taxonomy with sub-categories and env-var overrides
• Distributed rate limiting — Valkey-backed sliding windows, correct at 50+ replicas
• Response caching — Valkey-backed, category-aware TTL, 150x speedup on cache hits
• OpenMetrics observability — /metrics endpoint, per-engine counters + latency + status
• Stateless, cloud-native — no local volumes, no persistent DB, all replicas interchangeable
• Hybrid config — env vars for secrets, optional mounted file for engine tuning

Adding a new engine: See docs/ENGINE_ADAPTERS.md for the full adapter reference — contract rules, data types, lifecycle hooks, and the category system.

Pre-built Docker images are available from GitHub Container Registry. Builds run automatically on every push to main (latest, unstable) and on version tags (stable, X, X.Y, X.Y.Z).

# Pull and run with Valkey for caching and rate limiting
docker run -d --name valkey valkey/valkey:8-alpine
docker run -d --name slopsearx -p 8080:8080 \
  -e VALKEY_URL=redis://valkey:6379/0 \
  --link valkey \
  ghcr.io/magnus919/slopsearx:latest

# Try it
curl 'http://localhost:8080/search?q=hello+world&format=json'

MIT — see LICENSE.