agentify-toolkit 0.4.3a1__py3-none-any.whl

agentify_toolkit-0.4.3a1.dist-info/METADATA

@@ -0,0 +1,345 @@
+Metadata-Version: 2.4
+Name: agentify_toolkit
+Version: 0.4.3a1
+Summary: Declarative AI toolkit
+Author-email: Lewis Sheridan <lewis@backplane.dev>
+License:                                  Apache License
+                                   Version 2.0, January 2004
+                                http://www.apache.org/licenses/
+        
+        TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+        
+        1.  Definitions.
+            "License" shall mean the terms and conditions for use, reproduction,
+            and distribution as defined by Sections 1 through 9 of this document.
+        
+            "Licensor" shall mean the copyright owner or entity authorized by
+            the copyright owner that is granting the License.
+        
+            "Legal Entity" shall mean the union of the acting entity and all
+            other entities that control, are controlled by, or are under common
+            control with that entity.
+        
+            "You" (or "Your") shall mean an individual or Legal Entity
+            exercising permissions granted by this License.
+        
+            "Source" form shall mean the preferred form for making modifications,
+            including but not limited to software source code, documentation
+            source, and configuration files.
+        
+            "Object" form shall mean any form resulting from mechanical
+            transformation or translation of a Source form, including but
+            not limited to compiled object code, generated documentation,
+            and conversions to other media types.
+        
+            "Work" shall mean the work of authorship, whether in Source or
+            Object form, made available under the License, as indicated by a
+            copyright notice that is included in or attached to the work.
+        
+            "Derivative Works" shall mean any work, whether in Source or Object
+            form, that is based on (or derived from) the Work and for which the
+            editorial revisions, annotations, elaborations, or other modifications
+            represent, as a whole, an original work of authorship.
+        
+            "Contribution" shall mean any work of authorship, including
+            the original version of the Work and any modifications or additions
+            to that Work or Derivative Works thereof, that is intentionally
+            submitted to Licensor for inclusion in the Work by the copyright owner
+            or by an individual or Legal Entity authorized to submit on behalf of
+            the copyright owner.
+        
+            "Contributor" shall mean Licensor and any individual or Legal Entity
+            on behalf of whom a Contribution has been received by Licensor and
+            subsequently incorporated within the Work.
+        
+        2.  Grant of Copyright License.
+            Subject to the terms and conditions of this License, each Contributor
+            hereby grants to You a perpetual, worldwide, non-exclusive, no-charge,
+            royalty-free, irrevocable copyright license to reproduce, prepare
+            Derivative Works of, publicly display, publicly perform, sublicense,
+            and distribute the Work and such Derivative Works in Source or Object
+            form.
+        
+        3.  Grant of Patent License.
+            Subject to the terms and conditions of this License, each Contributor
+            hereby grants to You a perpetual, worldwide, non-exclusive, no-charge,
+            royalty-free, irrevocable patent license to make, have made, use,
+            offer to sell, sell, import, and otherwise transfer the Work.
+        
+        4.  Redistribution.
+            You may reproduce and distribute copies of the Work or Derivative
+            Works thereof in any medium, with or without modifications, provided
+            that You meet the following conditions:
+        
+            (a) You must give any other recipients of the Work or
+            Derivative Works a copy of this License; and
+        
+            (b) You must cause any modified files to carry prominent notices
+            stating that You changed the files; and
+        
+            (c) You must retain, in the Source form of any Derivative Works,
+            all copyright, patent, trademark, and attribution notices.
+        
+        5.  Submission of Contributions.
+            Unless You explicitly state otherwise, any Contribution intentionally
+            submitted for inclusion in the Work shall be under the terms and
+            conditions of this License.
+        
+        6.  Trademarks.
+            This License does not grant permission to use the trade names,
+            trademarks, service marks, or product names of the Licensor.
+        
+        7.  Disclaimer of Warranty.
+            Unless required by applicable law or agreed to in writing, Licensor
+            provides the Work on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS
+            OF ANY KIND.
+        
+        8.  Limitation of Liability.
+            In no event shall any Contributor be liable for any damages arising
+            from the use of the Work.
+        
+        9.  Accepting Warranty or Additional Liability.
+            While redistributing the Work, You may choose to offer support or
+            warranty obligations on Your own behalf.
+        
+        END OF TERMS AND CONDITIONS
+        
+Project-URL: Homepage, https://github.com/backplane-cloud/agentify-toolkit
+Project-URL: Issues, https://github.com/backplane-cloud/agentify-toolkit/issues
+Keywords: ai,agents,llm,openai,anthropic,bedrock
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0
+Requires-Dist: click>=8.1
+Requires-Dist: openai>=1.0
+Requires-Dist: anthropic>=0.25
+Requires-Dist: boto3>=1.34
+Requires-Dist: xai_sdk>=1.5.0
+Requires-Dist: google-genai>=0.8
+Requires-Dist: fastapi<1.0.0,>=0.128.0
+Requires-Dist: uvicorn>=0.26
+Requires-Dist: python-multipart>=0.0.6
+Dynamic: license-file
+
+# 📦 Agentify - Declarative AI Agent Toolkit
+
+[![PyPI](https://img.shields.io/pypi/v/agentify)](https://pypi.org/project/agentify-toolkit/)
+[![Python Version](https://img.shields.io/pypi/pyversions/agentify)](https://www.python.org/)
+[![License](https://img.shields.io/badge/license-Apache%202.0-blue)](LICENSE)
+[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/backplane-cloud/agentify-toolkit/blob/main/examples/notebooks/Agentify_Developer_Quickstart.ipynb)
+
+**Build and experiment with AI agents using simple declarative specs.**
+
+Agentify is a lightweight, declarative-first toolkit for prototyping AI agents. It lets you define agents as YAML specs and test them rapidly from the CLI or Python, without committing to a framework or model provider.
+
+> Use YAML for declarative specs, or Python for full control - both use the same agent model.
+
+> Note: Agentify is not a workflow orchestrator, runtime platform, or production framework. It’s for rapid Agent building, experimentation and prototyping.
+
+## Why Agentify ?
+
+Most agent frameworks optimise for running agents - orchestration, routing, retries, supervision, cloud execution.
+
+But before production comes a more important phase:
+**figuring out what the agent should even do.**
+
+Agentify optimises for that phase.
+
+### Designed For:
+
+✔ Rapid agent prototyping & ideation
+
+✔ Teams exploring internal AI use cases
+
+✔ Startups validating agent product ideas
+
+✔ Teaching & education (low cognitive overhead)
+
+✔ Provider portability (no early lock-in)
+
+## Quickstart
+
+### 1. Install
+
+```bash
+pip install agentify-toolkit
+```
+
+### 2. Add an LLM Provider Key
+
+```bash
+# anthropic | openai | xai | google | bedrock
+agentify providers add <provider>
+```
+
+Verify:
+
+```bash
+agentify providers list
+```
+
+Example Output:
+
+```bash
+ anthropic
+  env: ANTHROPIC_API_KEY
+  status: READY
+```
+
+### 3. Create an Agent (YAML)
+
+```yaml
+name: claude
+description: AI Engineer
+version: 0.1.0
+model:
+  provider: anthropic
+  id: claude-sonnet-4-5
+  api_key_env: ANTHROPIC_API_KEY
+role: |
+  You are an AI Security Engineer.
+  Provide concise, practical answers with examples.
+```
+
+### 4. Run the Agent
+
+```bash
+agentify run agent.yaml
+```
+
+**You’ve just built your first AI agent with Agentify!**
+
+> 💡 Tip: Running multiple agents
+
+If you have multiple agents, put them in a single folder and run `agentify run <foldername>`. Agentify will provide an interactive menu so you can choose which agent you want to experiment with.
+
+> 💡 Tip: Overriding the model
+
+If you want to experiment with a different model, simply add `--provider=openai model=gpt-5-nano` to your call. Ensure you have registered the appropriate provider API key.
+
+```bash
+agentify run agent.yaml --provider=openai --model=gpt-5-nano
+```
+
+## Core Ideas
+
+### 1. Declarative Agents (YAML-first)
+
+Agents become artifacts:
+
+- version controlled
+- diffable
+- shareable
+- auditable
+
+### 2. Provider Abstraction Without Lock-in
+
+Most ecosystems ask:
+
+> “Am I building on OpenAI, Anthropic, Bedrock, XAI, or Google?”
+
+Agentify flips it:
+
+> “The agent spec stays the same - only the provider changes.”
+
+### 3. CLI-first Exploration
+
+CLI interaction is fast, ergonomic, and repeatable:
+
+```bash
+agentify run agent.yaml
+```
+
+### 4. Agent = Single File
+
+Agents collapse to a spec, not a codebase
+
+### Key Features
+
+- Declarative agent definitions via YAML
+
+- Multi-provider LLM support (OpenAI, Anthropic, XAI, Gemini, Bedrock)
+
+- Interactive CLI and TUI for exploring agents
+
+- Programmatic API for custom workflows
+
+- Lightweight: Click + Rich + PyYAML
+
+### Documentation & Notebooks
+
+Prefer a guided walkthrough?
+
+- Developer Quickstart (Notebook)
+  `examples/notebooks/Agentify_Developer_Quickstart.ipynb`
+
+- YAML Deep Dive
+  `examples/notebooks/Agentify_YAML_Deep_Dive.ipynb`
+
+## Programmatic Usage
+
+```python
+from agentify import Agent
+
+agent = Agent(
+    name="Grok",
+    description="X's Grok Agent",
+    provider="x",
+    model_id="grok-4",
+    role="You are an AI Security Architect specialising in X AI Grok models"
+)
+
+response = agent.run("Which AI LLM is the best in 1 sentence?")
+print(response)
+```
+
+### CLI Reference
+
+| Action                    | Command                      |
+| ------------------------- | ---------------------------- |
+| Run from YAML             | `agentify run agent.yaml`    |
+| Run folder of agents      | `agentify run agents/`       |
+| List agents interactively | `agentify list agents`       |
+| Add a provider API key    | `agentify providers add <p>` |
+| List provider credentials | `agentify providers list`    |
+
+## Supported Providers & Keys
+
+| Provider   | Env Var                           |
+| ---------- | --------------------------------- |
+| OpenAI     | `export OPENAI_API_KEY=...`       |
+| Anthropic  | `export ANTHROPIC_API_KEY=...`    |
+| Gemini     | `export GEMINI_API_KEY=...`       |
+| XAI (Grok) | `export XAI_API_KEY=...`          |
+| Bedrock    | `export AWS_BEARER_TOKEN_BEDROCK` |
+
+Windows:
+
+```powershell
+$env:OPENAI_API_KEY="..."
+```
+
+Installation from PyPI:
+
+```bash
+pip install agentify-toolkit
+```
+
+From source:
+
+```bash
+git clone https://github.com/backplane-cloud/agentify-toolkit.git
+cd agentify-toolkit
+pip install .
+```
+
+## License
+
+Apache 2.0 - see LICENSE

agentify_toolkit-0.4.3a1.dist-info/RECORD

@@ -0,0 +1,27 @@
+agentify/__init__.py,sha256=oMcDK6mkYYs286ESmjEZZSR6GkuVAxOMBqHteADxChU,1086
+agentify/agentify.py,sha256=ZYvvg6w8H_kg0JIVdqp7J0gvLi7f6FtLP7yAfKRcwfQ,2245
+agentify/agents.py,sha256=PlNwnP29zxLjOFF9Bz_mnFMQmF8nZPe2qrRX5Gu7hkY,1148
+agentify/cli.py,sha256=qJRHOazFh4Irl-moQUotjbneYG3lsa8KYOB-o5GNkbA,8852
+agentify/cli_config.py,sha256=YAr-zMjmFsTz3GPEs1EUw9l0t4uhvbCDPvrp9HW_8H4,2189
+agentify/cli_ui.py,sha256=sr7a8o19E0TbNIrQ2JXhV4czBAoxJzt631aewqp4Q-g,1349
+agentify/runtime_client.py,sha256=HTMon6UyzjxBXLwx1qNqQlVxKD0Ne5lU6aU3fQUV8dI,702
+agentify/specs.py,sha256=r9UBanXj_y_q7v1NPtWT7KaY5kBU0O6WOrXsE3EOsNQ,469
+agentify/web.py,sha256=ax_aL6wOMXNgF2O0nskzavr9lUU5BpDHOhRxNKuvk5U,2485
+agentify/providers/__init__.py,sha256=6tE9vC8Q3xUQhWhn4KuY6a2A4sMcMiB7wtjjJ7d4srY,152
+agentify/providers/anthropic.py,sha256=SIKNx3GeEScZLlHd9xlqw2tSLvJKM95iEESnQl_DC1s,376
+agentify/providers/bedrock.py,sha256=Vn0J5WhqM7Fl8tdqOGFn8YnctKhQ6VXjS7NNIL11Nw0,815
+agentify/providers/google.py,sha256=-g4f63jg1wlI0nyWJI4xhV9Il2XdDcmtIdWOAHmESpc,241
+agentify/providers/openai.py,sha256=s-YOuMZf8z2WxBbIVRpP0ihoq4QsTPxsnqLgriJh4ng,235
+agentify/providers/x.py,sha256=Cx7X4QBJYCw41L--NSMdsj4U3imhxNoXXUSSwC6Dblo,372
+agentify/ui/basic-chat.css,sha256=xDOeWer2S-6Lqndy6o_IZTIoi8-xP3YJvCY0XBNDpgA,4072
+agentify/ui/chat.css,sha256=xDOeWer2S-6Lqndy6o_IZTIoi8-xP3YJvCY0XBNDpgA,4072
+agentify/ui/chat.html,sha256=-ywd5qeHw5iXHgohUX9jfc2-qlWLSVaKYldrjSZsGLY,3298
+agentify/ui/htmx.min.js,sha256=Iig-9oy3VFkU8KiKG97cclanA9HVgMHSVSF9ClDTExM,51250
+agentify/ui/retro-chat.css,sha256=6W5tEHqzySO-R80RaGR08Z14ucoPira4RGahnzOdxeM,6377
+agentify_toolkit-0.4.3a1.dist-info/licenses/LICENSE,sha256=a9MaBsii4zW-lRU12u_aOjEJJp4JtfaT3csBAzUtUL0,4434
+agentify_toolkit-0.4.3a1.dist-info/licenses/NOTICE,sha256=Q80PKb0Wx4bOrsTTGvqhR6QW38VsvP1u8NEe9RXvlZc,118
+agentify_toolkit-0.4.3a1.dist-info/METADATA,sha256=AeZXCTR3q92QFUQbtttNEF79Z6hDe3LLBLgOijDKcDQ,11585
+agentify_toolkit-0.4.3a1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+agentify_toolkit-0.4.3a1.dist-info/entry_points.txt,sha256=lAkisVfpaZIa3KnsztvoTvjmnJHi1yfqJ6foYHe_Si4,47
+agentify_toolkit-0.4.3a1.dist-info/top_level.txt,sha256=CCf3k3CZa3QRordju8w8_I4eMCv7BtsM7rTfq21EkdQ,9
+agentify_toolkit-0.4.3a1.dist-info/RECORD,,

agentify_toolkit-0.4.3a1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

agentify_toolkit-0.4.3a1.dist-info/entry_points.txt

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

agentify_toolkit-0.4.3a1.dist-info/licenses/LICENSE

@@ -0,0 +1,100 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1.  Definitions.
+    "License" shall mean the terms and conditions for use, reproduction,
+    and distribution as defined by Sections 1 through 9 of this document.
+
+    "Licensor" shall mean the copyright owner or entity authorized by
+    the copyright owner that is granting the License.
+
+    "Legal Entity" shall mean the union of the acting entity and all
+    other entities that control, are controlled by, or are under common
+    control with that entity.
+
+    "You" (or "Your") shall mean an individual or Legal Entity
+    exercising permissions granted by this License.
+
+    "Source" form shall mean the preferred form for making modifications,
+    including but not limited to software source code, documentation
+    source, and configuration files.
+
+    "Object" form shall mean any form resulting from mechanical
+    transformation or translation of a Source form, including but
+    not limited to compiled object code, generated documentation,
+    and conversions to other media types.
+
+    "Work" shall mean the work of authorship, whether in Source or
+    Object form, made available under the License, as indicated by a
+    copyright notice that is included in or attached to the work.
+
+    "Derivative Works" shall mean any work, whether in Source or Object
+    form, that is based on (or derived from) the Work and for which the
+    editorial revisions, annotations, elaborations, or other modifications
+    represent, as a whole, an original work of authorship.
+
+    "Contribution" shall mean any work of authorship, including
+    the original version of the Work and any modifications or additions
+    to that Work or Derivative Works thereof, that is intentionally
+    submitted to Licensor for inclusion in the Work by the copyright owner
+    or by an individual or Legal Entity authorized to submit on behalf of
+    the copyright owner.
+
+    "Contributor" shall mean Licensor and any individual or Legal Entity
+    on behalf of whom a Contribution has been received by Licensor and
+    subsequently incorporated within the Work.
+
+2.  Grant of Copyright License.
+    Subject to the terms and conditions of this License, each Contributor
+    hereby grants to You a perpetual, worldwide, non-exclusive, no-charge,
+    royalty-free, irrevocable copyright license to reproduce, prepare
+    Derivative Works of, publicly display, publicly perform, sublicense,
+    and distribute the Work and such Derivative Works in Source or Object
+    form.
+
+3.  Grant of Patent License.
+    Subject to the terms and conditions of this License, each Contributor
+    hereby grants to You a perpetual, worldwide, non-exclusive, no-charge,
+    royalty-free, irrevocable patent license to make, have made, use,
+    offer to sell, sell, import, and otherwise transfer the Work.
+
+4.  Redistribution.
+    You may reproduce and distribute copies of the Work or Derivative
+    Works thereof in any medium, with or without modifications, provided
+    that You meet the following conditions:
+
+    (a) You must give any other recipients of the Work or
+    Derivative Works a copy of this License; and
+
+    (b) You must cause any modified files to carry prominent notices
+    stating that You changed the files; and
+
+    (c) You must retain, in the Source form of any Derivative Works,
+    all copyright, patent, trademark, and attribution notices.
+
+5.  Submission of Contributions.
+    Unless You explicitly state otherwise, any Contribution intentionally
+    submitted for inclusion in the Work shall be under the terms and
+    conditions of this License.
+
+6.  Trademarks.
+    This License does not grant permission to use the trade names,
+    trademarks, service marks, or product names of the Licensor.
+
+7.  Disclaimer of Warranty.
+    Unless required by applicable law or agreed to in writing, Licensor
+    provides the Work on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS
+    OF ANY KIND.
+
+8.  Limitation of Liability.
+    In no event shall any Contributor be liable for any damages arising
+    from the use of the Work.
+
+9.  Accepting Warranty or Additional Liability.
+    While redistributing the Work, You may choose to offer support or
+    warranty obligations on Your own behalf.
+
+END OF TERMS AND CONDITIONS

agentify_toolkit-0.4.3a1.dist-info/licenses/NOTICE

@@ -0,0 +1,6 @@
+Agentify
+
+Copyright 2026 Backplane
+
+This product includes software developed by contributors
+to the Agentify project.

agentify_toolkit-0.4.3a1.dist-info/top_level.txt

@@ -0,0 +1 @@
+agentify