Sharing
Share your eval results with others using the share
command.
Quick Start (Cloud)
Most users will share to promptfoo.app cloud:
# Login (one-time setup)
promptfoo auth login
# Run an eval and share it
promptfoo eval
promptfoo share
Cloud sharing creates private links only visible to you and your organization. If you don't have an account, visit https://promptfoo.app/welcome to create one.
Sharing Specific Evals
# List available evals
promptfoo list
# Share by ID
promptfoo share my-eval-id
Enterprise Sharing
If you have a Promptfoo Enterprise account:
# Login to your enterprise instance
promptfoo auth login --host https://your-company.promptfoo.app
# Share your eval
promptfoo share
Enterprise sharing includes additional features:
- Team-based access controls
- Custom sharing policies
- SSO integration
CI/CD Integration
Using API Tokens (Cloud/Enterprise)
# Authenticate with API token
export PROMPTFOO_API_KEY=your_api_token
# Run and share
promptfoo eval --share
Get your API token from the "CLI Login Information" section in your account settings.
Advanced: Self-Hosted Sharing
For users with self-hosted instances:
# Configure sharing to your server
export PROMPTFOO_REMOTE_API_BASE_URL=http://your-server:3000
export PROMPTFOO_REMOTE_APP_BASE_URL=http://your-server:3000
# Share your eval (no login required)
promptfoo share
You can also add these settings to your promptfooconfig.yaml
:
sharing:
apiBaseUrl: http://your-server:3000
appBaseUrl: http://your-server:3000
Self-hosted sharing doesn't require promptfoo auth login
when these environment variables or config settings are present.
Troubleshooting Upload Issues
Handling "413 Request Entity Too Large" Errors
When sharing large evaluation results, you may encounter "413 Request Entity Too Large" errors from NGINX or other proxies. This happens when the request payload exceeds the server's configured limit.
You can solve this in two ways:
-
Reduce chunk size (client-side):
# Reduce the number of results per upload chunk (default is calculated automatically)
# Start with a small value like 10-20 for very large evals
export PROMPTFOO_SHARE_CHUNK_SIZE=10 -
Increase NGINX max body size (server-side):
# In your nginx.conf or site config
client_max_body_size 20M; # Adjust as needed
For multi-tenant environments, reducing the chunk size on the client is usually safer than increasing server limits.
Disabling Sharing
To disable sharing completely:
sharing: false