# Pidgin Documentation

Comprehensive documentation for the Pidgin AI conversation research tool.

## Getting Started

- **[Installation](installation.md)** - Install Pidgin with pip, Poetry, or from source
- **[Quickstart](quickstart.md)** - Run your first conversation in 5 minutes
- **[CLI Usage](cli-usage.md)** - Complete command-line interface reference

## User Guides

- **[YAML Specifications](yaml-specs.md)** - Configure experiments with YAML
- **[Custom Awareness](custom-awareness.md)** - Control agent awareness and context
- **[Extended Thinking](extended-thinking.md)** - Claude reasoning traces and analysis
- **[Analysis & Notebooks](analysis.md)** - Post-experiment analysis and Jupyter notebooks
- **[Branching Workflow](branching_workflow.md)** - Explore alternate conversation paths

## Architecture & Design

- **[Conversation Architecture](conversation-architecture.md)** - Role transformation design
- **[Database Schema](database.md)** - DuckDB schema and query examples
- **[Metrics Reference](metrics.md)** - All 150+ metrics explained

## API Documentation

- **[API Overview](api/index.md)** - Python API introduction
- **[Core API](api/core.md)** - Conductor, agents, and conversations
- **[Providers API](api/providers.md)** - Model providers and customization

## Additional Resources

- **[Man Pages](man/README.md)** - Unix manual pages for all commands
- **[Contributing](../CONTRIBUTING.md)** - How to contribute to Pidgin
- **[Changelog](../CHANGELOG.md)** - Release history and changes