feat: add comprehensive integration examples

Author: LifeJiggy

examples/README.md

@@ -0,0 +1,65 @@
+# Gradient Python SDK Examples
+
+This directory contains examples demonstrating how to use the Gradient Python SDK with various frameworks and for different use cases.
+
+## Available Examples
+
+### Framework Integrations
+
+- **[Django Integration](django_integration.py)** - Complete Django web app with chat completions, image generation, agent management, and knowledge bases
+- **[Flask Integration](flask_integration.py)** - Full Flask application with REST API endpoints for all Gradient features
+- **[FastAPI Integration](fastapi_integration.py)** - Modern async FastAPI app with Pydantic models and comprehensive endpoints
+- **[Streamlit Integration](streamlit_integration.py)** - Interactive web UI for chat and image generation
+- **[Gradio Integration](gradio_integration.py)** - User-friendly interface with tabs for chat, images, and model management
+- **[CLI Example](cli_example.py)** - Command-line tool for all Gradient operations
+
+### Utility Examples
+
+- **[Agent Wait Until Ready](agent_wait_until_ready.py)** - How to wait for agent deployment to be ready
+- **[Knowledge Base Indexing Wait](knowledge_base_indexing_wait.py)** - How to wait for knowledge base indexing to complete
+- **[Wait for Knowledge Base](wait_for_knowledge_base.py)** - How to wait for knowledge base creation
+
+## Running Examples
+
+Each example is a standalone Python script that can be run directly:
+
+```bash
+# Make sure you have the required environment variables set
+export DIGITALOCEAN_ACCESS_TOKEN="your_token_here"
+export GRADIENT_MODEL_ACCESS_KEY="your_model_key_here"
+export GRADIENT_AGENT_ACCESS_KEY="your_agent_key_here"
+export GRADIENT_AGENT_ENDPOINT="https://your-agent.agents.do-ai.run"
+
+# Run an example
+python examples/django_integration.py
+```
+
+## Framework-Specific Setup
+
+### Django
+The Django example shows how to create a Django view that uses the Gradient SDK for AI-powered responses.
+
+### Flask
+The Flask example demonstrates integrating Gradient SDK with Flask routes for web applications.
+
+### FastAPI
+The FastAPI example shows how to create async endpoints that leverage the Gradient SDK's async capabilities.
+
+## Environment Variables
+
+All examples require proper authentication setup:
+
+- `DIGITALOCEAN_ACCESS_TOKEN` - For DigitalOcean API operations
+- `GRADIENT_MODEL_ACCESS_KEY` - For serverless inference
+- `GRADIENT_AGENT_ACCESS_KEY` - For agent-specific operations
+- `GRADIENT_AGENT_ENDPOINT` - Your deployed agent endpoint
+
+## Contributing
+
+When adding new examples:
+
+1. Follow the existing naming convention
+2. Include comprehensive comments
+3. Handle errors appropriately
+4. Use environment variables for configuration
+5. Add the example to this README