# User-Friendly Examples

This directory contains **5 simple, easy-to-understand examples** that demonstrate the core features of the TBH Secure Agents framework. These examples are designed for users who want to quickly get started with the framework.

## 🎯 **What You'll Learn**

- How to create AI researchers and writers
- How to use result_destination to save outputs
- How to use guardrails for better control
- How to work with minimal security settings
- How to create simple, effective AI workflows

## 📁 **Examples Overview**

| Example | Description | Features Used |
|---------|-------------|---------------|
| **1. AI Researcher** | Research any topic and save to markdown | Expert, Operation, result_destination, guardrails |
| **2. AI Code Developer** | Write code with specific requirements | Expert, Operation, Python files, guardrails |
| **3. AI Business Analyst** | Analyze business problems and strategies | Expert, Operation, JSON format, guardrails |
| **4. AI Marketing Strategist** | Create marketing campaigns and strategies | Expert, Operation, HTML format, guardrails |
| **5. AI Financial Advisor** | Provide investment and financial advice | Expert, Operation, PDF format, guardrails |

## 🚀 **Quick Start**

1. **Choose an example** that matches your needs
2. **Run the Python file** - it's that simple!
3. **Check the outputs folder** for your generated files
4. **Modify the examples** to fit your specific use case

## 📋 **Requirements**

- Python 3.7+
- TBH Secure Agents framework installed
- Google API key (set in environment or code)

## 🛡️ **Security Settings**

All examples use **minimal security** settings for ease of use:
- Perfect for learning and development
- Allows most content to be generated
- Still provides basic security protection

## 📂 **Output Files**

All examples save their results to the `outputs/` directory:
- Markdown files (.md)
- Text files (.txt)
- JSON files (.json)
- HTML files (.html)
- PDF files (.pdf)

## 🔧 **Customization**

Each example is designed to be easily customized:
- Change the expert specialty
- Modify the instructions
- Update the output format
- Add your own guardrails
- Change the result destination

## 💡 **Tips for Users**

1. **Start with Example 1** - it's the simplest
2. **Read the comments** in each file for explanations
3. **Experiment with different topics** and instructions
4. **Try different output formats** by changing the file extension
5. **Use guardrails** to control the AI's behavior

## 🆘 **Need Help?**

- Check the main documentation in the `docs/` folder
- Look at the comments in each example file
- Try the basic examples first before moving to advanced ones
- All examples are self-contained and ready to run

Happy coding! 🎉
