ChilmAI
ChilmAI は、自治体の保育所利用調整における入所選考処理を支援する Python アプリケーションです。入力データのバリデーション、列名マッピング、きょうだい条件を含むマッチング、結果データの整形を行います。
利用方法や仕様の詳細は ChilmAI ドキュメント を参照してください。
主な構成
| 領域 | パス | 内容 |
|---|---|---|
| コアライブラリ | chilmai/generic |
ファイル読込、列名マッピング、バリデーション、マッチング実行、結果整形 |
| ソルバー | chilmai/algorithm/cp_use_transfer |
OR-Tools CP-SAT を用いたマッチング実装 |
| リファレンス実装 | apps |
FastAPI による HTTP API と Web UI |
| サンプルデータ | sample |
動作確認用の合成データ |
| テストコード | test |
単体テスト、API テスト、ブラウザテスト |
[!WARNING]
apps/以下の Web UI と HTTP API はリファレンス実装です。本番運用に必要な認証、認可、監査ログ、運用監視、データ保護、インフラ設定、脆弱性対応は、利用環境に合わせて別途設計・実装してください。
使い方
Windows で Web UI を試す
Windows 11（64-bit）では、最新リリースの ChilmAI-latest.zip をダウンロードして展開し、ChilmAI.exe を実行すると Web UI を利用できます。インストールや起動時の注意点は自治体の方へのクイックスタートを参照してください。
ライブラリとして利用する
Python 3.11 〜 3.14 の環境に、PyPI からインストールします。パッケージに含まれるのはコアライブラリ（chilmai）のみで、Web UI・HTTP API のリファレンス実装（apps/）とサンプルデータは含まれません。
pip install chilmai
uv でプロジェクトに追加する場合は次のとおりです。
uv add chilmai
ソースコードから利用する
Git、Python 3.11 〜 3.14、uv を用意して、依存関係をインストールします。Web UI を利用する場合は、Microsoft Edge や Google Chrome などのモダンブラウザも必要です。
git clone https://github.com/CyberAgent/ChilmAI.git
cd ChilmAI
uv sync
Python API のサンプルは インストールと実行、Web UI と HTTP API の起動方法は リファレンスアプリ を参照してください。
ドキュメント
コントリビューション
バグ報告、機能提案、ドキュメント改善、Pull Request を歓迎します。参加方法は コントリビューション を参照してください。コミュニティでのやり取りには 行動規範（日本語訳）が適用されます。セキュリティ上の懸念は公開 Issue に投稿せず、セキュリティ に記載された方法で報告してください。
ライセンス
Metadata
Release files for ChilmAI 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| chilmai-0.2.0.tar.gz | 58.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| chilmai-0.2.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 123.8 kB
Release files / chilmai-0.2.0.tar.gz
| Download URL | chilmai-0.2.0.tar.gz |
|---|---|
| Size | 58.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
637dcfd3ba251a8c4d806801d12417196e4dcd89819e8600fe63f0cb7f9688d0
|
|
BLAKE2b-256 checksum How to use checksums |
1cb3e4532bf409269ac0c6cd3bc62ae12e50d329dda1f8b1be7d59821ab1b090
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 26, 2026.
Transparency logRelease files / chilmai-0.2.0-py3-none-any.whl
| Download URL | chilmai-0.2.0-py3-none-any.whl |
|---|---|
| Size | 65.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ec5aefe083b11c40a88ee0153870ac0d6751b82fc4f2ce5486557b925cacc711
|
|
BLAKE2b-256 checksum How to use checksums |
43f147615620f12157c314e14ea91df2a288bb8aebfc7fa011365f8cdaca9a97
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 26, 2026.
Transparency log
