> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clypt.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Community Examples

> Open-source strategy examples contributed by the ClyptQ community

## Overview

The `examples/community/` directory contains open-source Jupyter notebooks contributed by community members. Each notebook demonstrates a quantitative finance concept implemented as a working ClyptQ strategy or analysis.

Community examples are designed to be:

* **Self-contained** — each notebook runs independently with a single `pip install clyptq`
* **Educational** — theoretical background alongside practical implementation
* **Copy-paste ready** — use them as starting points for your own strategies

## How It Works

Community members contribute notebooks to the `examples/community/` directory via pull request. Each notebook follows a consistent structure:

1. **Theory section** — mathematical background and intuition
2. **Implementation** — ClyptQ graph construction with operators
3. **Backtest** — full TradingSpec configuration and execution
4. **Analysis** — performance metrics, visualizations, and interpretation

## Browsing Examples

Browse the community examples on GitHub:

```
examples/community/
├── 01_ornstein_uhlenbeck_mean_reversion.ipynb
├── 02_markowitz_risk_parity_equal_weight.ipynb
├── 03_kelly_criterion_position_sizing.ipynb
├── ...
└── 14_alpha191_comprehensive_backtest.ipynb
```

Topics range from foundational concepts (mean reversion, portfolio optimization, Kelly criterion) through advanced analysis (regime switching, factor models, IC analysis) to comprehensive alpha library backtests (Alpha101, Alpha191).

## Contributing

To contribute a community example:

1. Create a Jupyter notebook in `examples/community/` following the naming convention: `{number}_{descriptive_name}.ipynb`
2. Include theory, implementation, backtest, and analysis sections
3. Submit a pull request

## Related Pages

<CardGroup cols={2}>
  <Card title="First Strategy" icon="graduation-cap" href="/tutorials/first-strategy">
    Official tutorial: build your first strategy step by step
  </Card>

  <Card title="Jupyter Workflow" icon="laptop-code" href="/platform/jupyter-workflow">
    How ClyptQ works inside Jupyter notebooks
  </Card>
</CardGroup>