supyagent 0.1.0__py3-none-any.whl

supyagent-0.1.0.dist-info/METADATA

@@ -0,0 +1,328 @@
+Metadata-Version: 2.4
+Name: supyagent
+Version: 0.1.0
+Summary: LLM agents powered by supypowers - build AI agents with tool use, multi-agent orchestration, and secure credential management
+Project-URL: Homepage, https://github.com/ergodic-ai/supyagent
+Project-URL: Documentation, https://github.com/ergodic-ai/supyagent#readme
+Project-URL: Repository, https://github.com/ergodic-ai/supyagent
+Project-URL: Issues, https://github.com/ergodic-ai/supyagent/issues
+Author-email: Ergodic AI <hello@ergodic.ai>
+License: MIT
+License-File: LICENSE
+Keywords: agent,ai,automation,chatbot,litellm,llm,multi-agent,orchestration,supypowers,tools
+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.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
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: click>=8.0
+Requires-Dist: cryptography>=41.0
+Requires-Dist: litellm>=1.30.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=4.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Supyagent
+
+[![PyPI version](https://badge.fury.io/py/supyagent.svg)](https://badge.fury.io/py/supyagent)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+LLM agents powered by [supypowers](https://github.com/ergodic-ai/supypowers) tools.
+
+## Features
+
+- 🤖 **Interactive & Execution Agents** - Chat interactively or run automated pipelines
+- 🔧 **Tool Integration** - Use any supypowers function as an agent tool
+- 🌐 **Any LLM Provider** - Via [LiteLLM](https://docs.litellm.ai/docs/) (OpenAI, Anthropic, Ollama, etc.)
+- 📝 **YAML Configuration** - Simple, declarative agent definitions
+- 🔄 **Session Persistence** - Conversations persist across sessions
+- 🔐 **Credential Management** - Secure storage for API keys and secrets
+- 🎭 **Multi-Agent Orchestration** - Agents can delegate tasks to other agents
+- 📦 **Batch Processing** - Process multiple inputs from JSONL/CSV files
+
+## Installation
+
+```bash
+pip install supyagent
+```
+
+Or with [uv](https://github.com/astral-sh/uv):
+
+```bash
+uv pip install supyagent
+```
+
+## Quick Start
+
+```bash
+# Create your first agent
+supyagent new myagent
+
+# Start chatting
+supyagent chat myagent
+```
+
+## Usage
+
+### Interactive Mode
+
+```bash
+# Create an interactive agent
+supyagent new researcher
+
+# Chat with it
+supyagent chat researcher
+
+# Resume a previous session
+supyagent chat researcher --session <session-id>
+
+# Start fresh
+supyagent chat researcher --new
+```
+
+### Execution Mode
+
+For automation and pipelines:
+
+```bash
+# Create an execution agent
+supyagent new summarizer --type execution
+
+# Run with inline input
+supyagent run summarizer "Summarize this text..."
+
+# Run with file input
+supyagent run summarizer --input document.txt
+
+# Get JSON output
+supyagent run summarizer --input doc.txt --output json
+
+# Pipe from stdin
+cat article.txt | supyagent run summarizer
+```
+
+### Batch Processing
+
+```bash
+# Process multiple inputs
+supyagent batch summarizer inputs.jsonl --output results.jsonl
+
+# From CSV
+supyagent batch summarizer data.csv --format csv
+```
+
+### Multi-Agent Orchestration
+
+```bash
+# Use the planning agent to orchestrate complex tasks
+supyagent plan "Build a Python library for data validation"
+
+# The planner will delegate to specialist agents (coder, writer, researcher)
+```
+
+## Agent Configuration
+
+Agents are defined in YAML files in the `agents/` directory:
+
+```yaml
+name: researcher
+description: An AI research assistant
+type: interactive  # or "execution"
+
+model:
+  provider: anthropic/claude-3-5-sonnet-20241022
+  temperature: 0.7
+  max_tokens: 4096
+
+system_prompt: |
+  You are a helpful research assistant...
+
+tools:
+  allow:
+    - "*"           # Allow all tools
+    # or be specific:
+    # - "web:*"     # All functions in web.py
+    # - "math:calc" # Specific function
+  deny:
+    - "dangerous:*" # Block specific tools
+
+# For multi-agent support
+delegates:
+  - coder
+  - writer
+```
+
+### LLM Providers
+
+Supyagent uses LiteLLM, supporting 100+ providers:
+
+```yaml
+model:
+  # OpenAI
+  provider: openai/gpt-4o
+  
+  # Anthropic
+  provider: anthropic/claude-3-5-sonnet-20241022
+  
+  # Ollama (local)
+  provider: ollama/llama3
+  
+  # Azure OpenAI
+  provider: azure/gpt-4
+  
+  # Google
+  provider: gemini/gemini-pro
+```
+
+Set API keys as environment variables:
+
+```bash
+export OPENAI_API_KEY=sk-...
+export ANTHROPIC_API_KEY=sk-ant-...
+```
+
+## CLI Reference
+
+### Core Commands
+
+| Command | Description |
+|---------|-------------|
+| `supyagent new <name>` | Create a new agent |
+| `supyagent list` | List all agents |
+| `supyagent show <name>` | Show agent details |
+| `supyagent chat <name>` | Interactive chat session |
+| `supyagent run <name> <task>` | Execute agent (non-interactive) |
+| `supyagent batch <name> <file>` | Process multiple inputs |
+| `supyagent plan <task>` | Run task through planning agent |
+
+### Session Commands
+
+| Command | Description |
+|---------|-------------|
+| `supyagent sessions <name>` | List sessions for an agent |
+| `supyagent chat <name> --session <id>` | Resume a session |
+| `supyagent chat <name> --new` | Start a new session |
+
+### Agent Management
+
+| Command | Description |
+|---------|-------------|
+| `supyagent agents` | List active agent instances |
+| `supyagent cleanup` | Remove completed instances |
+
+### In-Chat Commands
+
+While chatting, use these commands:
+
+| Command | Description |
+|---------|-------------|
+| `/help` | Show available commands |
+| `/tools` | List available tools |
+| `/history` | Show conversation history |
+| `/sessions` | List your sessions |
+| `/switch <id>` | Switch to another session |
+| `/new` | Start a new session |
+| `/save <title>` | Save session with title |
+| `/export <file>` | Export session to file |
+| `/model <name>` | Switch LLM model |
+| `/creds` | Manage stored credentials |
+| `/clear` | Clear conversation history |
+| `/quit` | Exit the chat |
+
+## Project Structure
+
+```
+your-project/
+├── agents/              # Agent YAML definitions
+│   ├── assistant.yaml
+│   ├── planner.yaml
+│   └── researcher.yaml
+├── supypowers/          # Tool definitions (Python)
+│   ├── hello.py
+│   └── web_search.py
+└── .supyagent/          # Runtime data (gitignore this)
+    ├── sessions/        # Conversation history
+    ├── credentials/     # Encrypted secrets
+    └── registry.json    # Agent instances
+```
+
+## Credential Management
+
+Supyagent securely manages API keys and secrets:
+
+```bash
+# In chat, agents can request credentials
+🔑 Credential requested: SLACK_API_TOKEN
+   Purpose: To send messages to Slack
+Enter value (or press Enter to skip): ****
+Save for future sessions? [Y/n]: y
+
+# View stored credentials
+/creds
+```
+
+Credentials are encrypted at rest using Fernet encryption.
+
+## Multi-Agent Architecture
+
+Create orchestrator agents that delegate to specialists:
+
+```yaml
+# agents/planner.yaml
+name: planner
+type: interactive
+
+delegates:
+  - researcher  # Can delegate research tasks
+  - coder       # Can delegate coding tasks
+  - writer      # Can delegate writing tasks
+
+system_prompt: |
+  You are a planning agent. Break down complex tasks
+  and delegate to specialist agents...
+```
+
+The planner can then:
+1. Analyze tasks
+2. Create execution plans
+3. Delegate subtasks to appropriate agents
+4. Synthesize results
+
+## Development
+
+```bash
+# Clone the repo
+git clone https://github.com/ergodic-ai/supyagent
+cd supyagent
+
+# Install with dev dependencies
+uv pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Run linting
+ruff check .
+```
+
+## License
+
+MIT
+
+## Related Projects
+
+- [supypowers](https://github.com/ergodic-ai/supypowers) - Tool execution framework
+- [LiteLLM](https://github.com/BerriAI/litellm) - LLM provider abstraction

supyagent-0.1.0.dist-info/RECORD

@@ -0,0 +1,24 @@
+supyagent/__init__.py,sha256=JrrQbk1bmDhUb2qOqxqDGBq1V-oArwVS4f5f9Qu-VcM,77
+supyagent/__main__.py,sha256=szUvsccEIA428c2_5J_X1qzq4L44qLvDvHfuRPYoy7c,121
+supyagent/cli/__init__.py,sha256=7jb5kxHtzce4rNKd9zrAiATp3Zxj7UQvtpQsyA97BTc,32
+supyagent/cli/main.py,sha256=5oM_IZ85C3gyW_ypPmFi3x-khkgd7tZrbowW_kJ_JhY,31028
+supyagent/core/__init__.py,sha256=5GOA6Ca5UBWG_d6lhfZxYdKdDjnKE4UdVooe0lUDpe0,626
+supyagent/core/agent.py,sha256=mkiV6CnK6Vk0Wg-DiAMm29wAViMa52-1Yb33Y5-FvQY,12655
+supyagent/core/context.py,sha256=ywen6IjWxcudxtipeqA_PHpZKdjK52eqOb9xy7QKnTM,4565
+supyagent/core/credentials.py,sha256=35JBrzMOEDzHnn3XuyGmRjXVdSICL3tups3BLO_NCXQ,7600
+supyagent/core/delegation.py,sha256=B6OYlLjkZaRTPMQsK9nIGeXVO9JeC7RDpxXsOk652xs,9391
+supyagent/core/executor.py,sha256=awJXseQKO0I-D-5YqGxJ9MEN1b2DTVk_8kOQZExFYhs,7893
+supyagent/core/llm.py,sha256=z16cjqjPfwRGtEpUhZe1XlzOXJdlgKHjckNdeJnEWYw,1898
+supyagent/core/registry.py,sha256=1CGCPsOcrIc_63_oJaFmHY8WwMgJEvbwsv8mnsOBWtY,7326
+supyagent/core/session_manager.py,sha256=ngqrbofR8V0wZSuOfGHTtSYE0C9U6noDrzfDsO8wi24,7389
+supyagent/core/tools.py,sha256=exIynhwulsMJTzzW5NmDqBeXepULAt4FlVhGbtrvdXE,6627
+supyagent/models/__init__.py,sha256=y7fIdzh-yD0LKAK0zfY_MZdtjJhxofwRWBqrHDU93h0,259
+supyagent/models/agent_config.py,sha256=sQ7S7zExoFs0g-IMgACsGH2SMiDRjJTnCVZwhN6DnkY,2570
+supyagent/models/session.py,sha256=_Dwuija_Uvt_KzcNp82ja8qP5ltNHHz43Llug1vq1ic,1136
+supyagent/utils/__init__.py,sha256=l4HdE3n8axphMInBex1J1dB_O1MjzbZz6ot1l8Syf0g,39
+supyagent/utils/paths.py,sha256=Xum9kX_UjRvmshifSq423QsAKynpnyAVfpWuFjlsdDQ,692
+supyagent-0.1.0.dist-info/METADATA,sha256=ooG14oWAy-YelwL-QC3DDZL8aFhDzM6Gs9mdjFW3xw4,8430
+supyagent-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+supyagent-0.1.0.dist-info/entry_points.txt,sha256=7dFXWtRewhLfA5XUckV7Yu1E5_c6c9lq8Gz-7BFs6TM,53
+supyagent-0.1.0.dist-info/licenses/LICENSE,sha256=35fw1cvTM-IhiR3xaUohbiFBc2OBNRjI5z1b1cF7vZI,1067
+supyagent-0.1.0.dist-info/RECORD,,

supyagent-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

supyagent-0.1.0.dist-info/entry_points.txt

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

supyagent-0.1.0.dist-info/licenses/LICENSE

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