samai-zagent 0.28.37

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

ZAgent

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

Installation

pip install zagent

Quick Start

# 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