Skip to content

pinoramajs/pinorama

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

266 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Pinorama

Pinorama

Explore your logs smarter and faster
A beautiful yet powerful Node.js log viewer

Build Status Documentation License: MIT


Pinorama is a suite of packages for storing, exploring, and analyzing Pino logs. Pipe logs from any Node.js process, search them instantly with Orama, and explore them in a real-time web UI.

Pinorama Studio

Features

  • Full-text search β€” Powered by Orama with faceted filtering
  • Real-time streaming β€” Pipe logs and watch them appear instantly with Live Mode
  • MCP integration β€” Connect AI assistants to query logs in natural language
  • Keyboard-first β€” Navigate, filter, and inspect logs without touching the mouse
  • Custom styles β€” Color-code log levels, HTTP methods, and any field
  • Fastify plugin β€” Drop-in server with authentication, persistence, and auto-save
  • Presets β€” Built-in schemas for Pino and Fastify logs, or create your own

Quick Start

Install Pinorama Studio globally:

npm i -g pinorama-studio

Pipe logs from any Node.js application:

node app.js | pinorama --open

This starts an embedded server, ingests the piped logs, and opens the Studio UI in your browser.

Packages

Package Description
pinorama-studio Web UI and CLI for viewing, filtering, and analyzing logs
pinorama-server Fastify plugin with REST API, auth, persistence, and MCP
pinorama-transport Pino transport that buffers and streams logs to the server
pinorama-client Isomorphic HTTP client for Node.js and the browser
pinorama-mcp Model Context Protocol server for AI-powered log analysis
pinorama-presets Schema and introspection configs for Pino and Fastify

How It Works

Pino Logger β†’ Transport (buffers) β†’ POST /bulk β†’ Server (Orama) β†’ Studio UI
                                                        ↕
                                                   MCP (AI assistants)
  1. Pino Logger creates structured JSON logs
  2. Pinorama Transport buffers and sends them in batches
  3. Pinorama Server stores and indexes logs with Orama
  4. Pinorama Studio displays logs with search, filters, and live refresh
  5. Pinorama MCP connects AI assistants for natural-language queries

Documentation

Full documentation is available at pinorama.dev.

Contributing

Contributions are welcome! This is a monorepo using pnpm workspaces and Turborepo.

pnpm install   # install dependencies
pnpm build     # build all packages
pnpm test      # run all tests
pnpm dev       # start dev servers

License

MIT

About

Explore your logs smarter and faster πŸŒ€ A sleek and powerful Node.js log viewer.

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

 

Contributors