roovy-sdk 0.1.0__tar.gz

roovy_sdk-0.1.0/.gitignore

@@ -0,0 +1,75 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDEs
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# ruff
+.ruff_cache/

roovy_sdk-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Yash Desai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

roovy_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,279 @@
+Metadata-Version: 2.4
+Name: roovy-sdk
+Version: 0.1.0
+Summary: Python SDK for generating WhatsApp Flows using LLMs
+Project-URL: Homepage, https://github.com/yashdesai/roovy-sdk
+Project-URL: Documentation, https://github.com/yashdesai/roovy-sdk#readme
+Project-URL: Repository, https://github.com/yashdesai/roovy-sdk
+Project-URL: Issues, https://github.com/yashdesai/roovy-sdk/issues
+Author-email: Yash Desai <contact@yashddesai.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,chatbot,llm,meta,openai,whatsapp,whatsapp-flows
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Requires-Dist: openai>=1.0.0
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Roovy SDK
+
+A Python SDK for generating WhatsApp Flows using LLMs. Generate valid,
+schema-compliant WhatsApp Flow JSON from natural language descriptions.
+
+## Features
+
+- 🚀 **Simple API** - Generate WhatsApp Flows with a single function call
+- ✅ **Schema Validation** - Built-in Pydantic models ensure valid output
+- 🔄 **Auto-Retry** - Automatic retries with error feedback for better results
+- 📡 **Streaming Support** - Stream responses for real-time feedback
+- 🔌 **Provider Agnostic** - Works with OpenAI, Groq, Ollama, or any
+  OpenAI-compatible API
+- 📝 **Type Safe** - Full type hints and Pydantic models
+
+## Installation
+
+```bash
+pip install roovy-sdk
+```
+
+## Quick Start
+
+```python
+from roovy_sdk import RoovyClient
+
+# Initialize with your preferred provider
+client = RoovyClient(
+    api_key="your-api-key",
+    base_url="https://api.openai.com/v1",  # or any OpenAI-compatible endpoint
+    model="gpt-4o",
+)
+
+# Generate a WhatsApp Flow from natural language
+flow = client.generate(
+    "Create a customer feedback form with name, email, rating (1-5 stars), and comments"
+)
+
+# Access the validated flow
+print(flow.model_dump_json(indent=2, by_alias=True))
+```
+
+## Configuration
+
+### Using Environment Variables
+
+```python
+import os
+from roovy_sdk import RoovyClient
+
+# Set environment variables
+os.environ["ROOVY_API_KEY"] = "your-api-key"
+os.environ["ROOVY_BASE_URL"] = "https://api.openai.com/v1"
+os.environ["ROOVY_MODEL"] = "gpt-4o"
+
+# Client will use environment variables automatically
+client = RoovyClient()
+```
+
+### Provider Examples
+
+**OpenAI:**
+
+```python
+client = RoovyClient(
+    api_key="sk-...",
+    base_url="https://api.openai.com/v1",
+    model="gpt-4o",
+)
+```
+
+**Groq:**
+
+```python
+client = RoovyClient(
+    api_key="gsk_...",
+    base_url="https://api.groq.com/openai/v1",
+    model="llama-3.3-70b-versatile",
+)
+```
+
+**Ollama (local):**
+
+```python
+client = RoovyClient(
+    api_key="ollama",  # any non-empty string
+    base_url="http://localhost:11434/v1",
+    model="llama3.2",
+)
+```
+
+## Advanced Usage
+
+### Streaming Generation
+
+```python
+def on_chunk(chunk: str):
+    print(chunk, end="", flush=True)
+
+flow = client.generate_stream(
+    "Create a booking form for a concert",
+    on_chunk=on_chunk,
+)
+```
+
+### Custom Retry Settings
+
+```python
+flow = client.generate(
+    "Create a survey form",
+    max_retries=5,
+    temperature=0.3,
+)
+```
+
+### Custom System Prompt
+
+```python
+flow = client.generate(
+    "Create a registration form",
+    system_prompt="You are a WhatsApp Flows expert...",
+)
+```
+
+### Direct Schema Access
+
+```python
+from roovy_sdk.schema import (
+    WhatsAppFlow,
+    Screen,
+    TextInput,
+    Footer,
+    validate_flow,
+)
+
+# Build flows programmatically
+screen = Screen(
+    id="WELCOME",
+    title="Welcome",
+    layout=SingleColumnLayout(
+        type="SingleColumnLayout",
+        children=[
+            TextHeading(type="TextHeading", text="Hello!"),
+        ]
+    )
+)
+
+# Validate any JSON against the schema
+result = validate_flow({"version": "7.2", "screens": [...]})
+if result["success"]:
+    flow = result["data"]
+```
+
+## Schema Reference
+
+The SDK includes complete Pydantic models for all WhatsApp Flow components:
+
+### Text Components
+
+- `TextHeading` - Main headings
+- `TextSubheading` - Subheadings
+- `TextBody` - Body text
+- `TextCaption` - Small captions
+
+### Input Components
+
+- `TextInput` - Single-line text input
+- `TextArea` - Multi-line text input
+- `Dropdown` - Dropdown selector
+- `RadioButtonsGroup` - Radio button selection
+- `ChipsSelector` - Multi-select chips
+- `CheckboxGroup` - Checkbox group
+- `OptIn` - Opt-in checkbox
+
+### Date/Media Components
+
+- `CalendarPicker` - Calendar date picker
+- `DatePicker` - Simple date picker
+- `PhotoPicker` - Photo upload
+- `DocumentPicker` - Document upload
+- `Image` - Display images
+
+### Navigation Components
+
+- `Footer` - Screen footer with action
+- `Button` - Action button
+- `EmbeddedLink` - Inline link
+
+### Conditional Components
+
+- `If` - Conditional rendering
+- `Switch` - Switch/case rendering
+
+### Container Components
+
+- `Form` - Form container
+- `SingleColumnLayout` - Screen layout
+
+## API Reference
+
+### `RoovyClient`
+
+```python
+RoovyClient(
+    api_key: str | None = None,      # API key (or ROOVY_API_KEY env var)
+    base_url: str | None = None,     # Base URL (or ROOVY_BASE_URL env var)
+    model: str | None = None,        # Model name (or ROOVY_MODEL env var)
+)
+```
+
+### `client.generate()`
+
+```python
+client.generate(
+    prompt: str,                     # Natural language description
+    *,
+    max_retries: int = 3,           # Number of retry attempts
+    temperature: float = 0.2,        # LLM temperature
+    system_prompt: str | None = None, # Custom system prompt
+) -> WhatsAppFlow
+```
+
+### `client.generate_stream()`
+
+```python
+client.generate_stream(
+    prompt: str,                     # Natural language description
+    on_chunk: Callable[[str], None] | None = None,  # Chunk callback
+    *,
+    temperature: float = 0.2,        # LLM temperature
+    system_prompt: str | None = None, # Custom system prompt
+) -> WhatsAppFlow
+```
+
+### `validate_flow()`
+
+```python
+from roovy_sdk import validate_flow
+
+result = validate_flow(flow_dict)
+# Returns: {"success": True, "data": WhatsAppFlow} or {"success": False, "error": ValidationError}
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.

roovy_sdk-0.1.0/README.md

@@ -0,0 +1,246 @@
+# Roovy SDK
+
+A Python SDK for generating WhatsApp Flows using LLMs. Generate valid,
+schema-compliant WhatsApp Flow JSON from natural language descriptions.
+
+## Features
+
+- 🚀 **Simple API** - Generate WhatsApp Flows with a single function call
+- ✅ **Schema Validation** - Built-in Pydantic models ensure valid output
+- 🔄 **Auto-Retry** - Automatic retries with error feedback for better results
+- 📡 **Streaming Support** - Stream responses for real-time feedback
+- 🔌 **Provider Agnostic** - Works with OpenAI, Groq, Ollama, or any
+  OpenAI-compatible API
+- 📝 **Type Safe** - Full type hints and Pydantic models
+
+## Installation
+
+```bash
+pip install roovy-sdk
+```
+
+## Quick Start
+
+```python
+from roovy_sdk import RoovyClient
+
+# Initialize with your preferred provider
+client = RoovyClient(
+    api_key="your-api-key",
+    base_url="https://api.openai.com/v1",  # or any OpenAI-compatible endpoint
+    model="gpt-4o",
+)
+
+# Generate a WhatsApp Flow from natural language
+flow = client.generate(
+    "Create a customer feedback form with name, email, rating (1-5 stars), and comments"
+)
+
+# Access the validated flow
+print(flow.model_dump_json(indent=2, by_alias=True))
+```
+
+## Configuration
+
+### Using Environment Variables
+
+```python
+import os
+from roovy_sdk import RoovyClient
+
+# Set environment variables
+os.environ["ROOVY_API_KEY"] = "your-api-key"
+os.environ["ROOVY_BASE_URL"] = "https://api.openai.com/v1"
+os.environ["ROOVY_MODEL"] = "gpt-4o"
+
+# Client will use environment variables automatically
+client = RoovyClient()
+```
+
+### Provider Examples
+
+**OpenAI:**
+
+```python
+client = RoovyClient(
+    api_key="sk-...",
+    base_url="https://api.openai.com/v1",
+    model="gpt-4o",
+)
+```
+
+**Groq:**
+
+```python
+client = RoovyClient(
+    api_key="gsk_...",
+    base_url="https://api.groq.com/openai/v1",
+    model="llama-3.3-70b-versatile",
+)
+```
+
+**Ollama (local):**
+
+```python
+client = RoovyClient(
+    api_key="ollama",  # any non-empty string
+    base_url="http://localhost:11434/v1",
+    model="llama3.2",
+)
+```
+
+## Advanced Usage
+
+### Streaming Generation
+
+```python
+def on_chunk(chunk: str):
+    print(chunk, end="", flush=True)
+
+flow = client.generate_stream(
+    "Create a booking form for a concert",
+    on_chunk=on_chunk,
+)
+```
+
+### Custom Retry Settings
+
+```python
+flow = client.generate(
+    "Create a survey form",
+    max_retries=5,
+    temperature=0.3,
+)
+```
+
+### Custom System Prompt
+
+```python
+flow = client.generate(
+    "Create a registration form",
+    system_prompt="You are a WhatsApp Flows expert...",
+)
+```
+
+### Direct Schema Access
+
+```python
+from roovy_sdk.schema import (
+    WhatsAppFlow,
+    Screen,
+    TextInput,
+    Footer,
+    validate_flow,
+)
+
+# Build flows programmatically
+screen = Screen(
+    id="WELCOME",
+    title="Welcome",
+    layout=SingleColumnLayout(
+        type="SingleColumnLayout",
+        children=[
+            TextHeading(type="TextHeading", text="Hello!"),
+        ]
+    )
+)
+
+# Validate any JSON against the schema
+result = validate_flow({"version": "7.2", "screens": [...]})
+if result["success"]:
+    flow = result["data"]
+```
+
+## Schema Reference
+
+The SDK includes complete Pydantic models for all WhatsApp Flow components:
+
+### Text Components
+
+- `TextHeading` - Main headings
+- `TextSubheading` - Subheadings
+- `TextBody` - Body text
+- `TextCaption` - Small captions
+
+### Input Components
+
+- `TextInput` - Single-line text input
+- `TextArea` - Multi-line text input
+- `Dropdown` - Dropdown selector
+- `RadioButtonsGroup` - Radio button selection
+- `ChipsSelector` - Multi-select chips
+- `CheckboxGroup` - Checkbox group
+- `OptIn` - Opt-in checkbox
+
+### Date/Media Components
+
+- `CalendarPicker` - Calendar date picker
+- `DatePicker` - Simple date picker
+- `PhotoPicker` - Photo upload
+- `DocumentPicker` - Document upload
+- `Image` - Display images
+
+### Navigation Components
+
+- `Footer` - Screen footer with action
+- `Button` - Action button
+- `EmbeddedLink` - Inline link
+
+### Conditional Components
+
+- `If` - Conditional rendering
+- `Switch` - Switch/case rendering
+
+### Container Components
+
+- `Form` - Form container
+- `SingleColumnLayout` - Screen layout
+
+## API Reference
+
+### `RoovyClient`
+
+```python
+RoovyClient(
+    api_key: str | None = None,      # API key (or ROOVY_API_KEY env var)
+    base_url: str | None = None,     # Base URL (or ROOVY_BASE_URL env var)
+    model: str | None = None,        # Model name (or ROOVY_MODEL env var)
+)
+```
+
+### `client.generate()`
+
+```python
+client.generate(
+    prompt: str,                     # Natural language description
+    *,
+    max_retries: int = 3,           # Number of retry attempts
+    temperature: float = 0.2,        # LLM temperature
+    system_prompt: str | None = None, # Custom system prompt
+) -> WhatsAppFlow
+```
+
+### `client.generate_stream()`
+
+```python
+client.generate_stream(
+    prompt: str,                     # Natural language description
+    on_chunk: Callable[[str], None] | None = None,  # Chunk callback
+    *,
+    temperature: float = 0.2,        # LLM temperature
+    system_prompt: str | None = None, # Custom system prompt
+) -> WhatsAppFlow
+```
+
+### `validate_flow()`
+
+```python
+from roovy_sdk import validate_flow
+
+result = validate_flow(flow_dict)
+# Returns: {"success": True, "data": WhatsAppFlow} or {"success": False, "error": ValidationError}
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.

roovy_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,77 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "roovy-sdk"
+version = "0.1.0"
+description = "Python SDK for generating WhatsApp Flows using LLMs"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+authors = [
+    { name = "Yash Desai", email = "contact@yashddesai.com" }
+]
+keywords = [
+    "whatsapp",
+    "whatsapp-flows",
+    "llm",
+    "ai",
+    "chatbot",
+    "meta",
+    "openai",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+dependencies = [
+    "openai>=1.0.0",
+    "pydantic>=2.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "ruff>=0.1.0",
+    "mypy>=1.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/yashdesai/roovy-sdk"
+Documentation = "https://github.com/yashdesai/roovy-sdk#readme"
+Repository = "https://github.com/yashdesai/roovy-sdk"
+Issues = "https://github.com/yashdesai/roovy-sdk/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/roovy_sdk"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/src",
+    "/README.md",
+    "/LICENSE",
+]
+
+[tool.ruff]
+line-length = 88
+target-version = "py39"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "N", "W", "UP"]
+
+[tool.mypy]
+python_version = "3.9"
+strict = true
+warn_return_any = true
+warn_unused_ignores = true