# Assay

> Assay is a ~9 MB static binary that runs Lua scripts in Kubernetes. It replaces 50-250 MB
> Python/Node/kubectl containers. One binary handles HTTP, database, crypto, WebSocket, and
> Kubernetes-native and AI agent service integrations. No `require()` for builtins — they are global.
> Stdlib modules use `require("assay.<name>")` then `M.client(url, opts)` → `c:method()`.
> Run `assay context <query>` to get LLM-ready method signatures for any module.
> HTTP responses are `{status, body, headers}` tables. Errors raised via `error()` — use `pcall()`.

## Getting Started
- [README](https://github.com/developerinlondon/assay/blob/main/README.md): Installation, quick start, examples
- [SKILL.md](https://github.com/developerinlondon/assay/blob/main/SKILL.md): LLM agent integration guide
- [GitHub](https://github.com/developerinlondon/assay): Source code and issues
- [Full API Reference](https://assay.rs/llms-full.txt): Complete method signatures for all modules

## Builtins (no require needed)
- [http](https://assay.rs/modules/http.html): HTTP client, server, SSE streaming — http.get/post/put/patch/delete/serve
- [json, yaml, toml](https://assay.rs/modules/serialization.html): JSON/YAML/TOML parse and encode
- [fs](https://assay.rs/modules/fs.html): Filesystem — fs.read/write
- [crypto, base64](https://assay.rs/modules/crypto.html): JWT signing/decoding, HMAC, hashing, random, base64
- [regex](https://assay.rs/modules/regex.html): Regex match, find, replace
- [db](https://assay.rs/modules/db.html): SQL database — Postgres, MySQL, SQLite — db.connect/query/execute
- [ws](https://assay.rs/modules/ws.html): WebSocket client — ws.connect/send/recv/close
- [template](https://assay.rs/modules/template.html): Jinja2-compatible template rendering
- [async](https://assay.rs/modules/async.html): Async task spawn and await
- [assert](https://assay.rs/modules/assert.html): Assertions — assert.eq/ne/gt/lt/contains/not_nil/matches
- [log, env, sleep, time](https://assay.rs/modules/utilities.html): Logging, environment variables, sleep, timestamps

## Monitoring & Observability
- [assay.prometheus](https://assay.rs/modules/prometheus.html): PromQL queries, alerts, targets, rules
- [assay.alertmanager](https://assay.rs/modules/alertmanager.html): Alert management, silences, receivers
- [assay.loki](https://assay.rs/modules/loki.html): Log push, query, labels, series
- [assay.grafana](https://assay.rs/modules/grafana.html): Health, dashboards, datasources, annotations

## Kubernetes & GitOps
- [assay.k8s](https://assay.rs/modules/k8s.html): 30+ K8s resource types, CRDs, readiness checks
- [assay.argocd](https://assay.rs/modules/argocd.html): ArgoCD apps, sync, health, projects
- [assay.kargo](https://assay.rs/modules/kargo.html): Kargo stages, freight, promotions
- [assay.flux](https://assay.rs/modules/flux.html): Flux GitRepositories, Kustomizations, HelmReleases
- [assay.traefik](https://assay.rs/modules/traefik.html): Traefik routers, services, middlewares

## Security & Identity
- [assay.vault](https://assay.rs/modules/vault.html): HashiCorp Vault KV, transit, PKI, auth
- [assay.openbao](https://assay.rs/modules/openbao.html): OpenBao (Vault API-compatible)
- [assay.certmanager](https://assay.rs/modules/certmanager.html): cert-manager certificates, issuers, ACME
- [assay.eso](https://assay.rs/modules/eso.html): External Secrets Operator
- [assay.dex](https://assay.rs/modules/dex.html): Dex OIDC discovery, JWKS, health
- [assay.zitadel](https://assay.rs/modules/zitadel.html): Zitadel OIDC identity, JWT machine auth
- [assay.ory](https://assay.rs/modules/ory.html): Ory stack — Kratos identity, Hydra OAuth2, Keto ReBAC, RBAC engine

## Infrastructure
- [assay.crossplane](https://assay.rs/modules/crossplane.html): Crossplane providers, XRDs, compositions
- [assay.velero](https://assay.rs/modules/velero.html): Velero backups, restores, schedules
- [assay.temporal](https://assay.rs/modules/temporal.html): Temporal — HTTP REST client, gRPC client, worker runtime with workflow coroutines
- [assay.harbor](https://assay.rs/modules/harbor.html): Harbor registry, projects, vulnerability scanning

## Data & Storage
- [assay.postgres](https://assay.rs/modules/postgres.html): PostgreSQL helpers, user management
- [assay.s3](https://assay.rs/modules/s3.html): S3-compatible storage (AWS, R2, MinIO) with Sig V4

## Feature Flags & Utilities
- [assay.unleash](https://assay.rs/modules/unleash.html): Unleash feature flags, environments, strategies
- [assay.healthcheck](https://assay.rs/modules/healthcheck.html): HTTP health checks, JSON path, latency

## AI Agent & Workflow
- [AI Agents](https://assay.rs/modules/ai-agents.html): OpenClaw, GitHub, Gmail, Google Calendar, OAuth2, Email Triage

## Optional
- [Crates.io](https://crates.io/crates/assay-lua): Use Assay as a Rust crate in your own projects
- [Docker](https://github.com/developerinlondon/assay/pkgs/container/assay): ghcr.io/developerinlondon/assay:latest (~9MB compressed)
- [Agent Guides](https://assay.rs/agent-guides.html): Integration guides for Claude Code, Cursor, Windsurf, Cline, OpenCode
- [Changelog](https://github.com/developerinlondon/assay/releases): Release history
