AAAA-Nexus

Инфраструктура разработчика для надежных агентов. 140 инструментов MCP в 19 категориях для обеспечения доверия, безопасности, соответствия требованиям, RAG, платежей и оркестрации агентов.

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 Act 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 для полного цикла, включая выдачу сертификатов.

Ключевые возможности

Всего: 140 инструментов в 19 категориях. Точная разбивка по категориям находится в 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 — Самовосстанавливающийся цикл обратной связи

Используйте их в качестве отправных точек в вашем CLAUDE.md, .cursorrules или поле системного промпта, когда хотите, чтобы агент намеренно использовал инструменты nexus_*.

Быстрый старт — выберите свой путь

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 для контрольного списка настройки и examples/mcp_configs/ для Cursor, Claude Desktop, VS Code, Zed и Windsurf.

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.