AAAA-Nexus

信頼できるエージェントのための開発者インフラストラクチャ。 信頼、セキュリティ、コンプライアンス、RAG、決済、エージェントオーケストレーションの19カテゴリにわたる140のMCPツール。

pip install aaaa-nexus-mcp           # Python + Claude / Cursor / Codex MCP
npm install @atomadic/nexus-client   # TypeScript / Node / Deno / Bun
curl https://atomadic.tech/health    # or skip the SDK entirely

無料枠にはキーは不要です。有料機能を利用したい場合は、atomadic.tech/payでキーを取得してください。

なぜエージェントはAAAA-Nexusを直接呼び出すのか

あなたのエージェントはすでにコードを書き、意思決定を行い、トークンを消費しています。しかし、エージェントが自分自身ではできないことがあります：

1. 出力がハルシネーション（幻覚）ではないことを証明する。

2. 悪化する前にドリフト（乖離）を検知する。

3. LoRAアダプターを他のスウォーム（群れ）と共有する。

4. 修正が次のモデルの学習に貢献した際に報酬を得る。

5. 出所証明付きの信頼できるRAGコンテキストを取得する。

6. 改ざん防止されたリント（静的解析）と信頼スコアに基づいて自身のコミットをゲートする。

7. 成果物ベースの納品に対して支払いをエスクローする。

8. EU AI法 Annex IV、GDPR第22条、およびNIST AI-RMFのためにトレースを認証する。

AAAA-Nexusはこれらすべてを行います。HTTPレイヤーで。1回の呼び出しで。

重要な2つのフライホイール

1. 共有LoRA — コードを書きながら稼ぐ

エージェントが生成するすべての (バグのあるコード → 修正) ペアは学習サンプルとなります。これを共有プールに提供することで、以下が得られます：

• 割引または無料のAPI呼び出し（レピュテーション階層に応じた価格設定）

• 承認されたサンプルマイルストーンでの賞品抽選

• リーダーボードへの掲載（atomadic.techで確認可能）

• コミュニティで学習された言語用アダプターへのアクセス

ループは4つの呼び出しで構成されます：

from aaaa_nexus_mcp.client import NexusAPIClient

async with NexusAPIClient(api_key="an_...") as c:
    # 1. Capture locally (free, PII-scrubbed, hash-chained)
    await c.post("/v1/lora/capture", {"bad": bad, "good": good, "language": "python"})

    # 2. Contribute the buffered batch (micro-rebate per accepted sample)
    await c.post("/v1/lora/contribute", {"min_quality": 0.6})

    # 3. Pull the current community adapter
    adapter = await c.get("/v1/lora/adapter/python")

    # 4. Claim your reputation reward
    await c.post("/v1/lora/reward/claim", {"agent_id": "my-agent-001"})

エンドツーエンドのスクリプトについては、examples/lora_flywheel.pyを参照してください。

2. 信頼できるRAGサイクル — 証明がなければ存在しないのと同じ

通常のRAGはベクトルインデックスが返すものを何でも取得しますが、信頼できるRAGは各チャンクを以下に基づいてゲートします：

• ソースドメインの許可リスト

• 有効期限ウィンドウ

• 取得したテキストに対するハルシネーションオラクルの判定

• ライブナレッジグラフに対するドリフトスコア

• 改ざん防止されたレシート（系譜保管庫にチェーンされたSHA-256）

ctx = await c.post("/v1/rag/augment", {
    "query": "latest EU AI Act Annex IV requirements",
    "max_results": 5,
    "freshness_hours": 168,
    "source_policy": "trusted_only",
    "required_domains": ["europa.eu", "nist.gov"],
})
# ctx["results"][i] includes: text, source_url, trust_score, receipt_hash

すべてのレスポンスには {hallucination, drift, guarded_at} という _guard ブロックが付属します。これらのチェックを自分で行う必要はありません。

証明書の発行を含む完全なサイクルについては、examples/trusted_rag.pyを参照してください。

主な機能

合計：19カテゴリにわたる140のツール。 カテゴリごとの正確な内訳は、現在のカタログの公開情報源である docs/TOOLS.md に記載されています。

エージェントが直接呼び出すインフラストラクチャ

1つのベースURL。Bearer認証。JSON入力 / JSON出力。すべてのレスポンスはすでにガードされています。

POST https://atomadic.tech/v1/<category>/<verb>
Authorization: Bearer an_your_key
Content-Type: application/json

MCPプラグイン、Python SDK、npmパッケージ、そして独自のcurl呼び出しはすべて同じインターフェースにアクセスします。SDKのロックインも、独自のワイヤフォーマットも、Bearerヘッダー以外の儀式も必要ありません。

拡張アーキテクトプロンプトパターン

AAAA-Nexusは、あらゆるLLMを、信頼 + LoRA + RAGスタックに接続された自己改善型エージェントに変えるために使用できる3つの運用パターンを文書化しています：

• DADA — Delegator Atomadic Developer Agent（タスクをルーティングし、別のレーンで検証する）

• Atomadic — 意図解釈およびプロンプト洗練

• Autopoetic — 自己修復フィードバックループ

エージェントに意図的に nexus_* ツールを使用させたい場合は、CLAUDE.md、.cursorrules、またはシステムプロンプトフィールドの出発点としてこれらを使用してください。

クイックスタート — レーンを選択してください

1. Claude Code / Cursor / VS Code (MCP)

一度インストールします：

pip install aaaa-nexus-mcp

~/.claude/settings.json またはプロジェクトの .mcp.json に追加します：

{
  "mcpServers": {
    "aaaa-nexus": {
      "command": "python",
      "args": ["-m", "aaaa_nexus_mcp"],
      "env": {
        "AAAA_NEXUS_API_KEY": "an_your_key_here",
        "AAAA_NEXUS_AUTOGUARD": "1"
      }
    }
  }
}

エディタを再起動します。これで140個すべてのツールがチャット内で nexus_* として利用可能になります。セットアップのチェックリストについては docs/ONBOARDING.md を、Cursor、Claude Desktop、VS Code、Zed、Windsurf用の設定については examples/mcp_configs/ を参照してください。

2. Python

pip install aaaa-nexus-mcp

import asyncio
from aaaa_nexus_mcp.client import NexusAPIClient

async def main():
    async with NexusAPIClient(api_key="an_...") as c:
        verdict = await c.post("/v1/oracle/hallucination",
                               {"text": "The moon is made of Swiss cheese."})
    print(verdict)  # {"verdict": "unsafe", "policy_epsilon": ..., "_guard": {...}}

asyncio.run(main())

完全なスクリプト: examples/python_quickstart.py

3. TypeScript / Node / Deno / Bun

npm install @atomadic/nexus-client

import { NexusClient } from "@atomadic/nexus-client";

const nexus = new NexusClient({ apiKey: process.env.AAAA_NEXUS_API_KEY });
const verdict = await nexus.oracle.hallucination({ text: "The moon is made of Swiss cheese." });
console.log(verdict);

完全なスクリプト: examples/typescript_quickstart.ts。より広範なクライアントインターフェースについては docs/INTEGRATION.md を参照してください。

4. curl (任意の言語)

curl -sS https://atomadic.tech/v1/oracle/hallucination \
  -H "Authorization: Bearer $AAAA_NEXUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"The moon is made of Swiss cheese."}'

完全なスクリプト: examples/curl_quickstart.sh

設定

キーなしで動作する無料枠のエンドポイント: /health, /v1/rng/quantum, /v1/agent/card, /v1/metrics。

ドキュメント

• docs/MCP_HTTP_SERVER.md — HTTP MCPサーバー (ストリーミング可能なHTTP、仕様 2025-11-25) — インストール不要、7つのコアツール、x402決済、Claude Desktop HTTP設定

• docs/MCP_CLIENTS.md — stdioパッケージ用のエディタ別セットアップ (Claude, Cursor, VS Code, Zed, Windsurf)

• docs/INTEGRATION.md — 言語別の統合ガイド

• docs/TOOLS.md — 140ツールのツールインデックスおよび価格参照

• docs/LORA_REWARDS.md — 報酬プログラム、リーダーボード、賞品の仕組み

• docs/TRUSTED_RAG.md — RAGサイクル、出所証明、レシート形式

例

• examples/python_quickstart.py

• examples/typescript_quickstart.ts

• examples/curl_quickstart.sh

• examples/lora_flywheel.py — 報酬獲得ループ

• examples/trusted_rag.py — 出所がゲートされた検索

• examples/agent_self_gate.py — 自身のコミットをゲートするエージェント

• examples/mcp_configs/ — すべてのMCPエディタ用のドロップイン設定

ライセンス

ソースパッケージ: MIT。生成されたOpenAPIスキーマ: CC BY-ND 4.0。

MITライセンスは、このリポジトリの内容（Pythonパッケージ、MCP配線、例、およびここで提供される公開ドキュメント）に適用されます。 ホストされているAAAA-Nexusサービス、バックエンド実装、モデル/証明、価格設定インターフェース、およびatomadic.techサイトのコンテンツは、このリポジトリとは別個のものであり、個別にライセンスされているか、プロプライエタリ（非公開）である可能性があります。 Atomadic、AAAA-Nexus、および関連する名称、ロゴ、ブランディングは、MITライセンスの下では許諾されません。