Real-World Examples

Complete working examples showing how to build compliant AI systems at scale

🚀 How to Run Examples

All examples are available in the repository. Follow these steps to run any example:

cd examples/healthcare # or finance, legal, ecommerce npm install npm run setup # Seeds contracts to Redis npm run start # Starts all services npm test # Runs the example

Prerequisites: Node.js, Redis, GuardRails Runtime Gateway running

đŸĨ

Healthcare AI Pipeline

HIPAA-Compliant Medical Diagnosis System

A complete 5-service medical diagnosis pipeline demonstrating how to build HIPAA-compliant AI systems with deterministic contract enforcement.

Services in Pipeline:

  • 📋 Patient Intake - Collects symptoms and medical history
  • 🔍 Symptom Analysis - AI analyzes reported symptoms
  • đŸŠē Diagnosis - Generates potential diagnoses
  • 💊 Prescription - Recommends treatments
  • 📅 Follow-up - Schedules next steps

Compliance Enforced:

HIPAA PII Protection Medical Privacy Tested ✓

Run This Example:

cd examples/healthcare npm install npm run setup npm test

Location: /examples/healthcare/
Test Status: ✅ All tests passing

💰

Financial Advisory AI

FINRA-Compliant Investment Advisory System

A 5-service financial advisory pipeline showing how to build compliant AI for investment advice with deterministic contract validation.

Services in Pipeline:

  • 👤 Client Profiling - Assesses risk tolerance
  • 📊 Risk Assessment - Analyzes financial situation
  • đŸ’ŧ Portfolio Analysis - Reviews investments
  • 💡 Recommendations - Suggests strategies
  • ✅ Compliance Review - FINRA validation

Compliance Enforced:

FINRA SEC Rules Investment Advisor Act Tested ✓

Run This Example:

cd examples/finance npm install npm run setup npm test

Location: /examples/finance/
Test Status: ✅ All tests passing

âš–ī¸

Legal Document AI

Bar Association-Compliant Legal Analysis

A 5-service legal document analysis pipeline demonstrating how to build compliant AI for legal research with citation verification.

Services in Pipeline:

  • 📄 Document Intake - Ingests legal documents
  • đŸˇī¸ Classification - Categorizes document type
  • 🔍 Analysis - Extracts key information
  • 📝 Summarization - Creates summaries
  • 📚 Case Preparation - Prepares legal briefs

Compliance Enforced:

Bar Association Citation Accuracy Legal Ethics Tested ✓

Run This Example:

cd examples/legal npm install npm run setup npm test

Location: /examples/legal/
Test Status: ✅ All tests passing

🛒

E-commerce Customer Service AI

Multi-Agent Customer Support System

A 6-service customer service AI swarm demonstrating coordinated multi-agent systems with bias detection and quality assurance.

Services in Pipeline:

  • đŸŽĢ Ticket Triage - Routes customer inquiries
  • 🎁 Product Recommendations - Suggests products
  • đŸ’Ŧ Support Agent - Handles questions
  • đŸ“Ļ Order Tracking - Provides order status
  • â†Šī¸ Returns Processing - Manages returns
  • ⭐ Feedback Analysis - Analyzes sentiment

Compliance Enforced:

No Bias PII Protection Quality Assurance Tested ✓

Run This Example:

cd examples/ecommerce npm install npm run setup npm test

Location: /examples/ecommerce/
Test Status: ✅ All tests passing

📚 What You'll Learn From These Examples

✨ Common Features Across All Examples

🔒 Security

  • ✅ PII detection and blocking
  • ✅ API key authentication
  • ✅ Tenant isolation

📊 Monitoring

  • ✅ Request tracing
  • ✅ Evidence logging
  • ✅ Violation tracking

⚡ Performance

  • ✅ Zero-RTT validation
  • ✅ Redis caching
  • ✅ Async processing

đŸŽ¯ Compliance

  • ✅ Deterministic contracts
  • ✅ Blockchain verification
  • ✅ Audit trails

đŸ› ī¸ Technical Stack Used

Runtime:
Node.js 18+
Gateway:
GuardRails Runtime Gateway (Go)
Storage:
Redis (contracts)
PostgreSQL (evidence)
Blockchain:
Arbitrum (Sepolia testnet)
AI Provider:
OpenAI GPT-4
Testing:
Mock services included

đŸŽ¯ Next Steps

After exploring the examples:

Start Building → View API Docs Open Dashboard