Installation

DuckViz is a web application — there is nothing to install on your machine. Open your browser, sign in, and start analyzing data.

Browser support

DuckViz requires a modern browser with WebAssembly and Web Workers support. Recommended:

Browser	Minimum version
Chrome / Edge	90+
Firefox	89+
Safari	15.4+

Mobile browsers

DuckViz works best on desktop. The drag-and-drop dashboard grid, SQL editor, and multi-panel explorer are designed for larger screens. Mobile browsing is functional but not optimized.

System requirements

DuckViz runs entirely in your browser using DuckDB-WASM. Performance depends on:

RAM — each table is loaded into browser memory. For files over 100 MB, ensure at least 8 GB of system RAM. DuckViz monitors memory usage and will warn you before hitting limits.
CPU — file parsing and SQL queries run in Web Workers off the main thread, so the UI stays responsive. Multi-core processors will see better performance during ingestion.
Storage — DuckViz persists tables as Parquet files in IndexedDB. Your browser's storage quota (typically 50%+ of free disk space) determines how many tables you can keep across sessions.

Creating an account

Go to app.duckviz.com
Click Sign in with Google or enter your email address
For email sign-in, check your inbox for a magic link
You're in — new accounts receive free AI credits automatically

No credit card is required. Free credits let you try all AI features (widget generation, report writing, log format detection) without paying.

For developers: npm packages

Two paths, depending on whether you're starting fresh or adding DuckViz to an existing app.

Fastest: scaffold a starter

npx duckviz create-app my-app

Drops you into a Next.js 15 + Tailwind v4 starter with the SDK proxy, the customFetch path rewrite, and four working surfaces (/dashboard, /explorer, /report, /deck) pre-wired against a demo dataset. This is the recommended path — see the packages quickstart for the 60-second walkthrough, or the Next.js Integration Guide to understand what the scaffold puts in place.

Existing app: install from npm

If you already have a Next.js (or Hono / Fastify / Express) backend you'd rather extend, pull the packages directly:

npm install @duckviz/db @duckviz/explorer @duckviz/dashboard @duckviz/ui @duckviz/widgets

See the Package Overview for the full dependency graph and the Next.js Integration Guide for the wiring you'd otherwise get for free.

CLI installation

The duckviz CLI ships two subcommands: create-app (scaffolder, above) and <paths...> for pushing local files into your browser session:

npx duckviz ./data.csv

No global install needed — npx downloads it on the fly. See CLI docs for details.