Metadata-Version: 2.4
Name: samai-zagent
Version: 0.28.37
Summary: ZAgent - Lightweight cross-platform AI agent for AICQ, with streaming chat, tool use, workflow automation, and stealth browser capabilities
Project-URL: Homepage, https://zagent.samai.cc
Project-URL: Documentation, https://zagent.samai.cc/install.html
Project-URL: Repository, https://github.com/samaidev/zagent_r
Author-email: SamAI <admin@samai.cc>
License-Expression: MIT
Keywords: agent,ai,aicq,assistant,automation,chatbot,llm
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Communications :: Chat
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.7
Description-Content-Type: text/markdown

# ZAgent

ZAgent is a lightweight cross-platform AI agent for AICQ, with streaming chat, tool use, workflow automation, and stealth browser capabilities.

## Installation

```bash
pip install zagent
```

## Quick Start

```bash
# Start ZAgent (will prompt for AICQ room code or run in online-only mode)
zagent

# Join a specific AICQ room
zagent -code <room_code>

# Run in headless mode (no web UI, for server deployment)
zagent -nowebui -name "My Agent" -server https://aicq.me

# Show help
zagent -h
```

## Features

- **Streaming Chat**: Real-time streaming responses with reasoning panel
- **Tool Use**: 30+ built-in tools (file ops, command execution, code execution, web search, browser automation)
- **Workflow Automation**: Create and run multi-step workflows
- **Stealth Browser**: Anti-detection browser automation with Chrome
- **Memory**: SQLite-backed persistent memory with keyword search
- **Multi-Platform**: Linux, macOS, Windows (amd64 + arm64), Android
- **AICQ Integration**: Full AICQ messaging protocol support (PM, groups, streaming)

## How It Works

The `pip install zagent` command installs a Python wrapper package. On first run, it automatically downloads the native binary for your platform from https://zagent.samai.cc/downloads/ (with GitHub Releases fallback). The native binary is cached in the package directory for subsequent runs.

## Manual Installation

If you prefer not to use pip, you can download the native binary directly:
- https://zagent.samai.cc/install.html

## Documentation

- Website: https://zagent.samai.cc
- Installation: https://zagent.samai.cc/install.html
- GitHub: https://github.com/samaidev/zagent_r

## License

MIT
