semvec/pypi-packages huggingface dataset:
moss-agent-cli 0.2.2
CLI tool for deploying Moss voice agents
License: MIT
Requires Python: >=3.10

# Moss Agent CLI

Command-line tool for deploying voice agents to the Moss platform.

## Installation

```bash
pip install moss-agent-cli
```

Or install from source:

```bash
cd moss-agent-cli
pip install -e .
```

## Usage

### Deploy Command

Deploy your agent to the Moss platform:

```bash
moss-agent deploy
```

### Required Environment Variables

Set these environment variables or pass as CLI options:

```bash
export MOSS_PROJECT_ID="your-project-id"
export MOSS_PROJECT_KEY="your-project-key"
export MOSS_VOICE_AGENT_ID="your-voice-agent-id"
```

Or pass as options:

```bash
moss-agent deploy \
  --project-id "your-project-id" \
  --project-key "your-project-key" \
  --voice-agent-id "your-voice-agent-id"
```

### Agent Structure

Your agent directory must contain an entry point file that imports from `moss_voice_agent_manager`:

**Simple structure:**
```
my-agent/
├── agent.py              # Entry point (uses MossAgentSession)
├── requirements.txt      # Optional: Additional dependencies
└── tools/               # Optional: Custom tools
    └── my_tools.py
```

**Or with main.py:**
```
my-agent/
├── main.py              # Entry point
├── requirements.txt
└── ...
```

**Or with src structure:**
```
my-agent/
├── src/
│   └── my_agent/
│       └── main.py      # Entry point
├── requirements.txt
└── ...
```

#### Example agent.py

```python
from moss_voice_agent_manager import MossAgentSession

def get_weather(city: str) -> str:
    """Get weather for a city."""
    return f"Weather in {city} is sunny"

session = MossAgentSession(
    function_tools=[get_weather],
    max_tool_steps=10,
)

if __name__ == "__main__":
    session.run()
```

## CLI Options

```
moss-agent deploy [OPTIONS] [DIRECTORY]

Arguments:
  DIRECTORY                Agent directory to deploy (defaults to current directory)

Options:
  --project-id, -p TEXT    Moss project ID (or set MOSS_PROJECT_ID env var)
  --project-key, -k TEXT   Moss project key (or set MOSS_PROJECT_KEY env var)
  --voice-agent-id, -v TEXT Voice agent ID (or set MOSS_VOICE_AGENT_ID env var)
  --api-url TEXT          Moss platform API URL (defaults to production)
  --help                  Show this message and exit
```

## What Gets Deployed

When you run `moss-agent deploy`, the CLI:

1. **Validates** your agent structure
2. **Packages** your agent directory (excluding .env, __pycache__, .git, etc.)
3. **Uploads** the package to Moss platform
4. **Deploys** to LiveKit Cloud

Your agent code is deployed as-is - no modification or generation.

## Excluded Files

The following files/directories are automatically excluded from deployment:

- `.env` - Environment variables (secrets)
- `__pycache__/` - Python cache
- `.git/` - Git repository
- `*.pyc` - Compiled Python files
- `.venv/`, `venv/` - Virtual environments
- `.DS_Store` - macOS metadata

## Development

Install in development mode:

```bash
cd moss-agent-cli
pip install -e .
```

Run the CLI:

```bash
moss-agent deploy
```

## License

MIT