AAAA-Nexus

Entwickler-Infrastruktur für vertrauenswürdige Agenten. 140 MCP-Tools in 19 Kategorien für Vertrauen, Sicherheit, Compliance, RAG, Zahlungen und Agenten-Orchestrierung.

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

Für die kostenlose Stufe ist kein Schlüssel erforderlich. Holen Sie sich einen unter atomadic.tech/pay, wenn Sie die kostenpflichtige Oberfläche nutzen möchten.

Warum Agenten AAAA-Nexus direkt aufrufen

Ihr Agent schreibt bereits Code, trifft Entscheidungen und gibt Token aus. Was er nicht von alleine kann:

1. Beweisen, dass seine Ausgaben nicht halluziniert sind.

2. Abweichungen (Drift) erkennen, bevor sie sich verstärken.

3. Einen LoRA-Adapter mit dem Rest des Schwarms teilen.

4. Belohnungen verdienen, wenn seine Korrekturen das nächste Modell trainieren.

5. Vertrauenswürdigen RAG-Kontext mit Herkunftsnachweisen abrufen.

6. Seine eigenen Commits durch ein manipulationssicheres Linting + Vertrauens-Score absichern.

7. Eine Zahlung bei ergebnisbasierter Lieferung treuhänderisch hinterlegen.

8. Seine Trace für EU-KI-Gesetz Anhang IV, DSGVO Art. 22 und NIST AI-RMF zertifizieren.

AAAA-Nexus erledigt all das. Auf der HTTP-Ebene. Mit einem Aufruf.

Die zwei entscheidenden Schwungräder

1. Shared LoRA — verdienen, während Sie programmieren

Jedes (fehlerhafter_code → korrektur)-Paar, das Ihr Agent produziert, ist ein Trainingsbeispiel. Tragen Sie es zum gemeinsamen Pool bei und Sie erhalten im Gegenzug:

• Rabattierte oder kostenlose API-Aufrufe (Preise basierend auf Reputationsstufen)

• Gewinnspiele bei erreichten Meilensteinen für Beispiele

• Platzierung in der Bestenliste (sichtbar auf atomadic.tech)

• Zugriff auf den Community-trainierten Adapter für Ihre Sprache

Die Schleife besteht aus vier Aufrufen:

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

Siehe examples/lora_flywheel.py für das End-to-End-Skript.

2. Trusted RAG-Zyklus — Herkunftsnachweis oder es ist nicht passiert

Gewöhnliches RAG ruft ab, was auch immer der Vektor-Index zurückgibt. Trusted RAG schützt jeden Chunk durch:

• Quell-Domain-Allowlist

• Aktualitätsfenster

• Halluzinations-Orakel-Urteil über den abgerufenen Text

• Drift-Score gegenüber dem Live-Wissensgraphen

• Manipulationssichere Quittung (SHA-256 verkettet mit dem Lineage-Vault)

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

Jede Antwort wird mit einem _guard-Block ausgeliefert: {hallucination, drift, guarded_at}. Sie müssen diese Prüfungen nie selbst durchführen.

Siehe examples/trusted_rag.py für den vollständigen Zyklus einschließlich der Zertifikatsausstellung.

Hauptfunktionen

Gesamt: 140 Tools in 19 Kategorien. Die genaue Aufschlüsselung nach Kategorien finden Sie in docs/TOOLS.md, der öffentlichen Quelle der Wahrheit für den aktuellen Katalog.

Infrastruktur, die Agenten direkt aufrufen

Eine Basis-URL. Bearer-Authentifizierung. JSON rein / JSON raus. Jede Antwort ist bereits geschützt.

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

Das MCP-Plugin, das Python-SDK, das npm-Paket und Ihre eigenen curl-Aufrufe nutzen alle dieselbe Oberfläche. Kein SDK-Lock-in, kein proprietäres Übertragungsformat, keine erforderliche Zeremonie außer einem Bearer-Header.

Enhancement Architect Prompt-Muster

AAAA-Nexus dokumentiert drei Betriebsmuster, mit denen Sie jeden LLM in einen selbstverbessernden Agenten verwandeln können, der mit dem Trust + LoRA + RAG-Stack verbunden ist:

• DADA — Delegator Atomadic Developer Agent (leitet Aufgaben weiter, verifiziert in einer separaten Spur)

• Atomadic — Absichts-Interpreter & Prompt-Verfeinerer

• Autopoetic — Selbstheilende Feedback-Schleife

Verwenden Sie diese als Ausgangspunkte in Ihrer CLAUDE.md, .cursorrules oder im System-Prompt-Feld, wenn der Agent nexus_*-Tools gezielt einsetzen soll.

Schnellstarts — wählen Sie Ihren Weg

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

Einmal installieren:

pip install aaaa-nexus-mcp

Fügen Sie dies zu ~/.claude/settings.json oder project .mcp.json hinzu:

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

Starten Sie den Editor neu. Alle 140 Tools sind nun als nexus_* in Ihrem Chat verfügbar. Siehe docs/ONBOARDING.md für die Einrichtungs-Checkliste und examples/mcp_configs/ für Cursor, Claude Desktop, VS Code, Zed und 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())

Vollständiges Skript: 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);

Vollständiges Skript: examples/typescript_quickstart.ts. Siehe docs/INTEGRATION.md für die breitere Client-Oberfläche.

4. curl (jede Sprache)

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

Vollständiges Skript: examples/curl_quickstart.sh.

Konfiguration

Endpunkte der kostenlosen Stufe, die ohne Schlüssel funktionieren: /health, /v1/rng/quantum, /v1/agent/card, /v1/metrics.

Dokumentation

• docs/MCP_HTTP_SERVER.md — HTTP MCP-Server (Streamable HTTP, Spezifikation 2025-11-25) — Zero-Install, 7 Kern-Tools, x402-Zahlung, Claude Desktop HTTP-Konfiguration

• docs/MCP_CLIENTS.md — Editor-für-Editor-Einrichtung für das stdio-Paket (Claude, Cursor, VS Code, Zed, Windsurf)

• docs/INTEGRATION.md — Sprach-für-Sprache-Integrationsleitfaden

• docs/TOOLS.md — Tool-Index und Preisreferenzen für die 140-Tool-Oberfläche

• docs/LORA_REWARDS.md — Belohnungsprogramm, Bestenliste, Gewinnspielmechaniken

• docs/TRUSTED_RAG.md — RAG-Zyklus, Herkunftsnachweis, Quittungsformat

Beispiele

• examples/python_quickstart.py

• examples/typescript_quickstart.ts

• examples/curl_quickstart.sh

• examples/lora_flywheel.py — Belohnungsschleife

• examples/trusted_rag.py — Herkunftsgeschützter Abruf

• examples/agent_self_gate.py — Agent, der seine eigenen Commits absichert

• examples/mcp_configs/ — Drop-in-Konfigurationen für jeden MCP-Editor

Lizenz

Quellpaket: MIT. Generiertes OpenAPI-Schema: CC BY-ND 4.0.

MIT gilt für die Inhalte dieses Repositorys: das Python-Paket, die MCP-Verkabelung, Beispiele und die hier bereitgestellten öffentlichen Dokumente. Der gehostete AAAA-Nexus-Dienst, die Backend-Implementierung, Modelle/Proofs, Preisoberflächen und die Inhalte der atomadic.tech-Website sind von diesem Repository getrennt und können separat lizenziert oder proprietär sein. Atomadic, AAAA-Nexus und zugehörige Namen, Logos und Branding sind nicht unter MIT lizenziert.