# mixpanel_data

> Python library for working with Mixpanel analytics data, designed for AI coding agents

mixpanel_data is a complete programmable interface to Mixpanel analytics.
Python library and CLI for discovery, querying, and data extraction.
Discover your schema, run live analytics (segmentation, funnels, retention),
execute JQL, and analyze locally with SQL via DuckDB.


## Getting Started

- [Home](https://jaredmcfarland.github.io/mixpanel_data/index.md): Project overview and key concepts
- [Installation](https://jaredmcfarland.github.io/mixpanel_data/getting-started/installation/index.md): Install with pip or uv
- [Quick Start](https://jaredmcfarland.github.io/mixpanel_data/getting-started/quickstart/index.md): First queries in 5 minutes
- [Configuration](https://jaredmcfarland.github.io/mixpanel_data/getting-started/configuration/index.md): Accounts, env vars, config files

## User Guide

- [Fetching Data](https://jaredmcfarland.github.io/mixpanel_data/guide/fetching/index.md): Fetch events and profiles to DuckDB
- [Streaming Data](https://jaredmcfarland.github.io/mixpanel_data/guide/streaming/index.md): Stream data without storage for ETL
- [Local SQL Queries](https://jaredmcfarland.github.io/mixpanel_data/guide/sql-queries/index.md): Query with DuckDB SQL and JSON operators
- [Live Analytics](https://jaredmcfarland.github.io/mixpanel_data/guide/live-analytics/index.md): Segmentation, funnels, retention, JQL
- [Data Discovery](https://jaredmcfarland.github.io/mixpanel_data/guide/discovery/index.md): Explore schema, events, properties, cohorts

## API Reference

- [Overview](https://jaredmcfarland.github.io/mixpanel_data/api/index.md): Python API overview
- [Workspace](https://jaredmcfarland.github.io/mixpanel_data/api/workspace/index.md): Workspace class - main entry point
- [Auth](https://jaredmcfarland.github.io/mixpanel_data/api/auth/index.md): Authentication and credentials
- [Exceptions](https://jaredmcfarland.github.io/mixpanel_data/api/exceptions/index.md): Exception hierarchy
- [Result Types](https://jaredmcfarland.github.io/mixpanel_data/api/types/index.md): Result types (SegmentationResult, etc.)

## CLI Reference

- [Overview](https://jaredmcfarland.github.io/mixpanel_data/cli/index.md): CLI overview and output formats
- [Commands](https://jaredmcfarland.github.io/mixpanel_data/cli/commands/index.md): Complete command reference

## Architecture

- [Design](https://jaredmcfarland.github.io/mixpanel_data/architecture/design/index.md): Layered architecture and services
- [Data Model](https://jaredmcfarland.github.io/mixpanel_data/architecture/data-model/index.md): Event and profile data model
- [Storage Engine](https://jaredmcfarland.github.io/mixpanel_data/architecture/storage/index.md): DuckDB storage engine