erdo 0.1.4__tar.gz

erdo-0.1.4/.github/workflows/ci.yml

@@ -0,0 +1,66 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+      - master
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Lint with flake8
+        run: flake8 erdo/ --exclude=erdo/_generated/ --max-line-length=120 --ignore=E501,W503,E203,E704
+
+      - name: Check formatting with black
+        run: black --check erdo/
+
+      - name: Check import sorting with isort
+        run: isort --check-only erdo/
+
+      - name: Type check with mypy
+        run: mypy erdo/
+
+      - name: Test with pytest
+        run: pytest
+
+  build-test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.11"
+
+      - name: Install build dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build
+
+      - name: Test package build
+        run: python -m build
+
+      - name: Test package installation
+        run: |
+          pip install dist/*.whl
+          python -c "import erdo; print('Package installed successfully')"

erdo-0.1.4/.github/workflows/publish.yml

@@ -0,0 +1,84 @@
+name: Publish to PyPI
+
+on:
+  push:
+    branches:
+      - main
+    tags:
+      - "v*"
+  workflow_dispatch:
+  workflow_run:
+    workflows: ["CI"]
+    types:
+      - completed
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    if: github.event_name != 'workflow_run' || github.event.workflow_run.conclusion == 'success'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.11"
+
+      - name: Install build dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+  publish-pypi:
+    needs: build
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/')
+    environment:
+      name: pypi
+      url: https://pypi.org/p/erdo
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  publish-testpypi:
+    needs: build
+    runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/main' || github.event_name == 'workflow_dispatch'
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/erdo
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/

erdo-0.1.4/.gitignore

@@ -0,0 +1,22 @@
+# Python
+__pycache__/
+*.py[cod]
+*.so
+
+# Distribution / packaging
+build/
+dist/
+*.egg-info/
+
+# Virtual environments
+.venv/
+venv/
+
+# IDE
+.idea/
+.vscode/
+
+# OS
+.DS_Store
+
+.coverage

erdo-0.1.4/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.

erdo-0.1.4/MANIFEST.in

@@ -0,0 +1,11 @@
+include README.md
+include LICENSE*
+include PYPI_SETUP.md
+include pyproject.toml
+recursive-include erdo *.py
+recursive-include erdo *.pyi
+recursive-include erdo/bin *
+recursive-include tests *.py
+recursive-include examples *.py
+recursive-exclude * __pycache__
+recursive-exclude * *.py[co]

erdo-0.1.4/PKG-INFO

@@ -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.