Skip to main content
Glama

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

#

Funktion

Repräsentative Endpunkte

Was es löst

1

Vertrauens-Orakel

/v1/oracle/hallucination, /v1/trust/decay

Halluzinations- und Drift-Urteile für jeden Text

2

Shared LoRA-Schleife

/v1/lora/contribute, /v1/lora/reward/claim

Belohnungen für Korrekturen verdienen; Community-Adapter abrufen

3

Trusted RAG

/v1/rag/augment, /v1/aibom/drift

Herkunftsgeschützter Abruf mit Quittungen

4

System-Primitive

/v1/sys/trust_gate, /v1/sys/lint_gate, /v1/sys/chain_parity

Numerische Invarianten für die Selbstverwaltung von Agenten

5

Compliance-Zertifikate

/v1/compliance/eu-ai-act, /v1/compliance/explain

EU-KI-Gesetz, DSGVO Art. 22, NIST-Konformität

6

Treuhand + SLA

/v1/escrow/create, /v1/sla/report

Ergebnisbasierte USDC-Abrechnung mit Schiedsverfahren

7

VeriRand

/v1/rng/quantum, /v1/vrf/draw

HMAC-bewiesene Zufälligkeit, On-Chain VRF-Ziehungen

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

Variable

Standard

Zweck

AAAA_NEXUS_API_KEY

(keiner)

Bearer-Token für kostenpflichtige Tools

AAAA_NEXUS_BASE_URL

https://atomadic.tech

API-Basis-URL

AAAA_NEXUS_TIMEOUT

20.0

Request-Timeout (Sekunden)

AAAA_NEXUS_AUTOGUARD

1

Jede Antwort mit Halluzinations- und Drift-Urteilen annotieren

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

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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors