smartify-ai 0.1.0__py3-none-any.whl

smartify_ai-0.1.0.dist-info/METADATA

@@ -0,0 +1,201 @@
+Metadata-Version: 2.4
+Name: smartify-ai
+Version: 0.1.0
+Summary: Local runtime for Agent Swarms using the Smartify Grid specification
+Project-URL: Documentation, https://docs.smartify.ai
+Project-URL: Repository, https://github.com/smartify/smartify
+Author-email: smartifyai <hello@smartify.ai>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agents,ai,automation,orchestration
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.11
+Requires-Dist: anthropic>=0.18
+Requires-Dist: fastapi>=0.109
+Requires-Dist: httpx<0.28,>=0.25
+Requires-Dist: openai>=1.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0
+Requires-Dist: tiktoken>=0.5
+Requires-Dist: typer>=0.9
+Requires-Dist: uvicorn>=0.25
+Provides-Extra: all
+Requires-Dist: smartify[dev,mcp]; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: mypy>=1.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.1; extra == 'dev'
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0; extra == 'mcp'
+Description-Content-Type: text/markdown
+
+# Smartify Runtime
+
+Open-source runtime for AI agent swarms. Orchestrate multiple agents with guardrails, plug-and-play tool integrations (including MCP), and coordinate complex workflows for SaaS applications.
+
+## Features
+
+- **Agent Swarms** - Coordinate multiple AI agents in a hierarchy (controller → relay → substation)
+- **Multi-Provider** - Anthropic and OpenAI adapters, easily extensible to other providers
+- **MCP Integration** - Plug-and-play with any [Model Context Protocol](https://modelcontextprotocol.io) server
+- **Guardrails** - Token, time, and cost limits with configurable breaker actions
+- **Parallel Execution** - Run tasks concurrently within constraints
+- **Grid YAML** - Declarative workflow specification
+- **CLI & API** - Command-line and REST API interfaces
+- **Checkpoint/Resume** - Persist and resume long-running workflows
+
+## Quick Start
+
+### Installation
+
+```bash
+# Basic installation
+pip install smartify
+
+# With MCP support (for external tool servers)
+pip install smartify[mcp]
+
+# Development (includes tests, linting)
+pip install -e ".[dev]"
+
+# Everything
+pip install -e ".[all]"
+```
+
+### Validate a Grid
+
+```bash
+smartify validate examples/minimal.yaml
+```
+
+### Run a Grid
+
+```bash
+smartify run examples/calculator.yaml --input project_name=myapp
+```
+
+### Check Status
+
+```bash
+smartify status <run_id>
+```
+
+## Grid Structure
+
+```yaml
+apiVersion: smartify.ai/v1
+kind: GridSpec
+
+metadata:
+  id: my-grid
+  name: My Grid
+
+topology:
+  nodes:
+    - id: controller
+      kind: controller
+      name: Main Controller
+      description: Orchestrate the workflow
+
+    - id: relay_build
+      kind: relay
+      parent: controller
+      name: Build Relay
+
+    - id: sub_impl
+      kind: substation
+      parent: relay_build
+      name: Implementation
+```
+
+## Node Types
+
+| Kind | Description |
+|------|-------------|
+| `controller` | Primary orchestrator (exactly 1 per grid) |
+| `relay` | Coordination/delegation node |
+| `substation` | Task execution node |
+| `foreach` | Fan-out iteration |
+| `aggregate` | Fan-in merge |
+| `approval` | Human-in-the-loop checkpoint |
+
+## MCP Integration
+
+Connect to external [Model Context Protocol](https://modelcontextprotocol.io) servers for plug-and-play tool access.
+
+```yaml
+# In your grid YAML
+tools:
+  mcpServers:
+    - id: filesystem
+      transport: stdio
+      command: npx
+      args: ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
+      prefix: fs  # Tools become: fs_read_file, fs_write_file, etc.
+```
+
+Nodes can then use MCP tools like any builtin:
+
+```yaml
+nodes:
+  - id: file-worker
+    kind: substation
+    tools:
+      - fs_read_file
+      - fs_write_file
+```
+
+See [examples/mcp-filesystem.yaml](examples/mcp-filesystem.yaml) for a complete example.
+
+## Agent Providers
+
+Smartify supports multiple LLM providers. Set your API key and the runtime auto-registers the adapter:
+
+```bash
+# Anthropic (default)
+export ANTHROPIC_API_KEY=your_key
+
+# OpenAI
+export OPENAI_API_KEY=your_key
+```
+
+Configure per-agent in grid YAML:
+
+```yaml
+agents:
+  researcher:
+    modelPolicy:
+      preferred: claude-sonnet-4-20250514
+      fallback: [gpt-4o]
+```
+
+## Development
+
+```bash
+# Install dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Run tests with MCP
+pip install -e ".[all]"
+pytest
+
+# Type checking
+mypy src/
+
+# Linting
+ruff check src/
+```
+
+## License
+
+MIT. See [LICENSE](LICENSE).

smartify_ai-0.1.0.dist-info/RECORD

@@ -0,0 +1,46 @@
+smartify/__init__.py,sha256=Za0PhLSZjQZh5Lxqj16DuyrN5b70MVQo9VMFGQ5fLTI,79
+smartify/agents/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+smartify/agents/adapters/__init__.py,sha256=bV4qm2e_UarfYo9HlDqOkTlrvEJJP0xM7t5nhU6p53Q,328
+smartify/agents/adapters/anthropic.py,sha256=WlWVkbDg31b_TpadnNKTXgs5z6QEUjznZVHwEnvkL5I,8544
+smartify/agents/adapters/openai.py,sha256=HKO49PDYbFg8Yu7J1cgNvmzSK1UW0hFV7PShLdQX7xo,10076
+smartify/api/__init__.py,sha256=LbTRg5qjNBqrzNIZVOCHNKmXiqH2v3HtUBb2ko0NMxs,469
+smartify/api/auth.py,sha256=qsdEOzhE5VLNJt6fb3-4QyabuEwO9MgYRyqDvmke4FQ,11334
+smartify/api/errors.py,sha256=1VLa7k1hOfAgak-Ceon9v9gPv0WrYlf4GCT8rJkfYkY,13080
+smartify/api/events.py,sha256=I2ef1e11Ovwcd3am3hagOfWzA9ANiMlW64PyH1GO3eQ,11091
+smartify/api/server.py,sha256=JK4VoPv8zOQXEBpUXSVSYQIQetFp0bGR4JcCjbnfooE,30335
+smartify/cli/__init__.py,sha256=aca0-tGaOaN0IAhiC7bvxjXl6_2lcLkJKAVtVSkpNXA,31
+smartify/cli/main.py,sha256=7VaABcIVxEw6do5r92BHIJzH-yvHveCaqWwB51gyCNk,14965
+smartify/engine/__init__.py,sha256=ufvvJM8xEra8edkVWUTSeiwNysYmDmM1s8TntDjv8tA,1522
+smartify/engine/approval.py,sha256=RaPq1dKAO8gphvpKLCu-m_D2-DsbBdLBiA1XycdVYIk,16227
+smartify/engine/orchestrator.py,sha256=EUwT-RUZ1M7hSO2l12odPre0oFXcTUwMq61bSj1p-tU,51729
+smartify/engine/scheduler.py,sha256=H4VyqbEkqwF9eI3QIQbU6oSUk_EJbSPM2ZtQGTTMOYM,14382
+smartify/engine/spark.py,sha256=pY0DO444TLIBVCkxCm-duEyYznXcK5NU5NMI_f2RK2Y,9587
+smartify/guardrails/__init__.py,sha256=8fU8uTZqGrIVgbdb5xVZhQaIZ1rTfHVFUMdFctb2EZw,399
+smartify/guardrails/breakers.py,sha256=QdSI3vu3CZ6mD_WY6Y3xq20lz0rd_d471YIz76Df0pE,13479
+smartify/models/__init__.py,sha256=YNhKfnn0wAQzkEyFImWm27mpzZFzzo4bKigtprbWhOs,1070
+smartify/models/grid.py,sha256=7wLcYA7n6Xsxnd90gTVFJaAmFU2SYNDyKqLs9czXljA,19675
+smartify/notifications/__init__.py,sha256=p7Ae8McecKfWMAV4T90p4f4z-ebi18IWFQ1kbbk9meA,368
+smartify/notifications/webhook.py,sha256=ArMhVqSJYVTI1nO3TMrCc3S_k89GBAkYRq0CxTZNmQk,18412
+smartify/state/__init__.py,sha256=ucXds2RLGxdb2M7zTP6yugxdUYtZTXac2Ns6fYuJiQU,913
+smartify/state/checkpoint.py,sha256=_uZ-QGb739Qf_gU8octClTLI1LzsnAkICtivrBCXYzs,20555
+smartify/state/resume.py,sha256=3a0tX-gO4COY85OFZd5ffZmafM7Q2ZXOGa9kk3VccNg,10065
+smartify/state/store.py,sha256=HWg7oHp9d9FNwCa2KD31FwNGHXTPyTCrJPlr1JoQV_E,12702
+smartify/tools/__init__.py,sha256=75DcbRRIQ5bqYNriURN-ky_MeInoQIYezpJxlQT9pJk,315
+smartify/tools/base.py,sha256=Z67XOeIoVWlJI_7LPNUjroMQkMRuDM-khTH07zrJejE,5808
+smartify/tools/builtin/__init__.py,sha256=DeWaF9JEZdcLrhs6VPV1-2qi8jF19F5-1EXoHeme6qg,1930
+smartify/tools/builtin/file.py,sha256=wLzn8TT8dPAkYMJaaGn4xKdKXzp2_UwvIT7hnvZ0O9E,14204
+smartify/tools/builtin/http.py,sha256=jmdAAvv9Cmn8_Eoadk2x5YX6uEY3THX3kvPwwvsEiqs,6464
+smartify/tools/builtin/shell.py,sha256=Kg05Pc_gF79ajJq4hGSZ3pHHdsTmBIT9gAlVjNq-zoQ,4554
+smartify/tools/mcp/__init__.py,sha256=lA1Vy83aKMuWoLP2gVj21HpEy3t50wbCiA7d_3UP7ps,821
+smartify/tools/mcp/adapter.py,sha256=gPWOwIXMsjYF1AqLosBdLl0b6do9A7g3McB_YYHm0Pk,4690
+smartify/tools/mcp/client.py,sha256=KlYv6YxN-IyVlaLMf0kXxxhhQX1KNxNXf0yrOJqSaqs,10649
+smartify/tools/mcp/registry.py,sha256=IjreV6_uNZ89Rrv7pKK0zqvOgXq1Nc8BV9OpYGsFPI4,3821
+smartify/validator/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+smartify/validator/validate.py,sha256=2DO4C_bfBLUGl5vp4PPeO5-1Auuc08cAf9l_ZjYdmVs,9222
+smartify/workspace/__init__.py,sha256=snJ9pvvrWpPrjmXvfTBu9oNyUrbqA5aM2rhGmVs95vw,169
+smartify/workspace/manager.py,sha256=oeTqYWEG_tW9NAwzbYsZhoMffCzhIMjYW-stCcn1IlM,7920
+smartify_ai-0.1.0.dist-info/METADATA,sha256=h70Vjgl0rVyd7y_ehdUPuVwNxhfvbD2_E516D3cyxio,4734
+smartify_ai-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+smartify_ai-0.1.0.dist-info/entry_points.txt,sha256=RrGT07LIgRdXPXZmYwZUEPrvx5Inic8CB6eP4nLO4F0,51
+smartify_ai-0.1.0.dist-info/licenses/LICENSE,sha256=sGVAlk8QB6ir30zz8k6LBdtZZ3BNs1lLKQrGbl9QKpo,1065
+smartify_ai-0.1.0.dist-info/RECORD,,

smartify_ai-0.1.0.dist-info/WHEEL

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

smartify_ai-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+smartify = smartify.cli.main:app

smartify_ai-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Smartify
+
+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.