Gonzo - Real-time Log Analysis Terminal UI
Description: A powerful, real-time log analysis terminal UI inspired by k9s. Analyze log streams with beautiful charts, AI-powered insights, and advanced filtering.

## ✨ 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's Main Dashboard

## Stats!

## Heatmaps!

## 🚀 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

-> Download from GitHub Releases

### 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