qbrix 0.1.3__tar.gz

qbrix-0.1.3/.codegraph/.gitignore

@@ -0,0 +1,16 @@
+# CodeGraph data files
+# These are local to each machine and should not be committed
+
+# Database
+*.db
+*.db-wal
+*.db-shm
+
+# Cache
+cache/
+
+# Logs
+*.log
+
+# Hook markers
+.dirty

qbrix-0.1.3/.codegraph/config.json

@@ -0,0 +1,140 @@
+{
+  "version": 1,
+  "include": [
+    "**/*.ts",
+    "**/*.tsx",
+    "**/*.js",
+    "**/*.jsx",
+    "**/*.py",
+    "**/*.go",
+    "**/*.rs",
+    "**/*.java",
+    "**/*.c",
+    "**/*.h",
+    "**/*.cpp",
+    "**/*.hpp",
+    "**/*.cc",
+    "**/*.cxx",
+    "**/*.cs",
+    "**/*.php",
+    "**/*.rb",
+    "**/*.swift",
+    "**/*.kt",
+    "**/*.kts",
+    "**/*.dart",
+    "**/*.svelte",
+    "**/*.liquid",
+    "**/*.pas",
+    "**/*.dpr",
+    "**/*.dpk",
+    "**/*.lpr",
+    "**/*.dfm",
+    "**/*.fmx"
+  ],
+  "exclude": [
+    "**/.git/**",
+    "**/node_modules/**",
+    "**/vendor/**",
+    "**/Pods/**",
+    "**/dist/**",
+    "**/build/**",
+    "**/out/**",
+    "**/bin/**",
+    "**/obj/**",
+    "**/target/**",
+    "**/*.min.js",
+    "**/*.bundle.js",
+    "**/.next/**",
+    "**/.nuxt/**",
+    "**/.svelte-kit/**",
+    "**/.output/**",
+    "**/.turbo/**",
+    "**/.cache/**",
+    "**/.parcel-cache/**",
+    "**/.vite/**",
+    "**/.astro/**",
+    "**/.docusaurus/**",
+    "**/.gatsby/**",
+    "**/.webpack/**",
+    "**/.nx/**",
+    "**/.yarn/cache/**",
+    "**/.pnpm-store/**",
+    "**/storybook-static/**",
+    "**/.expo/**",
+    "**/web-build/**",
+    "**/ios/Pods/**",
+    "**/ios/build/**",
+    "**/android/build/**",
+    "**/android/.gradle/**",
+    "**/__pycache__/**",
+    "**/.venv/**",
+    "**/venv/**",
+    "**/site-packages/**",
+    "**/dist-packages/**",
+    "**/.pytest_cache/**",
+    "**/.mypy_cache/**",
+    "**/.ruff_cache/**",
+    "**/.tox/**",
+    "**/.nox/**",
+    "**/*.egg-info/**",
+    "**/.eggs/**",
+    "**/go/pkg/mod/**",
+    "**/target/debug/**",
+    "**/target/release/**",
+    "**/.gradle/**",
+    "**/.m2/**",
+    "**/generated-sources/**",
+    "**/.kotlin/**",
+    "**/.dart_tool/**",
+    "**/.vs/**",
+    "**/.nuget/**",
+    "**/artifacts/**",
+    "**/publish/**",
+    "**/cmake-build-*/**",
+    "**/CMakeFiles/**",
+    "**/bazel-*/**",
+    "**/vcpkg_installed/**",
+    "**/.conan/**",
+    "**/Debug/**",
+    "**/Release/**",
+    "**/x64/**",
+    "**/release/**",
+    "**/*.app/**",
+    "**/*.asar",
+    "**/DerivedData/**",
+    "**/.build/**",
+    "**/.swiftpm/**",
+    "**/xcuserdata/**",
+    "**/Carthage/Build/**",
+    "**/SourcePackages/**",
+    "**/__history/**",
+    "**/__recovery/**",
+    "**/*.dcu",
+    "**/.composer/**",
+    "**/storage/framework/**",
+    "**/bootstrap/cache/**",
+    "**/.bundle/**",
+    "**/tmp/cache/**",
+    "**/public/assets/**",
+    "**/public/packs/**",
+    "**/.yardoc/**",
+    "**/coverage/**",
+    "**/htmlcov/**",
+    "**/.nyc_output/**",
+    "**/test-results/**",
+    "**/.coverage/**",
+    "**/.idea/**",
+    "**/logs/**",
+    "**/tmp/**",
+    "**/temp/**",
+    "**/_build/**",
+    "**/docs/_build/**",
+    "**/site/**"
+  ],
+  "languages": [],
+  "frameworks": [],
+  "maxFileSize": 1048576,
+  "extractDocstrings": true,
+  "trackCallSites": true,
+  "enableEmbeddings": false
+}

qbrix-0.1.3/.env.example

@@ -0,0 +1 @@
+QBRIX_API_KEY=

qbrix-0.1.3/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,28 @@
+## Summary
+
+<!-- What does this PR do? 1-3 sentences on the change and motivation. -->
+
+## Type of change
+
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Breaking change
+- [ ] Refactor / internal improvement
+- [ ] Docs / tooling
+
+## Changes
+
+<!-- Bullet list of concrete changes made. -->
+
+## Testing
+
+- [ ] Existing tests pass (`uv run pytest`)
+- [ ] New tests added for new behaviour
+- [ ] Manually verified against the proxy service
+
+## Checklist
+
+- [ ] Public API surface in `__init__.py` updated if needed
+- [ ] Type annotations correct (`uv run mypy qbrix/`)
+- [ ] No new `None` kwargs shadowing env-var config
+- [ ] Breaking changes documented in summary above

qbrix-0.1.3/.github/workflows/ci.yml

@@ -0,0 +1,64 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Run tests
+        run: uv run pytest --cov=qbrix --cov-report=json
+
+      - name: Upload coverage artifact
+        if: matrix.python-version == '3.13'
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-report
+          path: coverage.json
+
+  coverage-badge:
+    needs: test
+    runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/main' && github.event_name == 'push'
+    steps:
+      - name: Download coverage artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: coverage-report
+
+      - name: Extract coverage percentage
+        id: cov
+        run: |
+          COV=$(python3 -c "import json; print(round(json.load(open('coverage.json'))['totals']['percent_covered']))")
+          echo "coverage=$COV" >> "$GITHUB_OUTPUT"
+
+      - name: Update coverage badge
+        uses: schneegans/dynamic-badges-action@v1.7.0
+        with:
+          auth: ${{ secrets.GIST_SECRET }}
+          gistID: ${{ vars.COVERAGE_GIST_ID }}
+          filename: qbrix-coverage.json
+          label: coverage
+          message: ${{ steps.cov.outputs.coverage }}%
+          valColorRange: ${{ steps.cov.outputs.coverage }}
+          minColorRange: 50
+          maxColorRange: 90

qbrix-0.1.3/.github/workflows/publish.yml

@@ -0,0 +1,37 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types:
+      - published
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v5
+
+      - run: uv build
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: astral-sh/setup-uv@v5
+
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - run: uv publish dist/*

qbrix-0.1.3/.github/workflows/release-please.yml

@@ -0,0 +1,24 @@
+name: Release Please
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  release-please:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/create-github-app-token@v1
+        id: app-token
+        with:
+          app-id: ${{ secrets.APP_ID }}
+          private-key: ${{ secrets.APP_PRIVATE_KEY }}
+
+      - uses: googleapis/release-please-action@v4
+        with:
+          token: ${{ steps.app-token.outputs.token }}

qbrix-0.1.3/.gitignore

@@ -0,0 +1,34 @@
+# python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg
+*.egg-info/
+dist/
+build/
+.eggs/
+
+# venv
+.venv/
+venv/
+env/
+
+# testing
+.coverage
+htmlcov/
+.pytest_cache/
+
+# ide
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# os
+.DS_Store
+Thumbs.db
+
+# build
+.pdm-build/

qbrix-0.1.3/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.1.3"
+}

qbrix-0.1.3/CHANGELOG.md

@@ -0,0 +1,26 @@
+# Changelog
+
+## [0.1.3](https://github.com/optiq-io/qbrix-python/compare/v0.1.2...v0.1.3) (2026-03-12)
+
+
+### Features
+
+* create release github app and integrate ([6ecbf3b](https://github.com/optiq-io/qbrix-python/commit/6ecbf3b2f4c2bc1de61c094913e4b485dc346090))
+
+## [0.1.2](https://github.com/optiq-io/qbrix-python/compare/v0.1.1...v0.1.2) (2026-03-05)
+
+
+### Features
+
+* created mod client and lazy proxy implementations ([e520223](https://github.com/optiq-io/qbrix-python/commit/e52022372ad48153168a6568f5929c0e6c8b389c))
+* match proxy gate svc endpoint model changes to the sdk ([7d2e0a2](https://github.com/optiq-io/qbrix-python/commit/7d2e0a252f9183a470af88d8559d949da7be3d34))
+* moved the resource file to base ([06dec0d](https://github.com/optiq-io/qbrix-python/commit/06dec0de9718afb0cfe1063142f2cccd80ec8e8a))
+* update base client add deps ([97983d9](https://github.com/optiq-io/qbrix-python/commit/97983d9d531127d88cda44ae3c51fbc17b6e59f2))
+* update ci flow to add automated test coverage ([db5f985](https://github.com/optiq-io/qbrix-python/commit/db5f9851e9c2caf3b8fbd33a8d94e302588dec1f))
+
+## [0.1.1](https://github.com/optiq-io/qbrix-python/compare/v0.1.0...v0.1.1) (2026-03-01)
+
+
+### Features
+
+* update README.md ([d4106c4](https://github.com/optiq-io/qbrix-python/commit/d4106c4d78fc7515c56093a7cdb9ce1882ba6350))

qbrix-0.1.3/CLAUDE.md

@@ -0,0 +1,114 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## What This Is
+
+Python SDK for the Qbrix distributed computing platform — a multi-armed bandit system for site variant optimisation. The SDK wraps the Qbrix proxy service HTTP API (`proxysvc`), providing typed sync and async clients for pool/experiment/gate management and the agent select/feedback loop.
+
+The upstream proxy service lives at `../qbrix/svc/proxy` — consult it for API endpoint behavior, request/response shapes, and feature gate evaluation logic.
+
+## Commands
+
+```bash
+# Install dependencies (uses uv, not pip)
+uv sync
+
+# Run all tests
+uv run pytest
+
+# Run a single test file
+uv run pytest tests/test_resource_pool.py
+
+# Run a single test by name
+uv run pytest tests/test_resource_pool.py -k "test_create_pool"
+
+# Run only unit tests
+uv run pytest -m unit
+
+# Run with coverage
+uv run pytest --cov=qbrix
+
+# Format
+uv run black .
+
+# Type checking (package is PEP 561 typed)
+uv run mypy qbrix/
+```
+
+## Architecture
+
+The SDK follows a layered client → resource → model pattern, with sync and async variants throughout.
+
+### Client Layer (`_base_client.py`, `_client.py`)
+
+```
+Qbrix / AsyncQbrix                    ← public entry points (users import these)
+    ↓ inherits
+SyncAPIClient / AsyncAPIClient         ← HTTP logic, retry, error mapping
+    ↓ wraps
+httpx.Client / httpx.AsyncClient       ← actual HTTP transport
+```
+
+`Qbrix` and `AsyncQbrix` expose resources as `@cached_property` — lazily instantiated on first access. The client itself IS the transport (no separate transport layer, despite what SDK-DESIGN.md describes — that abstraction was collapsed during implementation).
+
+**Key divergences from SDK-DESIGN.md:** Client classes are `Qbrix`/`AsyncQbrix` (not `QbrixClient`/`AsyncQbrixClient`). Resource accessors are singular: `client.pool`, `client.experiment`, `client.gate`, `client.agent` (not plural). No `transport/` package exists.
+
+### Resource Layer (`_resource.py`, `resource/`)
+
+Each resource file defines both sync and async variants (`PoolResource`/`AsyncPoolResource`, etc.). Resources hold a reference to the client and delegate HTTP calls through `_get`, `_post`, `_put`, `_patch`, `_delete` helpers from `SyncAPIResource`/`AsyncAPIResource`.
+
+**`cast_to` pattern:** Resource methods pass `cast_to=ModelClass` to the client's `request()` method, which calls `ModelClass.model_validate(data)` on the JSON response. Methods that don't need a response model (like `delete`, `feedback`) omit `cast_to`.
+
+**Dual input types:** All resource methods accept both Pydantic models and raw dicts (e.g., `arms: list[dict | ArmCreate]`, `context: Context | dict`). Serialization uses `isinstance` checks.
+
+### Model Layer (`model/`)
+
+All models are Pydantic v2 `BaseModel` subclasses. Request models (e.g., `PoolCreate`, `ExperimentCreate`) and response models (e.g., `Pool`, `Experiment`) are separate classes. `PaginatedResponse[T]` is a generic wrapper with `items`, `limit`, `offset`, and a `has_more` computed property.
+
+### Config (`_config.py`)
+
+`QbrixConfig` extends `pydantic-settings.BaseSettings` with `env_prefix="QBRIX_"`. Resolution order: constructor kwargs → env vars (`QBRIX_API_KEY`, `QBRIX_BASE_URL`, etc.) → defaults. The `BaseClient.__init__` filters out `None` kwargs before passing to `QbrixConfig` so that env vars aren't shadowed by explicit `None`.
+
+### Error Handling (`exception.py`)
+
+`_base_client._make_status_error()` parses JSON response for `detail` and `context` fields, maps status codes via `STATUS_CODE_TO_EXCEPTION` dict. Unknown status codes fall back to `QbrixAPIError`. `RateLimitedError` parses `Retry-After` header. Network errors map to `QbrixConnectionError`/`QbrixTimeoutError`.
+
+## Proxy API Reference
+
+The SDK targets these proxy endpoints (all under `/api/v1`):
+
+- **Pools:** `POST/GET/PATCH/DELETE /pools[/{id}]`, `GET /pools/{id}/experiments`
+- **Experiments:** `POST/GET/PATCH/DELETE /experiments[/{id}]` — supports `?search=&enabled=` filters
+- **Gates:** `POST/GET/PUT/DELETE /gates/{experiment_id}` — note: update is `PUT` (full replace), not `PATCH`
+- **Agent:** `POST /agent/select`, `POST /agent/feedback`
+
+### Supported Policies
+
+Experiment `policy` field values (must match exactly): `BetaTSPolicy`, `GaussianTSPolicy`, `UCB1TunedPolicy`, `KLUCBPolicy`, `EpsilonPolicy`, `MOSSPolicy`, `MOSSAnyTimePolicy`, `LinUCBPolicy`, `LinTSPolicy`, `EXP3Policy`, `FPLPolicy`.
+
+Contextual policies (`LinUCBPolicy`, `LinTSPolicy`) require `context.vector` with length matching the `dim` policy param.
+
+### Agent Select/Feedback Loop
+
+1. `POST /agent/select` → gate evaluation (if configured) → bandit selection → returns `{arm, request_id, is_default}`
+2. `request_id` is an HMAC-signed opaque token — store it, pass it unchanged to feedback
+3. `POST /agent/feedback` with `{request_id, reward}` → publishes to learning stream
+4. `is_default: true` means the gate committed an arm (bypassed bandit)
+
+### Feature Gate Evaluation Order
+
+Gate checks: enabled → schedule (date range) → active hours → rollout percentage (hash-based) → rules (first match wins). Any negative check → return `default_arm`, skip bandit.
+
+## Testing Patterns
+
+Tests use a `MockSyncClient`/`MockAsyncClient` infrastructure (in `conftest.py`) that subclasses the real API client and replaces the httpx client with a mock. Use `mock_client.enqueue({...})` to stage responses and `mock_client.calls[n]` to assert request method/path/body.
+
+Async tests use `@pytest.mark.asyncio` on the class. Test markers: `unit`, `integration`, `slow`.
+
+## Conventions
+
+- Internal modules are prefixed with `_` (e.g., `_base_client.py`, `_config.py`, `_resource.py`)
+- Public API surface is defined in `__init__.py` — keep it updated when adding models/exceptions
+- Python ≥ 3.10 required (uses `X | Y` union syntax)
+- Dependencies: `httpx`, `pydantic`, `pydantic-settings` (runtime); `pytest`, `pytest-asyncio`, `pytest-mock`, `pytest-cov`, `black`, `pre-commit` (dev)

qbrix-0.1.3/PKG-INFO

@@ -0,0 +1,195 @@
+Metadata-Version: 2.4
+Name: qbrix
+Version: 0.1.3
+Summary: Python SDK for the qbrix multi-armed bandit platform
+Author-email: Optiq <hello@qbrix.io>
+License-Expression: MIT
+Keywords: a/b testing,bandit,experimentation,mab,optimization
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: click>=8.3.1
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: pydantic-settings>=2.13.1
+Requires-Dist: pydantic>=2.12.5
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="./asset/logo/bb_logo.svg" alt="Qbrix" width="280">
+</p>
+
+<p align="center">
+  <strong>Python SDK for the qbrix platform.</strong>
+</p>
+
+<p align="center">
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License"></a>
+  <img src="https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/eskinmi/c7d91705ef877065365d0febc49e0ea9/raw/qbrix-coverage.json" alt="Coverage">
+  <img src="https://img.shields.io/badge/python-3.10%2B-3776AB?logo=python&logoColor=white" alt="Python 3.10+">
+  <img src="https://img.shields.io/badge/pydantic-v2-e92063?logo=pydantic&logoColor=white" alt="Pydantic v2">
+  <img src="https://img.shields.io/badge/httpx-async%20%2B%20sync-1e88e5" alt="httpx">
+</p>
+
+
+---
+
+Typed sync and async clients for [Qbrix](https://github.com/optiq-io/qbrix) — pool/experiment/gate management and the agent select/feedback loop.
+
+## Installation
+
+```bash
+pip install qbrix
+```
+
+## Quick Start
+
+Set your credentials as environment variables and call resources directly — no client instantiation needed:
+
+```bash
+export QBRIX_API_KEY="optiq_xxx"
+export QBRIX_BASE_URL="https://api.qbrix.io"
+```
+
+```python
+import qbrix
+
+# 1. Create a pool of arms (variants)
+pool = qbrix.pool.create(
+    name="homepage-buttons",
+    arms=[{"name": "blue"}, {"name": "green"}, {"name": "red"}],
+)
+
+# 2. Create an experiment with a bandit policy
+exp = qbrix.experiment.create(
+    name="button-color-test",
+    pool_id=pool.id,
+    policy="BetaTSPolicy",
+)
+
+# 3. Select an arm for a user
+result = qbrix.agent.select(
+    experiment_id=exp.id,
+    context={"id": "user-123", "metadata": {"country": "US"}},
+)
+print(result.arm.name)       # "green"
+print(result.is_default)     # False (bandit selected)
+
+# 4. Send feedback (reward) after observing the outcome
+qbrix.agent.feedback(request_id=result.request_id, reward=1.0)
+```
+
+The system learns from every reward and adjusts future selections automatically.
+
+## Explicit Client
+
+For full control over configuration or lifecycle (e.g. closing the HTTP connection, using a context manager), instantiate the client directly:
+
+```python
+from qbrix import Qbrix
+
+with Qbrix(api_key="optiq_xxx", base_url="https://api.qbrix.io") as client:
+    pool = client.pool.create(
+        name="homepage-buttons",
+        arms=[{"name": "blue"}, {"name": "green"}, {"name": "red"}],
+    )
+    result = client.agent.select(experiment_id="exp-uuid", context={"id": "user-123"})
+    client.agent.feedback(request_id=result.request_id, reward=1.0)
+```
+
+## Async
+
+```python
+from qbrix import AsyncQbrix
+
+async with AsyncQbrix(api_key="optiq_xxx") as client:
+    result = await client.agent.select(
+        experiment_id="exp-uuid",
+        context={"id": "user-456"},
+    )
+    await client.agent.feedback(request_id=result.request_id, reward=1.0)
+```
+
+## Configuration
+
+Constructor kwargs take priority over environment variables, which take priority over defaults.
+
+```bash
+export QBRIX_API_KEY="optiq_xxx"
+export QBRIX_BASE_URL="https://api.qbrix.io"
+```
+
+```python
+from qbrix import Qbrix
+
+client = Qbrix()  # picks up env vars automatically
+```
+
+| Env Var | Default | Description |
+|---------|---------|-------------|
+| `QBRIX_API_KEY` | `None` | API key (`optiq_xxx`) |
+| `QBRIX_BASE_URL` | `http://localhost:8080` | Proxy service URL |
+| `QBRIX_TIMEOUT` | `30.0` | Request timeout (seconds) |
+| `QBRIX_MAX_RETRIES` | `3` | Retry count on 429/5xx |
+
+## Feature Gates
+
+Attach a feature gate to control rollout before the bandit kicks in:
+
+```python
+import qbrix
+
+qbrix.gate.create(
+    experiment_id=exp.id,
+    enabled=True,
+    rollout_percentage=80.0,
+    default_arm_id=pool.arms[0].id,
+    rules=[
+        {"key": "plan", "operator": "==", "value": "enterprise", "arm_id": pool.arms[1].id},
+    ],
+)
+
+# Gate-matched selections return is_default=True
+result = qbrix.agent.select(
+    experiment_id=exp.id,
+    context={"id": "user-789", "metadata": {"plan": "enterprise"}},
+)
+print(result.is_default)  # True
+```
+
+## Error Handling
+
+```python
+import qbrix
+from qbrix import NotFoundError, RateLimitedError
+
+try:
+    exp = qbrix.experiment.get("nonexistent-id")
+except NotFoundError as e:
+    print(f"Not found: {e.detail}")
+except RateLimitedError as e:
+    print(f"Retry after {e.retry_after}s")
+```
+
+## Supported Policies
+
+| Policy             | Type        | Best For                             |
+|--------------------|-------------|--------------------------------------|
+| `BetaTSPolicy`     | Stochastic  | Binary rewards (clicks, conversions) |
+| `GaussianTSPolicy` | Stochastic  | Continuous rewards                   |
+| `UCB1TunedPolicy`  | Stochastic  | Theoretical regret guarantees        |
+| `KLUCBPolicy`      | Stochastic  | Binary rewards with tight bounds     |
+| `MOSSPolicy`       | Stochastic  | Fixed horizon problems               |
+| `LinUCBPolicy`     | Contextual  | Linear reward models with features   |
+| `LinTSPolicy`      | Contextual  | Linear models with uncertainty       |
+| `EXP3Policy`       | Adversarial | Non-stationary environments          |
+| `FPLPolicy`        | Adversarial | Follow the perturbed leader          |
+
+## License
+
+[MIT](LICENSE)