Metadata-Version: 2.4
Name: vystak-cli
Version: 0.1.0
Summary: Vystak CLI — declarative AI agent orchestration from the terminal
Project-URL: Homepage, https://vystak.dev
Project-URL: Documentation, https://vystak.dev/docs
Project-URL: Repository, https://github.com/vystak/vystak
Project-URL: Issues, https://github.com/vystak/vystak/issues
Author-email: Anatoliy Kolodkin <11351966+akolodkin@users.noreply.github.com>
License-Expression: Apache-2.0
Keywords: agent,ai,cli,deployment,orchestration,vystak
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software 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 :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Systems Administration
Requires-Python: >=3.11
Requires-Dist: click>=8.0
Requires-Dist: vystak-adapter-langchain>=0.1.0
Requires-Dist: vystak-provider-docker>=0.1.0
Requires-Dist: vystak>=0.1.0
Description-Content-Type: text/markdown

# vystak-cli

The `vystak` command — manage and deploy AI agents from the terminal.

## Install

```bash
pip install vystak-cli
```

This pulls in `vystak`, `vystak-adapter-langchain`, and `vystak-provider-docker` automatically.

## Quick start

```bash
# Create a starter agent
vystak init

# Preview what would be deployed
vystak plan

# Deploy to Docker
export ANTHROPIC_API_KEY=your-key
vystak apply

# Tail logs
vystak logs

# Check status
vystak status

# Tear down
vystak destroy
```

## Commands

| Command | Description |
|---------|-------------|
| `vystak init` | Scaffold a starter `vystak.yaml` |
| `vystak plan` | Show what would change without applying |
| `vystak apply` | Deploy or update the agent |
| `vystak destroy` | Stop and remove the agent |
| `vystak status` | Show deployed agent status |
| `vystak logs` | Tail agent container logs |

## Agent definition

The CLI loads either a YAML or Python file:

```yaml
# vystak.yaml
name: support-bot
model:
  name: claude
  provider: { name: anthropic, type: anthropic }
  model_name: claude-sonnet-4-20250514
platform:
  name: docker
  type: docker
  provider: { name: docker, type: docker }
channels:
  - { name: api, type: api }
secrets:
  - { name: ANTHROPIC_API_KEY }
```

```python
# vystak.py
import vystak as ast

anthropic = ast.Provider(name="anthropic", type="anthropic")
docker = ast.Provider(name="docker", type="docker")
agent = ast.Agent(
    name="support-bot",
    model=ast.Model(name="claude", provider=anthropic, model_name="claude-sonnet-4-20250514"),
    platform=ast.Platform(name="docker", type="docker", provider=docker),
    channels=[ast.Channel(name="api", type=ast.ChannelType.API)],
)
```

See the [main repository](https://github.com/vystak/vystak) for full documentation and examples.

## License

Apache-2.0
