The project provides scripts for one-click install, configuration, startup, and management. Script-based deployment is recommended for quick setup. Supports Linux, macOS, and Windows. Requires Python 3.7-3.12 (3.9 recommended).Documentation Index
Fetch the complete documentation index at: https://docs.cowagent.ai/llms.txt
Use this file to discover all available pages before exploring further.
Install Command
- Linux / macOS
- Windows (PowerShell)
- Check Python environment (requires Python 3.7+)
- Install required tools (git, curl, etc.)
- Clone project to
~/CowAgent - Install Python dependencies and Cow CLI
- Guided configuration for AI model and channel
- Start service
http://localhost:9899 to begin chatting.
Deploying on a server? By default
web_host only listens on 127.0.0.1 (local access only). Set web_host to 0.0.0.0 in config.json to make the console reachable from outside, and set web_password to protect it. Don’t forget to open port 9899 in your firewall or security group — ideally restricted to specific IPs.Management Commands
After installation, use thecow command to manage the service:
| Command | Description |
|---|---|
cow start | Start service |
cow stop | Stop service |
cow restart | Restart service |
cow status | Check run status |
cow logs | View real-time logs |
cow update | Update code and restart |
cow install-browser | Install browser tool dependencies |
If the
cow command is not available, you can use ./run.sh <command> (Linux/macOS) or .\scripts\run.ps1 <command> (Windows) as a fallback. Both are functionally equivalent.