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. 자신의 출력이 환각(hallucination)이 아님을 증명하기.

2. 드리프트(drift)가 복합적으로 발생하기 전에 감지하기.

3. 스웜(swarm)의 나머지 부분과 LoRA 어댑터를 공유하기.

4. 자신의 수정 사항이 다음 모델을 학습시킬 때 보상을 받기.

5. 출처 증명 영수증과 함께 신뢰할 수 있는 RAG 컨텍스트 가져오기.

6. 변조 방지 린트(lint) 및 신뢰 점수를 기반으로 자신의 커밋을 게이트하기.

7. 결과 기반 전달에 대한 결제 에스크로 설정하기.

8. EU AI 법 Annex IV, GDPR Art. 22 및 NIST AI-RMF에 대한 추적 인증하기.

AAAA-Nexus는 이 모든 것을 수행합니다. HTTP 계층에서. 단 한 번의 호출로 말이죠.

중요한 두 가지 플라이휠

1. 공유 LoRA — 코딩하면서 수익 창출

에이전트가 생성하는 모든 (buggy_code → fix) 쌍은 학습 샘플입니다. 이를 공유 풀에 기여하면 다음과 같은 혜택을 얻을 수 있습니다:

• 할인 또는 무료 API 호출 (평판 등급별 가격 책정)

• 승인된 샘플 마일스톤에 대한 경품 추첨

• 리더보드 배치 (atomadic.tech에서 확인 가능)

• 귀하의 언어에 대한 커뮤니티 학습 어댑터 액세스

루프는 네 번의 호출로 이루어집니다:

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

모든 응답은 _guard 블록과 함께 제공됩니다: {hallucination, drift, guarded_at}. 직접 이러한 검사를 실행할 필요가 없습니다.

인증서 발행을 포함한 전체 주기는 examples/trusted_rag.py를 참조하세요.

주요 기능

총합: 19개 카테고리에 걸친 140개 도구. 카테고리별 상세 내역은 현재 카탈로그의 공개 진실 소스인 docs/TOOLS.md에 있습니다.

에이전트가 직접 호출하는 인프라

하나의 기본 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 스택에 연결된 자기 개선 에이전트로 전환하는 데 사용할 수 있는 세 가지 운영 패턴을 문서화합니다:

• 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 하에 부여되지 않습니다.