erdo 0.1.4__py3-none-any.whl

erdo-0.1.4.dist-info/METADATA

@@ -0,0 +1,344 @@
+Metadata-Version: 2.4
+Name: erdo
+Version: 0.1.4
+Summary: Python SDK for building workflow automation agents with Erdo
+Project-URL: Homepage, https://erdo.ai
+Project-URL: Documentation, https://docs.erdo.ai
+Project-URL: Repository, https://github.com/erdoai/erdo-python-sdk
+Project-URL: Issues, https://github.com/erdoai/erdo-python-sdk/issues
+Author-email: Erdo AI <hello@erdo.ai>
+License: Proprietary
+License-File: LICENSE
+Keywords: agents,ai,automation,data,workflow
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: Other/Proprietary License
+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: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: typing-extensions>=4.0.0
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == 'dev'
+Requires-Dist: flake8>=6.0.0; extra == 'dev'
+Requires-Dist: isort>=5.0.0; extra == 'dev'
+Requires-Dist: mypy>=1.0.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Erdo Agent SDK
+
+Build AI agents and workflows with Python. The Erdo Agent SDK provides a declarative way to create agents that can be executed by the [Erdo platform](https://erdo.ai).
+
+## Installation
+
+```bash
+pip install erdo
+```
+
+## Quick Start
+
+### Creating Agents
+
+Create agents using the `Agent` class and define steps with actions:
+
+```python
+from erdo import Agent, state
+from erdo.actions import memory, llm
+from erdo.conditions import IsSuccess, GreaterThan
+
+# Create an agent
+data_analyzer = Agent(
+    name="data analyzer",
+    description="Analyzes data files and provides insights",
+    running_message="Analyzing data...",
+    finished_message="Analysis complete",
+)
+
+# Step 1: Search for relevant context
+search_step = data_analyzer.step(
+    memory.search(
+        query=state.query,
+        organization_scope="specific",
+        limit=5,
+        max_distance=0.8
+    )
+)
+
+# Step 2: Analyze the data with AI
+analyze_step = data_analyzer.step(
+    llm.message(
+        model="claude-sonnet-4-20250514",
+        system_prompt="You are a data analyst. Analyze the data and provide insights.",
+        query=state.query,
+        context=search_step.output.memories,
+        response_format={
+            "Type": "json_schema",
+            "Schema": {
+                "type": "object",
+                "required": ["insights", "confidence", "recommendations"],
+                "properties": {
+                    "insights": {"type": "string", "description": "Key insights found"},
+                    "confidence": {"type": "number", "description": "Confidence 0-1"},
+                    "recommendations": {"type": "array", "items": {"type": "string"}},
+                },
+            },
+        },
+    ),
+    depends_on=search_step,
+)
+```
+
+### Code Execution with External Files
+
+Use the `@agent.exec` decorator to execute code with external Python files:
+
+```python
+from erdo.types import PythonFile
+
+@data_analyzer.exec(
+    code_files=[
+        PythonFile(filename="analysis_files/analyze.py"),
+        PythonFile(filename="analysis_files/utils.py"),
+    ]
+)
+def execute_analysis():
+    """Execute detailed analysis using external code files."""
+    from analysis_files.analyze import analyze_data
+    from analysis_files.utils import prepare_data
+
+    # Prepare and analyze data
+    prepared_data = prepare_data(context.parameters.get("dataset", {}))
+    results = analyze_data(context)
+
+    return results
+```
+
+### Conditional Step Execution
+
+Handle step results with conditions:
+
+```python
+from erdo.conditions import IsSuccess, GreaterThan
+
+# Store high-confidence results
+analyze_step.on(
+    IsSuccess() & GreaterThan("confidence", "0.8"),
+    memory.store(
+        memory={
+            "content": analyze_step.output.insights,
+            "description": "High-confidence data analysis results",
+            "type": "analysis",
+            "tags": ["analysis", "high-confidence"],
+        }
+    ),
+)
+
+# Execute detailed analysis for high-confidence results
+analyze_step.on(
+    IsSuccess() & GreaterThan("confidence", "0.8"),
+    execute_analysis
+)
+```
+
+### Complex Execution Modes
+
+Use execution modes for advanced workflows:
+
+```python
+from erdo import ExecutionMode, ExecutionModeType
+from erdo.actions import bot
+from erdo.conditions import And, IsAny
+from erdo.template import TemplateString
+
+# Iterate over resources
+analyze_files = agent.step(
+    action=bot.invoke(
+        bot_name="file analyzer",
+        parameters={"resource": TemplateString("{{resources}}")},
+    ),
+    key="analyze_files",
+    execution_mode=ExecutionMode(
+        mode=ExecutionModeType.ITERATE_OVER,
+        data="parameters.resource",
+        if_condition=And(
+            IsAny(key="dataset.analysis_summary", value=["", None]),
+            IsAny(key="dataset.type", value=["FILE"]),
+        ),
+    )
+)
+```
+
+### Loading Prompts
+
+Use the `Prompt` class to load prompts from files:
+
+```python
+from erdo import Prompt
+
+# Load prompts from a directory
+prompts = Prompt.load_from_directory("prompts")
+
+# Use in your agent steps
+step = agent.step(
+    llm.message(
+        system_prompt=prompts.system_prompt,
+        query=state.query,
+    )
+)
+```
+
+### State and Templating
+
+Access dynamic data using the `state` object and template strings:
+
+```python
+from erdo import state
+from erdo.template import TemplateString
+
+# Access input parameters
+query = state.query
+dataset = state.dataset
+
+# Use in template strings
+template = TemplateString("Analyzing: {{query}} for dataset {{dataset.id}}")
+```
+
+## Core Concepts
+
+### Actions
+
+Actions are the building blocks of your agents. Available action modules:
+
+- `erdo.actions.memory` - Memory storage and search
+- `erdo.actions.llm` - Large language model interactions
+- `erdo.actions.bot` - Bot invocation and orchestration
+- `erdo.actions.codeexec` - Code execution
+- `erdo.actions.utils` - Utility functions
+- `erdo.actions.resource_definitions` - Resource management
+
+### Conditions
+
+Conditions control when steps execute:
+
+- `IsSuccess()`, `IsError()` - Check step status
+- `GreaterThan()`, `LessThan()` - Numeric comparisons
+- `TextEquals()`, `TextContains()` - Text matching
+- `And()`, `Or()`, `Not()` - Logical operators
+
+### Types
+
+Key types for agent development:
+
+- `Agent` - Main agent class
+- `ExecutionMode` - Control step execution behavior
+- `PythonFile` - Reference external Python files
+- `TemplateString` - Dynamic string templates
+- `Prompt` - Prompt management
+
+## Advanced Features
+
+### Multi-Step Dependencies
+
+Create complex workflows with step dependencies:
+
+```python
+step1 = agent.step(memory.search(...))
+step2 = agent.step(llm.message(...), depends_on=step1)
+step3 = agent.step(utils.send_status(...), depends_on=[step1, step2])
+```
+
+### Dynamic Data Access
+
+Use the state object to access runtime data:
+
+```python
+# Access nested data
+user_id = state.user.id
+dataset_config = state.dataset.config.type
+
+# Use in actions
+step = agent.step(
+    memory.search(query=f"data for user {state.user.id}")
+)
+```
+
+### Error Handling
+
+Handle errors with conditions and fallback steps:
+
+```python
+from erdo.conditions import IsError
+
+main_step = agent.step(llm.message(...))
+
+# Handle errors
+main_step.on(
+    IsError(),
+    utils.send_status(
+        message="Analysis failed, please try again",
+        status="error"
+    )
+)
+```
+
+## CLI Integration
+
+Deploy your agents using the Erdo CLI:
+
+```bash
+# Install the CLI
+pip install erdo
+erdo install-cli
+
+# Login to your Erdo account
+erdo login
+
+# Sync your agents
+erdo sync
+```
+
+## Examples
+
+See the `examples/` directory for complete examples:
+
+- `agent_centric_example.py` - Comprehensive agent with multiple steps
+- `state_example.py` - State management and templating
+
+## API Reference
+
+### Core Classes
+
+- **Agent**: Main agent class for creating workflows
+- **ExecutionMode**: Control step execution (iterate, conditional, etc.)
+- **Prompt**: Load and manage prompt templates
+
+### Actions
+
+- **memory**: Store and search memories
+- **llm**: Interact with language models
+- **bot**: Invoke other bots and agents
+- **codeexec**: Execute Python code
+- **utils**: Utility functions (status, notifications, etc.)
+
+### Conditions
+
+- **Comparison**: `GreaterThan`, `LessThan`, `TextEquals`, etc.
+- **Status**: `IsSuccess`, `IsError`, `IsNull`, etc.
+- **Logical**: `And`, `Or`, `Not`
+
+### State & Templating
+
+- **state**: Access runtime parameters and data
+- **TemplateString**: Dynamic string templates with `{{variable}}` syntax
+
+## License
+
+Commercial License - see LICENSE file for details.

erdo-0.1.4.dist-info/RECORD

@@ -0,0 +1,33 @@
+erdo/__init__.py,sha256=uwb-ZI0-msDExY1gUYHZE74LQNclZu2K2g7LbBYyMc4,1121
+erdo/cli_entry.py,sha256=jz18bWz-D09rmkEvwLTAbcK1shHUqFCpiU7U7czEltY,2057
+erdo/install_cli.py,sha256=jgRoSm-MIbLHW0Sr5m78q3htRwIh7JXo_wNmpVsiAcM,4454
+erdo/integrations.py,sha256=-xYBpjYmjhJtv_UnaIfBb46cJC4icLOx9P1kOf5lM-g,4219
+erdo/py.typed,sha256=Nqnn8clbgv-5l0PgxcTOldg8mkMKrFn4TvPL-rYUUGg,1
+erdo/state.py,sha256=o89-SThDWYNjfwMZuDfier1Lx96_tLi5wYSth7dPI6I,14270
+erdo/template.py,sha256=gvlSpEN3whD4LEqY6ppeYYZuFeM9ndU68qzKP-ETRJ8,4641
+erdo/types.py,sha256=3bHOkea_xEcxXm2XcPDSW2ckNgrWJ1A_gLeTovzLjw8,44442
+erdo/_generated/__init__.py,sha256=jFLoVFeswecK5mGp4-MPWwnygol2dYIsEpnmm9gubHY,506
+erdo/_generated/internal.py,sha256=ghd1g_9WF0kXO2MkFIBxcuHuRF00SlOeT-mjJcfQNyM,1569
+erdo/_generated/internal_actions.py,sha256=fGhGsTKsgHfXIH6sKDR_Fb8eKxsVY4BTi4XniUniYfE,2320
+erdo/_generated/parameters.py,sha256=QC-_75fQg_iFu-dvI9ce4yHP9UnFItDWe6sBfzfXaig,472
+erdo/_generated/secrets.py,sha256=F2xBkFsiYXOJnZ5Tcrc9uiaakyirHlKFkYCFxZKANtw,454
+erdo/_generated/template_functions.py,sha256=mgFqsXxL36dMNptzDaGvNEjoA76nFf4k9ZRz-J4Ozdc,1174
+erdo/_generated/types.py,sha256=jaJEEiv_QTDmBTZuchQwtmU0YS8SlrbTi45nnmVEBI0,79201
+erdo/_generated/actions/__init__.py,sha256=l6NcJpJlxXJRUu2wLA6T6gq90AfPMMYPnOuSbG7kwFA,1145
+erdo/_generated/actions/analysis.py,sha256=oOnDoSVlkvPkARt4gXARRW08u8ouPdLWhronyz0d_Do,2139
+erdo/_generated/actions/bot.py,sha256=HOsx9VmtXDZ7UrX_qqNY2oCkJQJx9C1VTxBWyIgxZ-o,4390
+erdo/_generated/actions/codeexec.py,sha256=PC0gd2GAcz49unm0kv0gIrEh_XbU8MikiPBu6H6Da0Y,5494
+erdo/_generated/actions/llm.py,sha256=jyVdoxBWxSlFOeLriI3ln3nzFS5uVagINzpMnapeTTM,3775
+erdo/_generated/actions/memory.py,sha256=dDPJy0qaieTaOhx5hv1HJgpnrYhb-7knTVe8dlSKKwI,8743
+erdo/_generated/actions/resource_definitions.py,sha256=vwIC_kLclFsHZ5-XUQXAqDlXDqrqUrHzbyh8PizLfbk,6740
+erdo/_generated/actions/utils.py,sha256=zKIZj9wNa_VguBRknvMQJdUpzlcTNtpORseCeSpMCUg,11776
+erdo/_generated/actions/webparser.py,sha256=j_HG3z-pRzTGRHA-Wwa8TA6_5fE0Dd2SN3y47e_gZ9U,3909
+erdo/_generated/actions/websearch.py,sha256=-PnPTHvTyGjNrAzqXgLpRYyuN1ARVJ1koEWZfnLue2E,2440
+erdo/_generated/condition/__init__.py,sha256=B36TkgiJwtI7ha-L0uztj-IbSSD4-rb2RCWbPNayMt0,14547
+erdo/actions/__init__.py,sha256=fLtdpll3StUiKH9fTpcFxExWqBLhJyHPdBYbSpoYenw,1199
+erdo/conditions/__init__.py,sha256=xN7MS1aj4lh65CrE-94yFQXnQV8v8VjdEXMzPLTK0CU,394
+erdo-0.1.4.dist-info/METADATA,sha256=lyMfJX0Ul_wqQikLk2upkLE3-y30zwQcgAj1GIWdKho,8990
+erdo-0.1.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+erdo-0.1.4.dist-info/entry_points.txt,sha256=KFGSp8-6IE3-8dSr-3Djqye3IdEY65Y4E8fABoFUCHg,45
+erdo-0.1.4.dist-info/licenses/LICENSE,sha256=9pdgUAuBAumY5tewMdJnx2Ozj8dS6gGKsSiY-SVInu4,1034
+erdo-0.1.4.dist-info/RECORD,,

erdo-0.1.4.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py3-none-any

erdo-0.1.4.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+erdo = erdo.cli_entry:main

erdo-0.1.4.dist-info/licenses/LICENSE

@@ -0,0 +1,22 @@
+Erdo Agents SDK License
+
+Copyright (c) 2024 Erdo AI LLC
+
+All rights reserved.
+
+This software is proprietary to Erdo AI LLC and is protected by copyright law.
+No part of this software may be reproduced, distributed, or transmitted in
+any form or by any means, including photocopying, recording, or other
+electronic or mechanical methods, without the prior written permission of
+Erdo AI LLC, except in the case of brief quotations embodied in critical reviews
+and certain other noncommercial uses permitted by copyright law.
+
+For permission requests, contact: legal@erdo.ai
+
+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.