supyagent 0.1.0__tar.gz

supyagent-0.1.0/.gitignore

@@ -0,0 +1,45 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+.DS_Store
+
+# Supyagent runtime data
+.supyagent/
+
+# Environment variables
+.env
+.env.local
+
+# Test artifacts
+.pytest_cache/
+.coverage
+htmlcov/

supyagent-0.1.0/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.

supyagent-0.1.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,292 @@
+# 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/agents/assistant.yaml

@@ -0,0 +1,28 @@
+name: assistant
+description: A helpful AI assistant that can use supypowers tools
+version: "1.0"
+type: interactive
+
+model:
+  provider: anthropic/claude-3-5-sonnet-20241022
+  temperature: 0.7
+  max_tokens: 4096
+
+system_prompt: |
+  You are a helpful AI assistant. You can use tools via supypowers to help
+  accomplish tasks.
+  
+  When the user asks you to do something that requires a tool:
+  1. Check what tools are available
+  2. Use the appropriate tool
+  3. Report the results clearly
+  
+  Be concise, helpful, and accurate. If you don't have the right tool
+  for a task, let the user know.
+
+tools:
+  allow:
+    - "*"  # Allow all available tools
+
+limits:
+  max_tool_calls_per_turn: 10