Dakb

🚀 DAKB - 分散型エージェント知識ベース

DAKB（分散型エージェント知識ベース）は、マルチエージェントエコシステムを通じて、企業のチームワークや大規模な研究プロジェクトに対応した、RAG（Retrieval Augmented Generation）を活用した知識共有プラットフォームです。

🚀 クイックスタート

オプション1: PyPI インストール（推奨）

# サーバーとクライアントをインストール
pip install dakb-server dakb-client

# 設定を初期化（~/.dakb/ を作成）
dakb-server init

# サービスを起動
dakb-server start

# ステータスを確認
dakb-server status

# 検証
curl http://localhost:3100/health

オプション2: Docker

# リポジトリをクローン
git clone https://github.com/oracleseed/dakb.git
cd dakb

# 環境テンプレートをコピー
cp docker/.env.example docker/.env
# docker/.env を設定に合わせて編集

# サービスを起動
docker-compose -f docker/docker-compose.yml up -d

# 検証
curl http://localhost:3100/health

オプション3: ソースからのローカルインストール

# クローンしてインストール
git clone https://github.com/oracleseed/dakb.git
cd dakb
pip install -e .

# 依存関係をインストール
pip install -r requirements.txt

# 設定
cp config/default.yaml config/local.yaml
# config/local.yaml を編集

# MongoDB を起動（必須）
# オプション A: ローカル MongoDB
mongod --dbpath /path/to/data

# オプション B: MongoDB のみ Docker を使用
docker run -d -p 27017:27017 --name dakb-mongo mongo:7.0

# DAKB サービスを起動
./scripts/start_dakb.sh

# または手動で:
python -m dakb.embeddings &  # ポート 3101
python -m dakb.gateway       # ポート 3100

オプション4: Python SDK（クライアントのみ）

pip install dakb-client

from dakb_client import DAKBClient

client = DAKBClient(
    base_url="http://localhost:3100",
    auth_token="your-token"
)

# 知識を保存
client.store_knowledge(
    title="API Rate Limit Pattern",
    content="Use exponential backoff...",
    category="backend"
)

# 検索
results = client.search("rate limit handling")

詳細な使用方法については、SDK ドキュメントを参照してください。

オプション5: Claude Code MCP 統合

Claude Code MCP 設定（.mcp.json）に以下を追加します。

{
  "mcpServers": {
    "dakb": {
      "command": "python",
      "args": ["-m", "dakb.mcp"],
      "env": {
        "DAKB_AUTH_TOKEN": "your-token-here",
        "DAKB_GATEWAY_URL": "http://localhost:3100",
        "DAKB_PROFILE": "standard"
      }
    }
  }
}

✨ 主な機能

知識管理

クロスエージェントメッセージング

セッション管理

マルチエージェントサポート

管理ダッシュボード (v1.2.0)

📦 インストール

サーバー + クライアント（推奨）

# 両方のパッケージをインストール
pip install dakb-server dakb-client

# 設定を初期化（シークレットを含む ~/.dakb/ を作成）
dakb-server init

# サービスを起動
dakb-server start

# 検証
curl http://localhost:3100/health

CLI コマンド

クライアントのみ

DAKB サーバーが既に実行されている場合:

pip install dakb-client

from dakb_client import DAKBClient

client = DAKBClient(base_url="http://localhost:3100", auth_token="your-token")
results = client.search("authentication patterns")

💻 使用例

基本的な使用法

from dakb_client import DAKBClient

client = DAKBClient(
    base_url="http://localhost:3100",
    auth_token="your-token"
)

# 知識を保存
client.store_knowledge(
    title="API Rate Limit Pattern",
    content="Use exponential backoff...",
    category="backend"
)

# 検索
results = client.search("rate limit handling")

高度な使用法

# 既存の知識を検索
dakb_search("how to fix CUDA out of memory errors")

# 新しい洞察を保存
dakb_store_knowledge(
    title="CUDA OOM Fix for Large Batch Sizes",
    content="Reduce batch size or use gradient checkpointing...",
    content_type="error_fix",
    category="ml"
)

# 別のエージェントにメッセージを送信
dakb_send_message(
    recipient_id="backend-agent",
    subject="Database schema question",
    content="What's the correct field name for..."
)

📚 ドキュメント

🔧 技術詳細

スキルアーキテクチャ

DAKB は、接続された任意のエージェントが発見して使用できる、集中管理された、検索可能な、バージョン管理されたスキルを有効にします。エージェントの設定にスキルプロンプトを複製する代わりに、DAKB に一度保存し、エージェントが動的に取得できるようにします。

スキルの動作方法

スキルは、content_type: pattern と特殊な命名規則を持つ知識エントリとして保存されます。

# DAKB にスキルを保存
dakb_store_knowledge(
    title="Skill: Code Review",
    content="""
    ## Code Review Skill

    When reviewing code, follow this checklist:
    1. Check for security vulnerabilities (OWASP Top 10)
    2. Verify error handling and edge cases
    3. Ensure consistent code style
    4. Look for performance issues
    5. Validate test coverage

    ## Output Format
    Provide findings in a structured report...
    """,
    content_type="pattern",
    category="backend",
    tags=["skill", "skill-code-review", "version-1.0", "review"]
)

スキルの取得パターン

DAKB に接続された任意のエージェントは、スキルを発見して使用できます。

# ステップ 1: 関連するスキルを検索
results = dakb_search(query="skill code review")

# ステップ 2: 完全なスキルコンテンツを取得
skill = dakb_get_knowledge(knowledge_id="kn_20260107_xxx")

# ステップ 3: 現在のタスクにスキルの指示を適用
# ... エージェントはスキルコンテンツをガイドとして使用 ...

# ステップ 4: フィードバックを提供
dakb_vote(knowledge_id="kn_20260107_xxx", vote="helpful")

DAKB スキルの利点

スキルの命名規則

title: "Skill: <Descriptive Name>"
tags:
  - "skill"              # 必須: スキルとしてマーク
  - "skill-<name>"       # 必須: 一意のスキル識別子
  - "version-X.X"        # 推奨: バージョン追跡
  - "<domain-tags>"      # オプション: ml、backend、devops など
content_type: "pattern"  # 必須: 再利用可能なパターンとして識別
category: "<domain>"     # 必須: データベース、ml、backend など

スキルの例

アーキテクチャ

┌─────────────────────────────────────────────────────────────────────────────────┐
│                    DISTRIBUTED AGENT KNOWLEDGE BASE (DAKB)                       │
├─────────────────────────────────────────────────────────────────────────────────┤
│                                                                                 │
│   CLIENTS (Any Machine / Any LLM)                                               │
│   ┌────────────┐ ┌────────────┐ ┌────────────┐ ┌────────────┐ ┌────────────┐  │
│   │Claude Code │ │ GPT Agent  │ │Gemini Agent│ │ Local LLM  │ │ Grok Agent │  │
│   └─────┬──────┘ └─────┬──────┘ └─────┬──────┘ └─────┬──────┘ └─────┬──────┘  │
│         │              │              │              │              │          │
│         └──────────────┴──────────────┼──────────────┴──────────────┘          │
│                                       │                                         │
│                         ┌─────────────▼─────────────┐                          │
│                         │    MCP / REST / SDK       │                          │
│                         └─────────────┬─────────────┘                          │
│                                       │                                         │
│                    ┌──────────────────▼──────────────────┐                     │
│                    │         DAKB Gateway Service         │                     │
│                    │   (Python FastAPI + REST + Auth)     │                     │
│                    │            Port 3100                 │                     │
│                    └──────────────────┬──────────────────┘                     │
│                                       │                                         │
│         ┌─────────────────────────────┼─────────────────────────────┐          │
│         │                             │                             │          │
│  ┌──────▼──────┐              ┌──────▼──────┐              ┌──────▼──────┐    │
│  │   MongoDB   │              │  Embedding  │              │   FAISS     │    │
│  │  Database   │              │   Service   │              │   Index     │    │
│  │ Port 27017  │              │  Port 3101  │              │  (Vector)   │    │
│  └─────────────┘              └─────────────┘              └─────────────┘    │
│                                                                                 │
└─────────────────────────────────────────────────────────────────────────────────┘

コンポーネント

MongoDB コレクション

📄 ライセンス

Apache License 2.0 - 詳細は LICENSE を参照してください。