README.md

---
title: Bayesian Linear Regression Visualizer
emoji: 📈
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: "5.50.0"
python_version: "3.11"
app_file: main.py
fullWidth: true
pinned: false
---

# Bayes Study

ベイズ線形回帰の事前分布・尤度・事後分布を対話的に確認できる Gradio アプリです。  
パラメータ空間 `(w0, w1)` の等高線と、データ空間での回帰直線群を並べて表示します。

## セットアップ

```bash
uv sync
```

Hugging Face Spaces では `README.md` の frontmatter と `requirements.txt` を使ってデプロイされます。

## 起動

```bash
uv run python main.py
```

ブラウザを自動で開く場合:

```bash
uv run python main.py --browser
```

ホストやポートを指定する場合:

```bash
uv run python main.py --server-name 0.0.0.0 --server-port 7860
```

## アプリでできること

- 事前平均、事前標準偏差、相関係数からガウス事前分布を設定
- 真の切片、真の傾き、観測ノイズからデータを生成
- 使用サンプル数 `N` を変えて事後分布の収束を確認
- prior / posterior からサンプルした回帰直線群を比較
- 尤度等高線をパラメータ空間に重ねて表示