Skip to content
NOEMATA

Getting started

Noemata runs as a local stack you drive from one command: noemata up. The CLI scaffolds a project, downloads and manages the services it needs (ClickHouse, an OpenTelemetry collector, and the Noemata UI), detects the tools you already use, and installs dashboards for them — so you go from an empty directory to live data within mere seconds.

If you just want to get going:

Terminal window
npm install -g noemata@canary
noemata up

That’s it — noemata up is the only command you need. On the first run, with no project yet, it walks you through a short setup wizard, then starts the stack and opens the UI in your browser.

After noemata up

You now have a local stack running: ClickHouse storing your data, an OpenTelemetry collector ingesting it, and the Noemata UI open in your browser. Along the way Noemata detected the tools you already use — like Claude Code — started collecting their telemetry, and installed dashboards for them.

Exploring Noemata

If you’ve installed integrations, you’ll immediately be able to see them in your browser. Press Cmd + K or click the magnify icon in the header to see a list of available dashboards. If you’re starting with a clean slate, head over to Authoring Frames.

Configuration

Unless asked otherwise, Noemata will start with sane, local-first defaults. For more advanced use cases, see Project config.