semvec/pypi-packages huggingface dataset:
pitlane-web 0.3.1
Web interface for PitLane AI
License: Apache-2.0
Requires Python: <3.15,>=3.12

# PitLane Web

Web interface for PitLane AI - F1 data analysis powered by AI agents.

## Quick Start

```bash
# Install and run with uvx (recommended)
uvx pitlane-web --env development

# Or install with pip/uv
pip install pitlane-web
pitlane-web --env development
```

## Features

- **Interactive Web UI** - Chat-based interface for F1 data analysis
- **AI-Powered Analysis** - Uses Claude Agent SDK for intelligent F1 insights
- **Session Management** - Isolated workspaces for each analysis session
- **Chart Generation** - Automatic visualization of lap times, tyre strategy, and more
- **Rate Limiting** - Built-in protection against abuse
- **OpenTelemetry Tracing** - Observable agent behavior for debugging

## Usage

### Basic Commands

```bash
# Development mode with auto-reload
uvx pitlane-web --env development

# Custom port
uvx pitlane-web --port 3000

# Production mode
uvx pitlane-web --env production --host 0.0.0.0

# See all options
uvx pitlane-web --help
```

### Environment Variables

- `PITLANE_ENV` - Environment mode (development/production/test)
- `PITLANE_TRACING_ENABLED` - Enable OpenTelemetry tracing (0/1)
- `PITLANE_HTTPS_ENABLED` - Enable secure cookies (true/false)
- `PITLANE_SESSION_MAX_AGE` - Session cookie max age in seconds
- `PITLANE_RATE_LIMIT_ENABLED` - Enable rate limiting (true/false)

### With Tracing

```bash
# Enable tracing to see agent behavior
PITLANE_TRACING_ENABLED=1 uvx pitlane-web --env development
```

## Requirements

- Python 3.12, 3.13, or 3.14
- `pitlane-agent` package (installed automatically as a dependency)

## Architecture

Built with:
- **FastAPI** - Modern web framework
- **Uvicorn** - ASGI server with auto-reload support
- **Jinja2** - Template engine for server-side rendering
- **Claude Agent SDK** - AI agent orchestration
- **FastF1** - F1 data access (via pitlane-agent)

## License

Apache-2.0

## Links

- [GitHub Repository](https://github.com/jshudzina/PitLane-AI)
- [Documentation](https://github.com/jshudzina/PitLane-AI#readme)
- [Issues](https://github.com/jshudzina/PitLane-AI/issues)
pitlane-agent 0.3.1
AI agent for F1 data analysis using Claude Agent SDK and FastF1
License: Apache-2.0
Requires Python: <3.15,>=3.12

# PitLane Agent

AI agent for F1 data analysis using Claude Agent SDK and FastF1.

## Quick Start

```bash
# Install with pip/uv
pip install pitlane-agent

# Create a workspace
pitlane workspace create --workspace-id my-analysis

# Fetch session data
pitlane fetch session-info --workspace-id my-analysis --year 2024 --gp Monaco --session R

# Analyze lap times
pitlane analyze lap-times --workspace-id my-analysis --year 2024 --gp Monaco --session Q --drivers VER --drivers HAM
```

## Features

- **F1 Data Analysis** - Lap times, tyre strategy, race telemetry, and more
- **Skills-Based Architecture** - Specialized skills for different analysis domains
- **Workspace Management** - Isolated analysis sessions with persistent data
- **FastF1 Integration** - Direct access to comprehensive F1 data
- **Chart Generation** - Matplotlib-based visualizations
- **Tool Permissions** - Domain-restricted web access for safe agent operation

## Skills

### f1-analyst
Lap time and tyre strategy analysis with visualizations.

**Examples:**
```bash
pitlane analyze lap-times --workspace-id my-analysis --year 2024 --gp Monaco --session Q
pitlane analyze tyre-strategy --workspace-id my-analysis --year 2024 --gp Monaco --session R
```

### f1-drivers
Driver information queries via the Ergast API.

**Examples:**
```bash
pitlane fetch drivers --year 2024
pitlane fetch driver-info --driver-code VER
```

### f1-schedule
Event calendars and session schedules.

**Examples:**
```bash
pitlane fetch schedule --year 2024
pitlane fetch event-info --year 2024 --round 6
```

## Workspace Management

```bash
# Create workspace
pitlane workspace create --workspace-id my-analysis

# List workspaces
pitlane workspace list

# Get workspace info
pitlane workspace info --workspace-id my-analysis

# Clean old workspaces (older than 7 days)
pitlane workspace clean --older-than 7

# Remove specific workspace
pitlane workspace remove --workspace-id my-analysis
```

## Requirements

- Python 3.12, 3.13, or 3.14
- Claude API key (for AI agent functionality)

## Dependencies

- **Claude Agent SDK** - AI agent orchestration
- **FastF1** - F1 data access and telemetry
- **Matplotlib** - Chart generation
- **Click** - CLI framework
- **OpenTelemetry** - Optional tracing support

## Architecture

The agent uses a skills-based architecture where each skill handles a specific F1 analysis domain:
- Skills invoke Python scripts through the agent's tool system
- FastF1 provides data access and telemetry processing
- Matplotlib generates visualizations
- Tool permissions restrict web access to approved F1 data sources

## License

Apache-2.0

## Links

- [GitHub Repository](https://github.com/jshudzina/PitLane-AI)
- [Documentation](https://github.com/jshudzina/PitLane-AI#readme)
- [Issues](https://github.com/jshudzina/PitLane-AI/issues)