Skip to main content

indoctrine.ai

The Gold Standard for AI Testing: Ethical, Fair, and Compliant

PyPI version Python 3.9+ License: MIT Tests

Open-source AI testing framework for comprehensive security, bias detection, compliance, and ethical AI evaluation. Production-ready testing for LLMs and AI agents.


What Does indoctrine.ai Test?

🔐 AI Security & Robustness

Detect vulnerabilities before attackers do.

  • Prompt injection attacks - Block instruction override attempts
  • Jailbreak detection - Prevent safety guideline bypasses
  • Adaptive red-teaming - AI-powered dynamic attack generation
  • Multi-modal security - Test image injection and visual jailbreaks
  • Tool use safety - Validate agent tool-calling security
  • Token smuggling - Detect encoding-based attacks

→ See Attack Engine Documentation

✅ AI Truthfulness & Accuracy

Eliminate hallucinations and ensure factual accuracy.

  • Hallucination detection - Identify fabricated information
  • Groundedness checking - Verify claims match source material
  • RAG system evaluation - Full RAG Triad (Context, Groundedness, Answer Relevance)
  • Consistency testing - Ensure reliable responses
  • Semantic similarity - Real embedding-based analysis

→ See Truth Engine Documentation

⚖️ AI Compliance & Governance

Meet regulatory requirements automatically.

  • EU AI Act compliance - Articles 9-15 & 52 coverage
  • GDPR compliance - Data privacy and protection
  • NIST AI RMF - Risk management framework
  • SOC 2 & ISO 42001 - Enterprise standards
  • Auto-generated guardrails - Export NeMo Guardrails configs
  • Custom policy engine - Enforce company-specific rules

→ See Governance Engine Documentation

⚖️ AI Fairness & Bias Detection

Eliminate algorithmic discrimination with research-backed metrics.

  • 15 fairness metrics - Demographic parity, equalized odds, disparate impact
  • Standard benchmarks - Adult, COMPAS, German Credit datasets
  • LLM-native testing - Auto-generate demographic variants
  • Interpretability layer - Plain-English bias explanations
  • Legal compliance - EEOC 80% rule validation
  • Hiring & lending testing - Domain-specific thresholds

→ See Fairness Engine Documentation

🌍 AI Ethics & Cultural Equity

Test for cultural bias and value alignment.

  • Decolonization score - 5-dimensional cultural bias testing
    • Epistemic bias (knowledge systems)
    • Linguistic bias (communication styles)
    • Historical bias (narrative perspectives)
    • Cultural bias (norm assumptions)
    • Stereotyping (representation quality)
  • Political bias detection - Measure ideological skew
  • Values alignment - Human rights, ethics, inclusivity

→ See Values Engine Documentation


How Does indoctrine.ai Test?

🤖 LLM-as-a-Judge Evaluation

Sophisticated AI-powered testing, not brittle keyword matching.

  • Uses GPT-4, Claude, or local LLMs (Ollama, LM Studio) as evaluators
  • Contextual understanding of refusals vs. compliance
  • Nuanced detection of hallucinations and policy violations
  • Supports OpenAI, Anthropic, or fully offline local models
evaluator:
  provider: "openai"
  model: "gpt-4o"
  api_key: "${OPENAI_API_KEY}"

⚔️ Adaptive Red-Teaming

Dynamic attacks that evolve based on your agent's responses.

  • Attacker Agent observes target responses
  • Generates new exploits targeting discovered weaknesses
  • Multi-turn interrogation vs. static attack datasets
  • Powered by GPT-4, Claude, or local LLMs

📊 Objective Fairness Metrics

Research-backed algorithmic fairness testing.

  • 15 peer-reviewed fairness metrics
  • Formal mathematical definitions
  • Industry-standard benchmarks (Adult, COMPAS, German Credit)
  • Interpretability layer with plain-English explanations

🎯 Multi-Modal Testing

Test both text and vision-language models.

  • Image injection attacks
  • QR code exploits
  • Steganography detection
  • Visual jailbreak testing

🌈 Beautiful UX

AI testing that doesn't feel like a chore.

  • Nyan Progress Display - Rainbow-trailing progress animations
  • Nyan Alignment Score - Unified 0-100 ethical metric
  • Automated PDF/JSON/Markdown reports
  • 3D embedding visualizations

Why indoctrine.ai?

✨ Key Differentiators

Feature indoctrine.ai Alternatives
Open Source ✅ MIT License ❌ Proprietary
Privacy-First ✅ Runs locally ❌ Cloud-only
Comprehensive ✅ 5-layer testing ⚠️ Partial coverage
Production-Ready ✅ CI/CD integration ⚠️ Research tools
Research-Backed ✅ 15 fairness metrics ⚠️ Ad-hoc metrics
Cultural Equity ✅ Decolonization testing ❌ Not available
Auto-Remediation ✅ Guardrail export ❌ Detection only

Quick Start

Installation

pip install indoctrine-ai

Your First Test (5 Lines)

from agent_indoctrination import Indoctrinator

indo = Indoctrinator("config.yaml")
results = indo.run_full_suite(my_agent)
indo.generate_report(results, "report.pdf")
print(f"Nyan Alignment Score: {results['overall_score']}/100")

Output:

🌈 [████████████████████] 100% Complete
✅ Security: 92/100 | ✅ Accuracy: 88/100 | ✅ Compliance: 95/100
Nyan Alignment Score: 91/100

→ Get Started in 5 Minutes


Who Uses indoctrine.ai?

Use Cases

Industry What We Test Why It Matters
AI/ML Teams Security, hallucinations, consistency Catch bugs before production
Compliance Officers EU AI Act, GDPR, SOC 2 Automated regulatory audits
Red Teams Adversarial attacks, jailbreaks Identify security vulnerabilities
HR/Hiring Fairness metrics, bias detection Avoid discrimination lawsuits
Finance/Lending Disparate impact, EEOC compliance Fair lending requirements
Healthcare HIPAA, bias, hallucinations Patient safety & equity
Enterprise AI Governance, security, fairness Comprehensive AI risk management

Documentation

📚 Complete Guides

🎯 Quick Links


Features at a Glance

Core Capabilities

✅ Prompt injection & jailbreak detection
✅ Adaptive AI-powered red-teaming
✅ Multi-modal security testing (images, QR codes)
✅ Hallucination & groundedness checking
✅ RAG Triad evaluation (Context, Groundedness, Answer Relevance)
✅ EU AI Act, GDPR, NIST AI RMF compliance
✅ 15 objective fairness metrics
✅ Decolonization testing (5 cultural dimensions)
✅ Auto-generated guardrails (NeMo)
✅ LLM-as-a-Judge evaluation
✅ OpenAI, Anthropic, Ollama, LM Studio support
✅ CI/CD integration (GitHub Actions, GitLab)
✅ PDF/JSON/Markdown reports
✅ Nyan Progress Display 🌈


Configuration Example

# config.yaml - Works with OpenAI, Anthropic, or local LLMs
evaluator:
  provider: "openai"
  model: "gpt-4o"
  api_key: "${OPENAI_API_KEY}"

# Or use local LLMs (free, offline)
evaluator:
  provider: "openai"
  endpoint: "http://localhost:11434/v1"
  model: "llama3"
  api_key: "ollama"

# Enable testing engines
attack:
  enabled: true
  adaptive: true  # AI-powered attacks
  
truth:
  enabled: true
  enable_rag_triad: true
  
governance:
  enabled: true
  frameworks:
    - eu_ai_act
    - gdpr
    
fairness:
  enabled: true
  use_case: "hiring"  # EEOC thresholds

values:
  enabled: true

→ Full Configuration Guide


CI/CD Integration

# .github/workflows/ai-testing.yml
name: AI Safety Testing
on: [pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - run: pip install indoctrine-ai
      - name: Run AI tests
        env:
          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
        run: indoctrinate run --config config.yaml --agent my_agent.py
      - name: Check thresholds
        run: indoctrinate validate --results results.json --fail-on-critical

→ CI/CD Examples


Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Community

  • 🐛 Report bugs - GitHub Issues
  • 💡 Suggest features - Discussions
  • 🔀 Submit PRs - Follow the dev branch workflow
  • ⭐ Star the repo - Help us reach more AI developers!

License

MIT License - see LICENSE for details.


Support


Built for safer, fairer, and more compliant AI 🌈

Metadata

Release files for indoctrine-ai 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for indoctrine-ai 0.2.0
File Size Uploaded Provenance Actions
indoctrine_ai-0.2.0.tar.gz 51.7 kB Without provenance Details for indoctrine_ai-0.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for indoctrine-ai 0.2.0
File Interpreter ABI Platform Actions
indoctrine_ai-0.2.0-py3-none-any.whl Python 3 none any Details for indoctrine_ai-0.2.0-py3-none-any.whl

Total release size: 109.9 kB

Release files / indoctrine_ai-0.2.0.tar.gz

Download URL indoctrine_ai-0.2.0.tar.gz
Size 51.7 kB
Tags Source
SHA-256 checksum
How to use checksums
8bfb926696c3e01fd5f5fbea2d5ca420b04a4290721cbab7cb5762043dc0e0cd
BLAKE2b-256 checksum
How to use checksums
bb50b2b973e27af151241bfbe33652b5fdbb2991e01c3b644cb061fc8ded0e99
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.0

Release files / indoctrine_ai-0.2.0-py3-none-any.whl

Download URL indoctrine_ai-0.2.0-py3-none-any.whl
Size 58.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8dc02bda762849c28ba2b0f51d018c0402e949137dead90eb73e3ab6337f9025
BLAKE2b-256 checksum
How to use checksums
77bc77e1ad3847a616602754a571119373c5340e4581e9c7289a6d3b31c54d8f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.0

Security for indoctrine-ai 0.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page