Join our Slack
Gonzo Mascot
Gonzo in action

Gonzo

A powerful, real-time log analysis terminal UI inspired by k9s. Analyze log streams with beautiful charts, AI-powered insights, and advanced filtering - all from your terminal.

Loading… stars
Star on GitHub Star us to stay updated!
Install Now

✨ Key Features

Spend less time debugging, more time shipping.

🎯

Real-Time Analysis

Process logs from multiple sources with OTLP and Victoria Logs native support, automatic format detection, and color-coded severity tracking.

πŸ“ˆ

Interactive Dashboard

k9s-inspired 2x2 grid interface with real-time charts, stay in-flow with vim-style navigation, and expandable modal views for deep log analysis.

πŸ”

Advanced Filtering

Drill down faster, surface what matters with regex support, attribute search, severity filtering, and interactive keyboard/mouse navigation.

πŸ€–

AI-Powered Insights

Get intelligent pattern detection, anomaly analysis, and root cause suggestions. Works with OpenAI, Ollama, LM Studio, and more.

πŸ“‘

Multiple Log Sources

Stream from Victoria Logs, receive via OTLP (OpenTelemetry), tail log files, or pipe from kubectl and other tools.

🎨

Customizable Themes

11+ beautiful themes available including Dracula, Nord, and GitHub Light. Create custom skins with YAML or use ControlTheory's original themes.

See Gonzo in Action

Gonzo Terminal UI animation

Gonzo's Main Dashboard

Gonzo Terminal UI Screenshot

Stats!

Gonzo Terminal UI Screenshot

Heatmaps!

Gonzo Terminal UI Screenshot

πŸš€ Quick Installation

Using Go

Install directly with Go (requires Go 1.21+)

go install github.com/control-theory/gonzo/cmd/gonzo@latest

Using Homebrew

Available on macOS and Linux

brew install gonzo

Download Binary

Get the latest release for your platform

Build from Source

Clone and build the project yourself

git clone https://github.com/control-theory/gonzo.git cd gonzo make build

Quick Start

Start analyzing logs in seconds:

# Analyze logs from a file $ cat application.log | gonzo # Stream Kubernetes logs $ kubectl logs -f deployment/my-app | gonzo # Stream from Victoria Logs $ gonzo --vmlogs-url="http://localhost:9428" --vmlogs-query="*" # Receive OTLP logs $ gonzo --otlp-enabled # With AI analysis $ export OPENAI_API_KEY=sk-your-key-here $ cat logs.json | gonzo