Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Start an HTTP server that wraps an agent at a given import path.
motus serve start <agent> [options]
module:variable format. For example, myapp:my_agent imports my_agent from myapp.py. The object must be importable from the working directory.| Flag | Default | Description |
|---|---|---|
--host | 0.0.0.0 | Network address to bind to |
--port | 8000 | Port to listen on |
--workers | CPU count | Maximum concurrent worker processes |
--ttl | 0 | Idle/error session expiry in seconds (0 disables expiry) |
--timeout | 0 | Maximum seconds per agent turn before the worker is killed (0 means no limit) |
--max-sessions | 0 | Maximum number of concurrent sessions (0 means unlimited) |
--shutdown-timeout | 0 | Seconds to wait for in-flight tasks on shutdown before cancelling (0 waits indefinitely) |
--allow-custom-ids | false | Enable PUT /sessions/{id} so clients can specify their own session IDs |
--log-level | info | Log verbosity: debug, info, warning, or error |
motus serve start myapp:my_agent --port 8080 --workers 8
motus serve start myapp:my_agent --allow-custom-ids --ttl 3600
motus serve start myapp:my_agent --max-sessions 50 --timeout 30
Was this page helpful?