Skip to main content
Agno Workspaces are standardized codebases for running Agentic Systems locally using Docker and in production on AWS. They help us manage our Agentic System as code. workspace

​
Create a new workspace

Run ag ws create to create a new workspace, the command will ask your for a starter template and workspace name. 
ag ws create

​
Start workspace resources

Run ag ws up to start i.e. create workspace resources 
ag ws up

​
Stop workspace resources

Run ag ws down to stop i.e. delete workspace resources 
ag ws down

​
Patch workspace resources

Run ag ws patch to patch i.e. update workspace resources 
ag ws patch

The patch command in under development for some resources. Use restart if needed

​
Restart workspace

Run ag ws restart to stop resources and start them again 
ag ws restart

​
Setup existing workspace

If you clone the codebase directly (eg: if your coworker created it) - run ag ws setup to set it up locally 
ag ws setup

​
Command Options

Run ag ws up --help to view all options

​
Environment (--env)

Use the --env or -e flag to filter the environment (dev/prd) 
ag ws up --env dev

​
Infra (--infra)

Use the --infra or -i flag to filter the infra (docker/aws/k8s) 
ag ws up --infra docker

​
Group (--group)

Use the --group or -g flag to filter by resource group. 
ag ws up --group app

​
Name (--name)

Use the --name or -n flag to filter by resource name 
ag ws up --name app

​
Type (--type)

Use the --type or -t flag to filter by resource type. 
ag ws up --type container

​
Dry Run (--dry-run)

The --dry-run or -dr flag can be used to dry-run the command. ag ws up -dr will only print resources, not create them. 
ag ws up --dry-run

​
Show Debug logs (--debug)

Use the --debug or -d flag to show debug logs. 
ag ws up -d

​
Force recreate images & containers (-f)

Use the --force or -f flag to force recreate images & containers 
ag ws up -f