Implement comprehensive real-time agent reference design for Azure OpenAI and AI Foundry

.gitignore

@@ -0,0 +1,95 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+venv/
+env/
+ENV/
+env.bak/
+venv.bak/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Environment variables
+.env
+.env.local
+.env.production
+.env.test
+
+# OS
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Logs
+*.log
+logs/
+
+# Testing
+.coverage
+.pytest_cache/
+.tox/
+.nox/
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# pipenv
+Pipfile.lock
+
+# PEP 582
+__pypackages__/
+
+# Celery
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Temporary files
+/tmp/
+temp/
+*.tmp
+*.temp
+
+# Documentation builds
+docs/_build/
+site/

CONTRIBUTING.md

@@ -0,0 +1,75 @@
+# Contributing to Real-Time Agent
+
+We welcome contributions to the Real-Time Agent project! This document provides guidelines for contributing.
+
+## Development Setup
+
+1. Fork the repository
+2. Clone your fork:
+   ```bash
+   git clone https://github.com/your-username/real-time-agent.git
+   cd real-time-agent
+   ```
+
+3. Create a virtual environment:
+   ```bash
+   python -m venv venv
+   source venv/bin/activate  # On Windows: venv\Scripts\activate
+   ```
+
+4. Install dependencies:
+   ```bash
+   pip install -r requirements.txt
+   pip install -e .
+   ```
+
+## Making Changes
+
+1. Create a feature branch:
+   ```bash
+   git checkout -b feature/your-feature-name
+   ```
+
+2. Make your changes following the code style guidelines
+3. Add tests for new functionality
+4. Run tests to ensure everything works
+5. Update documentation as needed
+
+## Code Style
+
+- Follow PEP 8 for Python code style
+- Use type hints for all function parameters and return values
+- Add docstrings for all public functions and classes
+- Keep line length to 100 characters maximum
+
+## Testing
+
+Run tests before submitting:
+
+```bash
+# Run basic tests
+python tests/test_basic.py
+
+# With pytest (if available)
+pytest tests/
+```
+
+## Submitting Changes
+
+1. Commit your changes with descriptive messages
+2. Push to your fork
+3. Create a pull request with:
+   - Clear description of changes
+   - Reference to any related issues
+   - Screenshots for UI changes
+
+## Issues
+
+When reporting issues, please include:
+- Python version
+- Operating system
+- Error messages and stack traces
+- Steps to reproduce
+- Expected vs actual behavior
+
+Thank you for contributing!