Skip to content
/ VeritasOS Public

VeritasOS provides a decentralized reputation system that helps AI agents and dApps verify trust before acting. It uses Sybil-resistant scoring and a decentralized knowledge graph to deliver verifiable, transparent, and auditable trust scores for identities and content. This enables secure, data-driven decision-making in AI and Web3 applications.

Notifications You must be signed in to change notification settings

h30s/VeritasOS

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

VeritasOS

Decentralized Reputation Layer for Trusted AI Agents

Stop guessing. Start verifying.
VeritasOS gives AI agents and dApps the power to decide who and what to trust before taking action.


🚀 The Problem: Trust is Broken in AI & Web3

AI agents are making high-stakes decisions daily, but they're flying blind:

  • 🤖 Operating on untrusted data from anonymous sources
  • 🎭 No defense against bots, Sybils, and disinformation clusters
  • 🔗 Missing reputation backbone for critical trust decisions

Result: Your AI agent can't answer: "Should I trust this identity? Amplify this content? Transact with this address?"


💡 The Solution: VeritasOS

VeritasOS is the decentralized reputation oracle that transforms social graphs into verifiable trust scores.

We ingest the Umanitek Guardian network, compute Sybil-resistant reputation scores, and publish them as machine-readable Knowledge Assets on the OriginTrail DKG.

🚀 VeritasOS vs. The Old World

❌ Traditional Limitations ✅ VeritasOS Breakthroughs
Black-box, centralized systems Open, decentralized transparency
Hidden, non-auditable scores Explainable, audit-friendly reputation
Closed, siloed architectures Composable & interoperable trust layer
Human-only UX Agent-native, AI-first design

🛠️ Core Features

🔬 Sybil-Resistant Reputation Engine

  • PageRank-inspired algorithm over Guardian social graph
  • Normalized scores (0-1) with intuitive trust levels: High/Moderate/Low
  • Bot detection through network analysis

🌐 Verifiable Reputation Profiles

  • JSON-LD Knowledge Assets on OriginTrail DKG
  • Structured scores: global, networkTrust, misinfoResistance
  • Provenance tracking: algorithm version, timestamp, computation source

🤖 AI Agent Integration (MCP Tools)

// Your AI agent can now query trust levels
const reputation = await trust_getReputation("@factchecker_alice");
// Returns: { score: 0.95, recommendation: "TRUST", explanation: "...", dkg_ual: "..." }

Available Tools:

  • trust_getReputation(subjectId) - Get identity trust scores
  • trust_getContentTrust(contentUrl) - Content credibility assessment
  • Returns actionable recommendations: TRUST / VERIFY_BEFORE_TRUST / DO_NOT_TRUST

🎨 Reputation Explorer UI

  • Search identities by handle or ID
  • Trust cards with visual scores and explanations
  • Leaderboard ranking of top trusted identities
  • DKG asset references for verification

📡 REST API for Developers

# Query reputation by handle
GET /api/reputation/by-handle/factchecker_alice

# Get top trusted identities  
GET /api/top?limit=10

# Content trust assessment
GET /api/content-trust?url=https://...

🏗️ How It Works

graph TD
    A[🔗 Guardian Social Graph] --> B[🔄 Reputation Engine]
    B --> C[📊 Trust Scores]
    C --> D[🌐 OriginTrail DKG]
    
    D --> E[🔌 Access Layers]
    E --> F[🤖 MCP Tools]
    E --> G[📡 REST API]
    E --> H[🎨 Web UI]
    
    F --> I[AI Agents]
    G --> J[dApps & Protocols]
    H --> K[Humans & Analysts]
    
    
Loading

🔍 Live Demo Scenarios

Scenario 1: Trusted Identity

Search: "@factchecker_alice"
Result: ✅ 96% Trust Score (HIGH)
Explanation: "Strong incoming endorsements from trusted network"
DKG Reference: ✅ Verifiable on OriginTrail

Scenario 2: Suspicious Identity

Search: "@bot_larry" 
Result: ❌ 12% Trust Score (LOW)
Explanation: "Isolated node with minimal trusted connections"
DKG Reference: ✅ Verifiable on OriginTrail

🚀 Quick Start

Prerequisites

  • Node.js 18+
  • npm or yarn

Installation & Run

# Clone and setup
git clone https://github.com/your-org/veritasos
cd veritasos

# Install dependencies
npm install

# Start backend (computes reputations & serves API)
cd backend && npm run dev

# Start frontend (in new terminal)
cd frontend && npm run dev

Access Points:


🛠️ Tech Stack Overview

Category Technologies
Frontend Next.js 16 • TypeScript • TailwindCSS
Backend Node.js • Express • TypeScript
Storage In-memory graph (MVP) → PostgreSQL (Production)
DKG OriginTrail Decentralized Knowledge Graph
AI Integration Model Context Protocol (MCP)
Algorithms PageRank-inspired reputation scoring

🎯 Use Cases

For AI Agent Developers

// Before acting on user instruction, check reputation
const trust = await getReputation(userIdentity);
if (trust.recommendation === "TRUST") {
  await executeHighStakesAction();
} else {
  await requestHumanReview();
}

For dApp Builders

  • Filter bot accounts from your platform
  • Gate high-value actions behind reputation thresholds
  • Display trust badges for credible users

For Ecosystem Partners

  • Composable trust primitive for OriginTrail/Polkadot ecosystems
  • Reputation-as-a-service for trust-critical applications
  • Transparent, auditable reputation backbone

🔮 The Vision

"In a world of increasingly autonomous AI, VeritasOS ensures that trust becomes a verifiable, decentralized primitive rather than a centralized vulnerability."

VeritasOS isn't just another reputation system—it's the trust backbone for the next generation of AI and Web3 applications.


Built with ❤️ for the OriginTrail × Polkadot × Umanitek Hackathon

About

VeritasOS provides a decentralized reputation system that helps AI agents and dApps verify trust before acting. It uses Sybil-resistant scoring and a decentralized knowledge graph to deliver verifiable, transparent, and auditable trust scores for identities and content. This enables secure, data-driven decision-making in AI and Web3 applications.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages