https://github.com/mt4110/maakie-brainlab
LLMの手順をILに正規化して“契約（contract）”として固定し、ガードレール（guardrails）付きで実行。結果は再現可能（deterministic）で、ログや成果物の証拠（evidence）により検証可能（verifiable）にするローカル基盤です。
https://github.com/mt4110/maakie-brainlab
ai go localllm python shell
Last synced: 4 months ago
JSON representation
LLMの手順をILに正規化して“契約（contract）”として固定し、ガードレール（guardrails）付きで実行。結果は再現可能（deterministic）で、ログや成果物の証拠（evidence）により検証可能（verifiable）にするローカル基盤です。
- Host: GitHub
- URL: https://github.com/mt4110/maakie-brainlab
- Owner: mt4110
- Created: 2026-02-08T08:18:41.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-02-25T09:53:24.000Z (4 months ago)
- Last Synced: 2026-02-25T09:59:58.619Z (4 months ago)
- Topics: ai, go, localllm, python, shell
- Language: Python
- Homepage:
- Size: 3.96 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# maakie-brainlab
**maakie-brainlab** は、Maakie AI システムのコード、プロンプト、評価を管理する軽量プロジェクトです。実際のデータやインデックス、モデルを保持する `maakie-brainvault` へのシンボリックリンクを利用して動作します。
> **注意:** 本ソフトウェアは現在開発中（WIP）であり、まだ完成していません。
## 概要とアーキテクチャ
本システムは、AIエージェントの実行と検証ループを促進するために設計されています。複数のエントリーポイントを単一（Canonical）に統合し、一貫性を保つための厳格な検証メカニズムを備えています。
```mermaid
graph TD
A[ユーザー / CI] --> B{il_entry.py (統合エントリーポイント)}
B --> C[Guard / 検証処理]
B --> D[Execution / 実行処理]
B --> E[Verification / 確認処理]
C --> F((.local/obs/ ログ))
D --> F
E --> F
subgraph レガシー (直接実行禁止)
G[il_exec.py] -.-> B
H[il_check.py] -.-> B
I[il_guard.py] -.-> B
end
```
**Stopless (停止しない) アーキテクチャ**: アプリケーションが `sys.exit()` などで強制終了することを禁止しています。代わりに `STOP` 変数と `OK`/`ERROR`/`SKIP` を標準出力に返し、安全な監査を実現します。
**OBS ロギング**: すべての操作は詳細なログを `.local/obs/` に保存します。
## マイルストーンの状況
プロジェクトは多数のマイルストーン（S21系、S22系など）に分かれて進行しており、運用基盤の大部分が完了しています。現状（2026年2月）のステータスは以下の通りです：
**完了 (マージ済み)**: S21-02, S21-03, S21-04, S21-05, S21-06, S21-07, S22-01, S22-03, S22-04, S22-05, S22-06, S22-07, S22-08, S22-09, S22-10, S22-11, S22-12, S22-13, S22-14 (IL入口単一化)
**進行中 / 次のタスク**: AMBI-01, S21-01, S22-02 (レビュー中)
## クイックスタート
システムの真実性を検証する（Gate-1）手順は以下の通りです：
1. **llama-server の起動**（LLM推論用）
2. **インデックスのビルド**
3. **検証の実行**
```bash
# 通常モード (評価を実行)
make gate1
# 検証専用モード (既存の結果をチェックのみ)
bash ops/gate1.sh --verify-only
```
*(配布されたレビューパック内では、`./VERIFY.sh` を実行することで整合性と Gate-1 のパスを確認できます。)*
## ライセンス
本プロジェクトは **商用ライセンス (Commercial License)** の下で提供されています。無断での複製、改変、再配布は禁止されています。（現在は個人開発・内部利用のみを想定しています）