Metadata-Version: 2.4
Name: sbom-insight
Version: 0.1.11
Summary: Add your description here
Requires-Python: >=3.12
Requires-Dist: claude-agent-sdk>=0.1.0
Requires-Dist: clickhouse-connect>=0.7.0
Requires-Dist: clickhouse-connect>=0.7.16
Requires-Dist: dotenv>=0.9.9
Requires-Dist: mcp>=1.26.0
Requires-Dist: pandas>=2.0.0
Requires-Dist: prompt-toolkit>=3.0.0
Requires-Dist: pygithub>=2.8.1
Requires-Dist: ratelimit>=2.2.1
Requires-Dist: requests-cache>=1.3.0
Requires-Dist: requests>=2.32.5
Requires-Dist: rich>=14.3.2
Requires-Dist: structlog>=24.0.0
Requires-Dist: textual>=7.5.0
Requires-Dist: typer>=0.21.1
Description-Content-Type: text/markdown

# SBOM Insight

![Demo](figures/demo.gif)

**SBOM Insight** CLI tool for deep insights into Software Bill of Materials (SBOM) data.

## Key Features

- **Search**: Find high-quality repos on GitHub (stars/language).
- **Download**: Fetch SBOM files (`go.mod`, `pom.xml`, etc.).
- **Import**: Load metadata into ClickHouse.
- **Query**: Analyze library usage and framework stats.
- **Agent**: AI-powered TUI for natural language queries.

## Quick Start

### Prerequisites

- [uv](https://github.com/astral-sh/uv)
- Docker & Docker Compose (for the database)

### Installation

```bash
# Start infrastructure (ClickHouse)
docker compose up -d
```

### Usage

Run commands directly with `uvx`:

```bash
# 1. Search Github (e.g., top Go repos)
uvx sbom-insight search-github --language go --min-stars 1000 --output data/go.jsonl

# 2. Download SBOMs
uvx sbom-insight download-sbom --language go --input-file data/go.jsonl --output-dir data

# 3. Import Data
uvx sbom-insight import --language go

# 4. Query & Summarize
uvx sbom-insight query requests
uvx sbom-insight summarize

# 5. Launch AI Agent
uvx sbom-insight agent
```

## Configuration

Copy `.env.example` to `.env` and set `ANTHROPIC_API_KEY` for the agent.
