Documentation Index
Fetch the complete documentation index at: https://docs.primeintellect.ai/llms.txt
Use this file to discover all available pages before exploring further.
What are Prime Images?
Prime Images lets you push custom Docker images to Prime’s registry and use them in sandboxes. Builds happen in the cloud, so you don’t need Docker running locally.
Push an Image
# Basic push (uses ./Dockerfile in current directory)
prime images push myapp:v1.0.0
# Make the image public when the build completes
prime images push myapp:v1.0.0 --public
# Specify a different Dockerfile
prime images push myapp:v1.0.0 --dockerfile custom.Dockerfile
# Use a different build context
prime images push myapp:v1.0.0 --context ./app
The CLI packages your build context, uploads it, and kicks off a remote build. You’ll get a build ID to track progress.
Check Build Status
# See all your images and their build status
prime images list
Status meanings:
- Ready – Build succeeded, image is usable
- Building – Build in progress
- Pending – Queued for build
- Failed – Build failed (check your Dockerfile)
Use Your Image
Once the status shows Ready, create a sandbox with it:
prime sandbox create <user_id>/myapp:v1.0.0 --cpu-cores 2 --memory-gb 4
Publish or Unpublish an Image
Images are private by default. Publishing an image lets other authenticated Prime users use it in sandboxes with your user/team ID, image name, and tag.
prime images publish myapp:v1.0.0
prime images unpublish myapp:v1.0.0
Delete an Image
prime images delete myapp:v1.0.0
# Skip confirmation
prime images delete myapp:v1.0.0 --yes