English Français العربية

Vongola

السجل الرسمي أخرى

Read-only operator instrumentation for the vongola TLS gateway.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

MCPB package https://github.com/qompassai/vongola/releases/download/v0.2.0/vongola-mcp-0.2.0-linux-x64.mcpb

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Vongola
  2. Quickstart
  3. /qompassai/vongola/scripts/quickstart.sh
  4. Qompass AI Quick Start Script
  5. Copyright (C) 2025 Qompass AI, All rights reserved
  6. Documentation
  7. License

Vongola

Vongola is Qompass AI's reverse proxy and web server — a clean-room rewrite on Pingora 0.9.0. It hosts qompass.ai, runs on a single small device, and scales across a fleet of small nodes (NVIDIA Jetson-class dev kits, thin/slim clients) sharing one versioned configuration bundle.

  • Hosting: SNI TLS termination, www→apex 308, static hosting with cache rules + gzip, proxied routes with health-checked round-robin upstreams.
  • Post-quantum TLS: TLS 1.3 only with ML-KEM hybrid key exchange — live-negotiated X25519MLKEM768 in smoke. Builds must link system OpenSSL ≥ 3.5 (see the book's TLS chapter for the vendored-OpenSSL trap).
  • Operator surfaces: MCP server (read-only-first, auth-gated mutations), signed A2A Agent Card, populated Prometheus metrics, and a live dashboard (NAT, Tor, chains, upstreams, certs).
  • NAT traversal: PCP / NAT-PMP / UPnP IGD, opt-in per listener, leased and released on shutdown.
  • Tor onion services: publish routes as v3 onion services. Vongola is never a Tor exit node — enforced in config validation, not just documented.
  • Proxy chains: SOCKS5h / HTTP CONNECT / Tor / vongola hops, DNS through the chain, fail closed (a dead hop is a 502, never a direct fallback).

Quickstart

cargo build --release
./target/release/vongola validate-config --config examples/qompass.yaml
./target/release/vongola serve --config examples/lean.yaml
bash scripts/smoke.sh   # full live smoke against loopback fixtures

📄 We advise you read the script BEFORE running it 😉

#!/usr/bin/env bash

/qompassai/vongola/scripts/quickstart.sh

Qompass AI Quick Start Script

####################################################

Or, View the quickstart script.

Documentation

The mdBook in docs/src (build with mdbook build) covers architecture, the hosting/lean/fleet profiles, the TLS/PQC posture with negotiation evidence, MCP/A2A, NAT, Tor, chains, the dashboard, a configuration reference, the operations runbook, the Homa and Mojo verdicts, and the feature accounting against the previous tree. SPEC.md is the clean-room contract the implementation was written against.

License

Apache-2.0. Copyright 2026 Qompass AI.

الأسئلة الشائعة

ما هو Vongola؟

Read-only operator instrumentation for the vongola TLS gateway.

كيف أثبّت Vongola؟

اتبع خطوات التثبيت في توثيقه المعروض في هذه الصفحة وفي مستودعه.

هل يحتاج Vongola إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Vongola مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص Apache-2.0.

من يصون Vongola؟

ينشره qompassai. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.