Documentation
Build with AT-1
Everything to compress, decode, and query AT-1 files — in any language, in the browser, or at the edge.
New here? Start hereTinyFiles in plain English →No jargon: what it is, what it does to your files, whether yours will shrink, and the three ways to use it. Read this before anything else.The basics
Install it, compress something, get it back. Start to finish.
Getting startedInstall, connect your account, compress, decompress, query — the 5-minute tour.Examples & integrationsCopy-paste recipes: DuckDB, pandas, Postgres, S3, auto-tiering, AI agents.React: TanStack VirtualRender millions of rows from one compressed .at1 in the browser — no backend, <1% of the file read.React: TanStack DB & QueryHydrate a reactive TanStack DB collection (or a Query queryFn) from a compressed .at1, then useLiveQuery.ImagesWhat wins (raw, DICOM, scientific), what doesn't (JPEG/PNG), and how to use images in your app.CLI referencecompress / decompress / query / sql / info and the operational tools.Install via npm / pnpmThe full CLI as a native binary from npm — no Python. Works with npm, pnpm, yarn, bun.Desktop appDrag-drop compress & query on Windows, macOS, Linux — with auto-update.SDK & bindingsPython, C ABI, WASM, Go, Rust, Node — decode anywhere.
Query your data
Search inside the compressed file — no unpack step.
Query & SQLPredicate/projection pushdown, by name, range-GET, partitioned scans.Query from your engineDuckDB, SQLite, Postgres, Spark, Trino, ClickHouse, Polars, pandas — over one core.Query over the wireRange-GET a cold .at1 in S3/HTTPS reading under 1% of it — no server.Appendable tablesAppend-only segments, compaction, and a tamper-evident hash-chained log.Time-travel queriesReconstruct a table as it was at any past point — for audit & debugging.Streaming & live ingestBounded-memory streaming compress; query a stream while it lands.
Connect your stack
Wire AT-1 into the storage and tools you already run.
Managed cloudS3-compatible write (compress on PUT) + transparent read + SQL REST.Ingest from a URLat1 fetch streams a download into a verified .at1 — plaintext never lands on disk.DatabasesQueryable, byte-exact archives of DB exports.Operational toolsat1-doctor (savings scan), at1-watch (auto-tier), at1-attest (attestation).MCP server (AI agents)Let Claude / Cursor / VS Code compress & query .at1 directly.
Files, media & AI
Queryable, verified videoFind the moment, pull that exact frame/clip out as a verified artifact, prove it's unaltered.Living Database (.html)A self-contained, searchable .html — and full-text search over PDFs & Word docs.Living AIPack a knowledge folder into one verified ~33 MB file with an on-device generative assistant.Addressable weights (.at1w)Per-tensor random access + SHA-256 integrity at ~40% smaller than raw bf16 — a safetensors drop-in.
Industry verticals & licensed engines
Genomics (VCF)The genotype-aware codec, the verified BCF head-to-head, and the honest boundary.Condition monitoringLabel-free bearing-fault diagnostic from the compression residual — verified CWRU results, CMMS alerts.Licensed enginesEnable an engine → accept the EULA → download. Generative, weights, diagnostic, evidence, compliance, risk-tape.Vault / confidential clean-roomShare scoped, revocable, audited query grants — counterparties get answers, not the bytes.AI Evidence CapsuleA notarized, reproducible receipt for an AI inference — re-run it offline for byte-identical output.Compliance-grade storageVerified, tamper-evident, queryable retention for SEC 17a-4 / FINRA WORM, ESG/CSRD evidence.Right to erasureErase one data subject from a compressed archive in seconds — per-subject keys, key-destruction erasure, signed certificate. GDPR/CCPA.Risk Tape (Compression-VIX)A model-free market-stress index from order-flow structure — a coincident risk gauge.
Reference
Want the business case? See the overview and benchmarks.