# Venturalítica SDK Documentation

**Frictionless Governance for AI Systems**

Welcome! This documentation is designed to get you from zero to compliant in minutes, not days.

## 🚀 Quick Navigation

### For Developers (Developer Path)
Start here if you want to **ship fast** without compliance blocking your sprint:

1. **[5-Minute Quickstart](quickstart.md)** ⚡
   - Install → Enforce → Done
   - Zero config, maximum impact
   - Your first "Aha! Moment"

2. **[MLOps Integration Guide](mlops-integration.md)** 🔗
   - MLflow, WandB, ClearML
   - One line of code = full compliance logging
   - No workflow disruption

3. **[Green AI Guide](green-ai.md)** 🌱
   - Track carbon footprint with CodeCarbon
   - EU AI Act Article 11 compliance
   - Show stakeholders your environmental impact

### For Compliance Officers (Compliance Path)
Start here if you need **audit-ready documentation**:

1. **[OSCAL Policy Authoring](oscal-authoring.md)** 📜
   - Write policies that map to EU AI Act
   - Educational control descriptions
   - Reusable templates

2. **[CLI Tools Guide](cli-tools.md)** 🛠️
   - Generate ML-BOM (CycloneDX)
   - Launch compliance dashboard
   - Auto-generate Annex IV documentation

### For Everyone
**[Core Concepts](core-concepts.md)** 🎯
- Role-Based Binding explained
- Why semantic variables matter
- The "Handshake" architecture

---

## 📚 Complete Tutorial Index

| Tutorial | Audience | Time | Complexity |
|----------|----------|------|------------|
| [Quickstart](quickstart.md) | Developers | 5 min | ⭐ |
| [Core Concepts](core-concepts.md) | Everyone | 10 min | ⭐⭐ |
| [MLOps Integration](mlops-integration.md) | ML Engineers | 15 min | ⭐⭐ |
| [Green AI](green-ai.md) | Sustainability Teams | 10 min | ⭐⭐ |
| [OSCAL Authoring](oscal-authoring.md) | Compliance Officers | 20 min | ⭐⭐⭐ |
| [CLI Tools](cli-tools.md) | DevOps/Compliance | 15 min | ⭐⭐ |
| [Advanced Features](advanced.md) | Power Users | 30 min | ⭐⭐⭐⭐ |

### 🧪 Real-World Scenarios

| Scenario | Focus | Time |
|----------|-------|------|
| **[Loan Approval Fairness](scenarios/loan-fairness.md)** | EU AI Act, ECOA, Bias | 20 min |
| **Health Clinical Risk** | GDPR, Patient Safety | Coming Soon |
| **HR Hiring Bias** | Labor Laws, Fairness | Coming Soon |

---

## 🎯 Learning Paths

### Path 1: Developer Onboarding (PLG Strategy)
**Goal**: Get value in < 10 minutes, create demand for deeper features

1. [Quickstart](quickstart.md) - Install and enforce your first policy
2. [MLOps Integration](mlops-integration.md) - Integrate with your existing workflow
3. [Green AI](green-ai.md) - Add carbon tracking (the "wow" moment)
4. **Handshake Moment**: Realize you need organizational policies → Upgrade to SaaS

### Path 2: Compliance-First Onboarding
**Goal**: Understand governance architecture before implementation

1. [Core Concepts](core-concepts.md) - Understand the "why"
2. [OSCAL Authoring](oscal-authoring.md) - Write your policies
3. [CLI Tools](cli-tools.md) - Generate documentation
4. [Quickstart](quickstart.md) - Enforce policies in code

### Path 3: Full Stack Mastery
**Goal**: Become a Venturalítica power user

1. Complete Path 1 (Developer Onboarding)
2. [Core Concepts](core-concepts.md) - Deep dive into architecture
3. [OSCAL Authoring](oscal-authoring.md) - Custom policy creation
4. [Advanced Features](advanced.md) - Programmatic workflows

---

For a deep dive into a real-world scenario, check out our **[Loan Approval Fairness Tutorial](scenarios/loan-fairness.md)**.

## 🔗 External Resources

- **[Samples Repository](https://github.com/venturalitica/venturalitica-sdk-samples)** - Real-world examples
- **[OSCAL Documentation](https://pages.nist.gov/OSCAL/)** - Policy standard
- **[EU AI Act](https://artificialintelligenceact.eu/)** - Regulatory context
- **[CodeCarbon](https://codecarbon.io/)** - Green AI tracking

---

## 🤝 Need Help?

- **Issues**: [GitHub Issues](https://github.com/venturalitica/venturalitica-sdk/issues)
- **Discussions**: [GitHub Discussions](https://github.com/venturalitica/venturalitica-sdk/discussions)
- **Enterprise Support**: Contact us for SaaS onboarding

---

**Next Step**: Choose your path above and start with the first tutorial!
