--wallets-path TEXT: Path to Bittensor wallets directory
--wallet TEXT: Name of the wallet to use
--hotkey TEXT: Hotkey to register with
Example:
chutes register --username myuser
chutes link
Link a validator or subnet owner hotkey to your account for free developer access.
chutes link [OPTIONS]
Building & Deployment
chutes build
Build a Docker image for your chute.
chutes build <chute_ref> [OPTIONS]
Arguments:
chute_ref: Chute reference in format module:chute_name
Options:
--config-path TEXT: Custom config path
--logo TEXT: Path to logo image
--local: Build locally instead of remotely
--debug: Enable debug logging
--include-cwd: Include entire current directory
--wait: Wait for build to complete
--public: Mark image as public
Examples:
# Build remotely and wait for completion
chutes build my_chute:chute --wait# Build locally for testing
chutes build my_chute:chute --local# Build with a logo
chutes build my_chute:chute --logo ./logo.png --public
chutes deploy
Deploy a chute to the platform.
chutes deploy <chute_ref> [OPTIONS]
Arguments:
chute_ref: Chute reference in format module:chute_name
Options:
--config-path TEXT: Custom config path
--logo TEXT: Path to logo image
--debug: Enable debug logging
--public: Mark chute as public
Examples:
# Basic deployment
chutes deploy my_chute:chute
# Deploy with logo
chutes deploy my_chute:chute --logo ./logo.png
# Deploy as public chute
chutes deploy my_chute:chute --public
chutes run
Run a chute locally for development and testing.
chutes run <chute_ref> [OPTIONS]
Arguments:
chute_ref: Chute reference in format module:chute_name
Options:
--host TEXT: Host to bind to (default: 0.0.0.0)
--port INTEGER: Port to listen on (default: 8000)
--debug: Enable debug logging
--dev: Enable development mode
Examples:
# Run on default port
chutes run my_chute:chute
# Run on custom port with debug
chutes run my_chute:chute --port 8080 --debug
# Development mode
chutes run my_chute:chute --dev
Resource Management
chutes chutes
Manage your deployed chutes.
chutes chutes list
List your chutes.
chutes chutes list [OPTIONS]
Options:
--name TEXT: Filter by name
--limit INTEGER: Number of items per page (default: 25)
# Build your image
chutes build my_app:chute --wait# Test locally
chutes run my_app:chute --dev
# Deploy to production
chutes deploy my_app:chute
3. Manage Resources
# List your chutes
chutes chutes list
# Get detailed info
chutes chutes get my-app
# Check logs via dashboard# (Visit https://chutes.ai)# Clean up old resources
chutes chutes delete old-chute
chutes images delete old-image
Troubleshooting
Common Issues
Command not found
# Check installation
pip show chutes
# Try with Python module
python -m chutes --help
Many commands support JSON output for programmatic use:
# Get chute info as JSON
chutes chutes get my-chute --format json
# List chutes with jq processing
chutes chutes list --format json | jq '.items[].name'