# 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 33
> 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
## Builtins (no require needed)
- [http](https://assay.rs/modules.html#http): HTTP client and server — http.get/post/put/patch/delete/serve
- [json](https://assay.rs/modules.html#json): JSON parse and encode
- [yaml](https://assay.rs/modules.html#yaml): YAML parse and encode
- [toml](https://assay.rs/modules.html#toml): TOML parse and encode
- [fs](https://assay.rs/modules.html#fs): Filesystem — fs.read/write
- [crypto](https://assay.rs/modules.html#crypto): JWT signing, HMAC, hashing, random — crypto.jwt_sign/hash/hmac/random
- [base64](https://assay.rs/modules.html#base64): Base64 encode/decode
- [regex](https://assay.rs/modules.html#regex): Regex match, find, replace
- [db](https://assay.rs/modules.html#db): SQL database — Postgres, MySQL, SQLite — db.connect/query/execute
- [ws](https://assay.rs/modules.html#ws): WebSocket client — ws.connect/send/recv/close
- [template](https://assay.rs/modules.html#template): Jinja2-compatible template rendering
- [async](https://assay.rs/modules.html#async): Async task spawn and await
- [assert](https://assay.rs/modules.html#assert): Assertions — assert.eq/gt/lt/contains/not_nil/matches
- [log](https://assay.rs/modules.html#log): Logging — log.info/warn/error
- [env](https://assay.rs/modules.html#env): Environment variables — env.get
- [sleep](https://assay.rs/modules.html#sleep): Sleep for N seconds
- [time](https://assay.rs/modules.html#time): Unix timestamp in seconds
## Monitoring & Observability
- [assay.prometheus](https://assay.rs/modules.html#prometheus): PromQL queries, alerts, targets, rules
- [assay.alertmanager](https://assay.rs/modules.html#alertmanager): Alert management, silences, receivers
- [assay.loki](https://assay.rs/modules.html#loki): Log push, query, labels, series
- [assay.grafana](https://assay.rs/modules.html#grafana): Health, dashboards, datasources, annotations
## Kubernetes & GitOps
- [assay.k8s](https://assay.rs/modules.html#k8s): 30+ K8s resource types, CRDs, readiness checks
- [assay.argocd](https://assay.rs/modules.html#argocd): ArgoCD apps, sync, health, projects
- [assay.kargo](https://assay.rs/modules.html#kargo): Kargo stages, freight, promotions
- [assay.flux](https://assay.rs/modules.html#flux): Flux GitRepositories, Kustomizations, HelmReleases
- [assay.traefik](https://assay.rs/modules.html#traefik): Traefik routers, services, middlewares
## Security & Identity
- [assay.vault](https://assay.rs/modules.html#vault): HashiCorp Vault KV, transit, PKI, auth
- [assay.openbao](https://assay.rs/modules.html#openbao): OpenBao (Vault API-compatible)
- [assay.certmanager](https://assay.rs/modules.html#certmanager): cert-manager certificates, issuers, ACME
- [assay.eso](https://assay.rs/modules.html#eso): External Secrets Operator
- [assay.dex](https://assay.rs/modules.html#dex): Dex OIDC discovery, JWKS, health
- [assay.zitadel](https://assay.rs/modules.html#zitadel): Zitadel OIDC identity, JWT machine auth
## Infrastructure
- [assay.crossplane](https://assay.rs/modules.html#crossplane): Crossplane providers, XRDs, compositions
- [assay.velero](https://assay.rs/modules.html#velero): Velero backups, restores, schedules
- [assay.temporal](https://assay.rs/modules.html#temporal): Temporal workflows, task queues, schedules
- [assay.harbor](https://assay.rs/modules.html#harbor): Harbor registry, projects, vulnerability scanning
## Data & Storage
- [assay.postgres](https://assay.rs/modules.html#postgres): PostgreSQL helpers, user management
- [assay.s3](https://assay.rs/modules.html#s3): S3-compatible storage (AWS, R2, MinIO) with Sig V4
## Feature Flags & Utilities
- [assay.unleash](https://assay.rs/modules.html#unleash): Unleash feature flags, environments, strategies
- [assay.healthcheck](https://assay.rs/modules.html#healthcheck): HTTP health checks, JSON path, latency
## AI Agent & Workflow
- [assay.openclaw](https://assay.rs/modules.html#openclaw): OpenClaw AI agent platform — invoke tools, state, diff, approve, LLM tasks, cron, sub-agents
- [assay.github](https://assay.rs/modules.html#github): GitHub REST API — PRs, issues, actions, GraphQL (no gh CLI)
- [assay.gmail](https://assay.rs/modules.html#gmail): Gmail REST API with OAuth2 — search, read, reply, send
- [assay.gcal](https://assay.rs/modules.html#gcal): Google Calendar REST API with OAuth2 — events CRUD, calendar list
- [assay.oauth2](https://assay.rs/modules.html#oauth2): Google OAuth2 token management — file-based credentials, auto-refresh, persistence
- [assay.email_triage](https://assay.rs/modules.html#email_triage): Email triage — deterministic rules + LLM-assisted classification
## 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)
- [MCP Comparison](https://assay.rs/mcp-comparison.html): How Assay replaces 42 popular MCP servers
- [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