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.

​
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