クロノロジー制作ツール
災害時の情報を時系列で整理・可視化するツール。カテゴリ絞り込み・イベント追加・CSV/JSON出力に対応。
🐍 marimo とは
marimo は Python と SQL を統合したオープンソースのリアクティブノートブック環境です。
セルの依存関係を自動追跡し、UI の操作に応じて必要なセルだけが自動で再実行されます。
ノートブックはプレーンな .py ファイルとして保存されるため、Git による差分管理にも適しています。
本リポジトリでは、この marimo を実務で使い倒すための実用的なサンプル集を提供します。 各ノートブックは「デモを開く」で実際の実行結果をブラウザで確認できます。
📚 収録ノートブック
SQL デモ
DuckDB を使った SQL セルのデモ。JOIN / 集計 / ウィンドウ関数 / UI連携を網羅。
データ分析 (EDA)
タイタニック号データを pandas / seaborn / plotly で探索。フィルタ操作がリアクティブに反映。
機械学習パイプライン
scikit-learn でハイパーパラメータをスライダーからライブ調整。評価指標や混同行列が即更新。
AI チャット
mo.ui.chat を使った OpenAI / Gemini 切替式チャット。モデル名や temperature も変更可能。
構造化情報抽出
langextract でテキストから人物名・日付・金額などを Gemini で抽出するデモ。
ニューススクレイパー
Google News の RSS を取得して JSON に保存。実装は共有パッケージに分離。
ニュースダッシュボード
国・言語・件数を選んでニュースを取得し、テーブルとグラフで可視化。
地図ダッシュボード
geopandas + folium で日本のコロプレスマップと都市マーカーを表示。
プレゼンテーション
各セルをスライドにするプレゼンモード。再生ボタンでスライドショーを開始。
marimo vs Jupyter
実行モデル・UI・ファイル形式など、両者の設計思想の違いを比較。
自由帳 (peach)
数学の美しさを味わうノート。モンテカルロ法での π 推定、カオスの分岐図、マンデルブロ集合、ベンフォードの法則を観察。
ユーザーガイド
marimo の基本的な使い方・起動方法をまとめたスタートガイド。
自由帳 (with AI)
folium 地図 / Mermaid / markdown など、多彩な機能を試す自由帳。
🧩 技術スタック
- marimo
- Python 3.13
- uv
- DuckDB / SQL
- pandas / numpy
- matplotlib
- seaborn
- plotly
- scikit-learn
- geopandas / shapely
- folium
- OpenAI / Gemini API
🚀 始め方
このリポジトリは uv を前提としています。
$ uv sync
$ uv run marimo edit sql_demo.py # SQL デモ
$ uv run marimo edit data_analysis.py # データ分析
$ uv run marimo edit ml_pipeline.py # 機械学習
$ uv run marimo edit ai_chat.py # AI チャット
AI 系ノートブックを使う場合は、.env.example を .env にコピーして API キーを設定してください。
$ cp .env.example .env