AAAA-Nexus

Infraestructura de desarrollo para agentes confiables. 140 herramientas MCP en 19 categorías para confianza, seguridad, cumplimiento, RAG, pagos y orquestación de agentes.

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

No se necesita clave para el nivel gratuito. Obtenga una en atomadic.tech/pay cuando desee la superficie de pago.

Por qué los agentes llaman a AAAA-Nexus directamente

Su agente ya está escribiendo código, tomando decisiones y gastando tokens. Lo que no puede hacer por sí mismo:

1. Probar que sus resultados no son alucinaciones.

2. Detectar desviaciones antes de que se agraven.

3. Compartir un adaptador LoRA con el resto del enjambre.

4. Ganar recompensas cuando sus correcciones entrenan al siguiente modelo.

5. Obtener contexto RAG confiable con recibos de procedencia.

6. Bloquear sus propios commits mediante un lint + puntuación de confianza a prueba de manipulaciones.

7. Depositar un pago en garantía basado en la entrega de resultados.

8. Certificar su trazabilidad para el Anexo IV de la Ley de IA de la UE, el Art. 22 del RGPD y el NIST AI-RMF.

AAAA-Nexus hace todo eso. En la capa HTTP. En una sola llamada.

Los dos volantes de inercia que importan

1. LoRA compartido — gane mientras programa

Cada par (buggy_code → fix) que produce su agente es una muestra de entrenamiento. Contribúyalo al grupo compartido y obtendrá a cambio:

• Llamadas a la API con descuento o gratuitas (precios por nivel de reputación)

• Sorteos de premios en hitos de muestras aceptadas

• Posición en la tabla de clasificación (visible en atomadic.tech)

• Acceso al adaptador entrenado por la comunidad para su lenguaje

El bucle consta de cuatro llamadas:

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"})

Consulte examples/lora_flywheel.py para ver el script completo.

2. Ciclo RAG confiable — procedencia o no sucedió

El RAG ordinario extrae lo que devuelva el índice vectorial. El RAG confiable bloquea cada fragmento según:

• Lista blanca de dominios de origen

• Ventana de frescura

• Veredicto del oráculo de alucinaciones sobre el texto recuperado

• Puntuación de desviación frente al grafo de conocimiento en vivo

• Recibo a prueba de manipulaciones (SHA-256 encadenado al almacén de linaje)

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

Cada respuesta se envía con un bloque _guard: {hallucination, drift, guarded_at}. Nunca tendrá que realizar esas comprobaciones usted mismo.

Consulte examples/trusted_rag.py para ver el ciclo completo, incluida la emisión de certificados.

Capacidades clave

Total: 140 herramientas en 19 categorías. El desglose exacto por categoría se encuentra en docs/TOOLS.md, que es la fuente de verdad pública del repositorio para el catálogo actual.

Infraestructura que los agentes llaman directamente

Una URL base. Autenticación Bearer. JSON de entrada / JSON de salida. Cada respuesta ya está protegida.

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

El plugin MCP, el SDK de Python, el paquete npm y sus propias llamadas curl llegan a la misma superficie. Sin bloqueo de SDK, sin formato de cable propietario, sin ceremonia requerida más allá de un encabezado Bearer.

Patrones de prompt de arquitectura de mejora

AAAA-Nexus documenta tres patrones operativos que puede usar para convertir cualquier LLM en un agente que se mejora a sí mismo conectado a la pila de confianza + LoRA + RAG:

• DADA — Agente desarrollador Atomadic delegador (enruta tareas, verifica en un carril separado)

• Atomadic — Intérprete de intenciones y refinador de prompts

• Autopoetic — Bucle de retroalimentación de autocuración

Úselos como puntos de partida en su CLAUDE.md, .cursorrules o campo de prompt del sistema cuando desee que el agente utilice herramientas nexus_* intencionalmente.

Inicios rápidos — elija su carril

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

Instale una vez:

pip install aaaa-nexus-mcp

Añada a ~/.claude/settings.json o al proyecto .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"
      }
    }
  }
}

Reinicie el editor. Las 140 herramientas ahora están disponibles como nexus_* en su chat. Consulte docs/ONBOARDING.md para la lista de verificación de configuración y examples/mcp_configs/ para Cursor, Claude Desktop, VS Code, Zed y 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())

Script completo: 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);

Script completo: examples/typescript_quickstart.ts. Consulte docs/INTEGRATION.md para obtener una superficie de cliente más amplia.

4. curl (cualquier lenguaje)

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."}'

Script completo: examples/curl_quickstart.sh.

Configuración

Endpoints del nivel gratuito que funcionan sin clave: /health, /v1/rng/quantum, /v1/agent/card, /v1/metrics.

Documentación

• docs/MCP_HTTP_SERVER.md — Servidor HTTP MCP (HTTP transmitible, especificación 2025-11-25) — instalación cero, 7 herramientas principales, pago x402, configuración HTTP de Claude Desktop

• docs/MCP_CLIENTS.md — configuración editor por editor para el paquete stdio (Claude, Cursor, VS Code, Zed, Windsurf)

• docs/INTEGRATION.md — guía de integración lenguaje por lenguaje

• docs/TOOLS.md — índice de herramientas y referencias de precios para la superficie de 140 herramientas

• docs/LORA_REWARDS.md — programa de recompensas, tabla de clasificación, mecánica de premios

• docs/TRUSTED_RAG.md — ciclo RAG, procedencia, formato de recibo

Ejemplos

• examples/python_quickstart.py

• examples/typescript_quickstart.ts

• examples/curl_quickstart.sh

• examples/lora_flywheel.py — bucle de ganancia de recompensas

• examples/trusted_rag.py — recuperación bloqueada por procedencia

• examples/agent_self_gate.py — agente que bloquea sus propios commits

• examples/mcp_configs/ — configuraciones listas para usar para cada editor MCP

Licencia

Paquete fuente: MIT. Esquema OpenAPI generado: CC BY-ND 4.0.

MIT se aplica al contenido de este repositorio: el paquete de Python, el cableado MCP, los ejemplos y los documentos públicos enviados aquí. El servicio AAAA-Nexus alojado, la implementación del backend, los modelos/pruebas, las superficies de precios y el contenido del sitio atomadic.tech están separados de este repositorio y pueden tener licencias separadas o ser propietarios. Atomadic, AAAA-Nexus y los nombres, logotipos y marcas relacionados no se otorgan bajo MIT.