supyagent 0.1.0__tar.gz → 0.2.1__tar.gz

{supyagent-0.1.0 → supyagent-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: supyagent
-Version: 0.1.0
+Version: 0.2.1
 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
@@ -68,6 +68,12 @@ uv pip install supyagent
 ## Quick Start
 
 ```bash
+# Initialize supyagent (sets up default tools)
+supyagent init
+
+# Set up your API key (stored securely)
+supyagent config set ANTHROPIC_API_KEY
+
 # Create your first agent
 supyagent new myagent
 
@@ -133,39 +139,40 @@ supyagent plan "Build a Python library for data validation"
 # The planner will delegate to specialist agents (coder, writer, researcher)
 ```
 
-## Agent Configuration
+## Configuration
 
-Agents are defined in YAML files in the `agents/` directory:
+### Setting Up API Keys
 
-```yaml
-name: researcher
-description: An AI research assistant
-type: interactive  # or "execution"
+Supyagent securely stores your LLM API keys so you don't need to export them every time:
 
-model:
-  provider: anthropic/claude-3-5-sonnet-20241022
-  temperature: 0.7
-  max_tokens: 4096
+```bash
+# Interactive setup (recommended)
+supyagent config set
+# Shows a menu of common providers to choose from
 
-system_prompt: |
-  You are a helpful research assistant...
+# Set a specific key
+supyagent config set ANTHROPIC_API_KEY
+supyagent config set OPENAI_API_KEY
 
-tools:
-  allow:
-    - "*"           # Allow all tools
-    # or be specific:
-    # - "web:*"     # All functions in web.py
-    # - "math:calc" # Specific function
-  deny:
-    - "dangerous:*" # Block specific tools
+# Import from a .env file
+supyagent config import .env
 
-# For multi-agent support
-delegates:
-  - coder
-  - writer
+# Import only specific keys
+supyagent config import .env --filter OPENAI
+
+# List configured keys
+supyagent config list
+
+# Export keys to backup
+supyagent config export backup.env
+
+# Delete a key
+supyagent config delete OPENAI_API_KEY
 ```
 
-### LLM Providers
+Keys are encrypted and stored in `~/.supyagent/config/`. They're automatically loaded when running any agent command.
+
+### Supported Providers
 
 Supyagent uses LiteLLM, supporting 100+ providers:
 
@@ -187,11 +194,36 @@ model:
   provider: gemini/gemini-pro
 ```
 
-Set API keys as environment variables:
+## Agent Configuration
 
-```bash
-export OPENAI_API_KEY=sk-...
-export ANTHROPIC_API_KEY=sk-ant-...
+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
 ```
 
 ## CLI Reference
@@ -200,6 +232,7 @@ export ANTHROPIC_API_KEY=sk-ant-...
 
 | Command | Description |
 |---------|-------------|
+| `supyagent init` | Initialize project with default tools |
 | `supyagent new <name>` | Create a new agent |
 | `supyagent list` | List all agents |
 | `supyagent show <name>` | Show agent details |
@@ -223,6 +256,16 @@ export ANTHROPIC_API_KEY=sk-ant-...
 | `supyagent agents` | List active agent instances |
 | `supyagent cleanup` | Remove completed instances |
 
+### Config Commands
+
+| Command | Description |
+|---------|-------------|
+| `supyagent config set [KEY]` | Set an API key (interactive menu if no key specified) |
+| `supyagent config list` | List all configured keys |
+| `supyagent config import <file>` | Import keys from .env file |
+| `supyagent config export <file>` | Export keys to .env file |
+| `supyagent config delete <key>` | Delete a stored key |
+
 ### In-Chat Commands
 
 While chatting, use these commands:
@@ -242,6 +285,25 @@ While chatting, use these commands:
 | `/clear` | Clear conversation history |
 | `/quit` | Exit the chat |
 
+## Bundled Tools
+
+Running `supyagent init` installs these default tools:
+
+### Shell (`shell.py`)
+- `run_command` - Execute shell commands
+- `run_script` - Run multi-line bash scripts
+- `which` - Find executable paths
+- `get_env` - Get environment variables
+
+### Files (`files.py`)
+- `read_file` / `write_file` - File I/O
+- `list_directory` - List files with glob patterns
+- `copy_file` / `move_file` / `delete_file` - File operations
+- `create_directory` - Create directories
+- `file_info` - Get file metadata
+
+You can add your own tools by creating Python files in `supypowers/`.
+
 ## Project Structure
 
 ```
@@ -251,8 +313,9 @@ your-project/
 │   ├── planner.yaml
 │   └── researcher.yaml
 ├── supypowers/          # Tool definitions (Python)
-│   ├── hello.py
-│   └── web_search.py
+│   ├── shell.py         # Shell commands (bundled)
+│   ├── files.py         # File operations (bundled)
+│   └── my_tools.py      # Your custom tools
 └── .supyagent/          # Runtime data (gitignore this)
     ├── sessions/        # Conversation history
     ├── credentials/     # Encrypted secrets

{supyagent-0.1.0 → supyagent-0.2.1}/README.md

@@ -32,6 +32,12 @@ uv pip install supyagent
 ## Quick Start
 
 ```bash
+# Initialize supyagent (sets up default tools)
+supyagent init
+
+# Set up your API key (stored securely)
+supyagent config set ANTHROPIC_API_KEY
+
 # Create your first agent
 supyagent new myagent
 
@@ -97,39 +103,40 @@ supyagent plan "Build a Python library for data validation"
 # The planner will delegate to specialist agents (coder, writer, researcher)
 ```
 
-## Agent Configuration
+## Configuration
 
-Agents are defined in YAML files in the `agents/` directory:
+### Setting Up API Keys
 
-```yaml
-name: researcher
-description: An AI research assistant
-type: interactive  # or "execution"
+Supyagent securely stores your LLM API keys so you don't need to export them every time:
 
-model:
-  provider: anthropic/claude-3-5-sonnet-20241022
-  temperature: 0.7
-  max_tokens: 4096
+```bash
+# Interactive setup (recommended)
+supyagent config set
+# Shows a menu of common providers to choose from
 
-system_prompt: |
-  You are a helpful research assistant...
+# Set a specific key
+supyagent config set ANTHROPIC_API_KEY
+supyagent config set OPENAI_API_KEY
 
-tools:
-  allow:
-    - "*"           # Allow all tools
-    # or be specific:
-    # - "web:*"     # All functions in web.py
-    # - "math:calc" # Specific function
-  deny:
-    - "dangerous:*" # Block specific tools
+# Import from a .env file
+supyagent config import .env
 
-# For multi-agent support
-delegates:
-  - coder
-  - writer
+# Import only specific keys
+supyagent config import .env --filter OPENAI
+
+# List configured keys
+supyagent config list
+
+# Export keys to backup
+supyagent config export backup.env
+
+# Delete a key
+supyagent config delete OPENAI_API_KEY
 ```
 
-### LLM Providers
+Keys are encrypted and stored in `~/.supyagent/config/`. They're automatically loaded when running any agent command.
+
+### Supported Providers
 
 Supyagent uses LiteLLM, supporting 100+ providers:
 
@@ -151,11 +158,36 @@ model:
   provider: gemini/gemini-pro
 ```
 
-Set API keys as environment variables:
+## Agent Configuration
 
-```bash
-export OPENAI_API_KEY=sk-...
-export ANTHROPIC_API_KEY=sk-ant-...
+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
 ```
 
 ## CLI Reference
@@ -164,6 +196,7 @@ export ANTHROPIC_API_KEY=sk-ant-...
 
 | Command | Description |
 |---------|-------------|
+| `supyagent init` | Initialize project with default tools |
 | `supyagent new <name>` | Create a new agent |
 | `supyagent list` | List all agents |
 | `supyagent show <name>` | Show agent details |
@@ -187,6 +220,16 @@ export ANTHROPIC_API_KEY=sk-ant-...
 | `supyagent agents` | List active agent instances |
 | `supyagent cleanup` | Remove completed instances |
 
+### Config Commands
+
+| Command | Description |
+|---------|-------------|
+| `supyagent config set [KEY]` | Set an API key (interactive menu if no key specified) |
+| `supyagent config list` | List all configured keys |
+| `supyagent config import <file>` | Import keys from .env file |
+| `supyagent config export <file>` | Export keys to .env file |
+| `supyagent config delete <key>` | Delete a stored key |
+
 ### In-Chat Commands
 
 While chatting, use these commands:
@@ -206,6 +249,25 @@ While chatting, use these commands:
 | `/clear` | Clear conversation history |
 | `/quit` | Exit the chat |
 
+## Bundled Tools
+
+Running `supyagent init` installs these default tools:
+
+### Shell (`shell.py`)
+- `run_command` - Execute shell commands
+- `run_script` - Run multi-line bash scripts
+- `which` - Find executable paths
+- `get_env` - Get environment variables
+
+### Files (`files.py`)
+- `read_file` / `write_file` - File I/O
+- `list_directory` - List files with glob patterns
+- `copy_file` / `move_file` / `delete_file` - File operations
+- `create_directory` - Create directories
+- `file_info` - Get file metadata
+
+You can add your own tools by creating Python files in `supypowers/`.
+
 ## Project Structure
 
 ```
@@ -215,8 +277,9 @@ your-project/
 │   ├── planner.yaml
 │   └── researcher.yaml
 ├── supypowers/          # Tool definitions (Python)
-│   ├── hello.py
-│   └── web_search.py
+│   ├── shell.py         # Shell commands (bundled)
+│   ├── files.py         # File operations (bundled)
+│   └── my_tools.py      # Your custom tools
 └── .supyagent/          # Runtime data (gitignore this)
     ├── sessions/        # Conversation history
     ├── credentials/     # Encrypted secrets

{supyagent-0.1.0 → supyagent-0.2.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "supyagent"
-version = "0.1.0"
+version = "0.2.1"
 description = "LLM agents powered by supypowers - build AI agents with tool use, multi-agent orchestration, and secure credential management"
 readme = "README.md"
 requires-python = ">=3.11"

supyagent-0.2.1/scripts/release.sh

@@ -0,0 +1,151 @@
+#!/bin/bash
+#
+# Release script for supyagent
+# Usage: ./scripts/release.sh [version]
+#
+# Examples:
+#   ./scripts/release.sh 0.2.0    # Release version 0.2.0
+#   ./scripts/release.sh patch    # Bump patch version (0.1.0 -> 0.1.1)
+#   ./scripts/release.sh minor    # Bump minor version (0.1.0 -> 0.2.0)
+#   ./scripts/release.sh major    # Bump major version (0.1.0 -> 1.0.0)
+#
+
+set -e  # Exit on error
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Change to project root
+cd "$(dirname "$0")/.."
+PROJECT_ROOT=$(pwd)
+
+echo -e "${BLUE}📦 Supyagent Release Script${NC}"
+echo "================================"
+echo ""
+
+# Get current version from pyproject.toml
+CURRENT_VERSION=$(grep '^version = ' pyproject.toml | sed 's/version = "\(.*\)"/\1/')
+echo -e "Current version: ${YELLOW}${CURRENT_VERSION}${NC}"
+
+# Determine new version
+if [ -z "$1" ]; then
+    echo -e "${RED}Error: Version argument required${NC}"
+    echo ""
+    echo "Usage: $0 [version|patch|minor|major]"
+    echo ""
+    echo "Examples:"
+    echo "  $0 0.2.0   # Set specific version"
+    echo "  $0 patch   # Bump patch (0.1.0 -> 0.1.1)"
+    echo "  $0 minor   # Bump minor (0.1.0 -> 0.2.0)"
+    echo "  $0 major   # Bump major (0.1.0 -> 1.0.0)"
+    exit 1
+fi
+
+# Parse version
+IFS='.' read -r MAJOR MINOR PATCH <<< "$CURRENT_VERSION"
+
+case "$1" in
+    patch)
+        NEW_VERSION="$MAJOR.$MINOR.$((PATCH + 1))"
+        ;;
+    minor)
+        NEW_VERSION="$MAJOR.$((MINOR + 1)).0"
+        ;;
+    major)
+        NEW_VERSION="$((MAJOR + 1)).0.0"
+        ;;
+    *)
+        NEW_VERSION="$1"
+        ;;
+esac
+
+echo -e "New version: ${GREEN}${NEW_VERSION}${NC}"
+echo ""
+
+# Confirm
+read -p "Proceed with release? [y/N] " -n 1 -r
+echo ""
+if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+    echo "Cancelled."
+    exit 0
+fi
+
+echo ""
+echo -e "${BLUE}Step 1: Update version in pyproject.toml${NC}"
+sed -i.bak "s/^version = \".*\"/version = \"${NEW_VERSION}\"/" pyproject.toml
+rm -f pyproject.toml.bak
+
+# Also update version in CLI if it's hardcoded there
+if grep -q "version=\"${CURRENT_VERSION}\"" supyagent/cli/main.py 2>/dev/null; then
+    sed -i.bak "s/version=\"${CURRENT_VERSION}\"/version=\"${NEW_VERSION}\"/" supyagent/cli/main.py
+    rm -f supyagent/cli/main.py.bak
+fi
+
+echo -e "${GREEN}✓${NC} Version updated to ${NEW_VERSION}"
+
+echo ""
+echo -e "${BLUE}Step 2: Run tests${NC}"
+source .venv/bin/activate 2>/dev/null || true
+python -m pytest tests/ -q
+echo -e "${GREEN}✓${NC} All tests passed"
+
+echo ""
+echo -e "${BLUE}Step 3: Clean old builds${NC}"
+rm -rf dist/ build/ *.egg-info
+echo -e "${GREEN}✓${NC} Cleaned build directories"
+
+echo ""
+echo -e "${BLUE}Step 4: Build package${NC}"
+python -m build
+echo -e "${GREEN}✓${NC} Built successfully"
+
+echo ""
+echo -e "${BLUE}Step 5: Verify package${NC}"
+twine check dist/*
+echo -e "${GREEN}✓${NC} Package verified"
+
+echo ""
+echo -e "${BLUE}Step 6: Upload to PyPI${NC}"
+# Load credentials from .env if present
+if [ -f .env ]; then
+    export $(cat .env | grep -v '^#' | xargs)
+fi
+twine upload dist/*
+echo -e "${GREEN}✓${NC} Uploaded to PyPI"
+
+echo ""
+echo -e "${BLUE}Step 7: Clear local caches${NC}"
+
+# Clear pip cache
+echo "  Clearing pip cache..."
+pip cache purge 2>/dev/null || true
+
+# Clear uv cache for supyagent
+echo "  Clearing uv cache..."
+uv cache clean supyagent 2>/dev/null || true
+
+# Remove any local installs
+echo "  Removing local editable install..."
+pip uninstall -y supyagent 2>/dev/null || true
+uv pip uninstall supyagent 2>/dev/null || true
+
+echo -e "${GREEN}✓${NC} Caches cleared"
+
+echo ""
+echo -e "${GREEN}========================================${NC}"
+echo -e "${GREEN}🎉 Released supyagent ${NEW_VERSION}${NC}"
+echo -e "${GREEN}========================================${NC}"
+echo ""
+echo "View on PyPI: https://pypi.org/project/supyagent/${NEW_VERSION}/"
+echo ""
+echo "To install the new version:"
+echo "  pip install supyagent==${NEW_VERSION}"
+echo "  # or"
+echo "  uv pip install supyagent==${NEW_VERSION}"
+echo ""
+echo "To reinstall locally for development:"
+echo "  uv pip install -e ."