The dspy-profiles CLI manages profiles and includes global verbosity
controls. Use -V/--verbose (once for INFO, twice for DEBUG), -q/--quiet
for ERROR, or --log-level to set an explicit level. Use which-config to
print the resolved profiles.toml path.
dspy-profiles¶
A CLI for managing DSPy profiles.
Usage¶
dspy-profiles [OPTIONS] COMMAND [ARGS]...
Arguments¶
No arguments available
Options¶
| Name | Description | Required | Default |
|---|---|---|---|
-v, --version |
Show the version and exit. | No | - |
-V, --verbose |
Increase verbosity (-V for INFO, -VV for DEBUG). [default: 0] | No | - |
-q, --quiet |
Decrease verbosity (once for ERROR). [default: 0] | No | - |
--log-level TEXT |
Explicit log level (DEBUG, INFO, WARNING, ERROR). Overrides -V/-q. | No | - |
--help |
Show this message and exit. | No | - |
Commands¶
| Name | Description |
|---|---|
list |
Lists all available profiles and their... |
show |
Shows the full configuration details of a... |
delete |
Deletes a specified profile. |
set |
Sets or updates a configuration value for... |
init |
Initializes a new profile interactively. |
import |
Imports a profile from a .env file. |
diff |
Compares two profiles and highlights their... |
validate |
Validates the structure and content of the... |
test |
Tests connectivity to the language model... |
run |
Executes a command with the specified... |
which-config |
Print the resolved profiles.toml path and... |
Sub Commands¶
dspy-profiles list¶
Lists all available profiles and their core details.
Usage¶
dspy-profiles list [OPTIONS]
Arguments¶
No arguments available
Options¶
| Name | Description | Required | Default |
|---|---|---|---|
--json |
Output the list of profiles in JSON format. | No | - |
--help |
Show this message and exit. | No | - |
dspy-profiles show¶
Shows the full configuration details of a specific profile.
Usage¶
dspy-profiles show [OPTIONS] PROFILE_NAME
Arguments¶
| Name | Description | Required |
|---|---|---|
PROFILE_NAME |
The name of the profile to display. | Yes |
Options¶
| Name | Description | Required | Default |
|---|---|---|---|
--json |
Output the profile in JSON format. | No | - |
--help |
Show this message and exit. | No | - |
dspy-profiles delete¶
Deletes a specified profile.
Usage¶
dspy-profiles delete [OPTIONS] PROFILE_NAME
Arguments¶
| Name | Description | Required |
|---|---|---|
PROFILE_NAME |
The name of the profile to delete. | Yes |
Options¶
| Name | Description | Required | Default |
|---|---|---|---|
-f, --force |
Delete the profile without prompting for confirmation. | No | - |
--help |
Show this message and exit. | No | - |
dspy-profiles set¶
Sets or updates a configuration value for a given profile.
Usage¶
dspy-profiles set [OPTIONS] PROFILE_NAME KEY VALUE
Arguments¶
| Name | Description | Required |
|---|---|---|
PROFILE_NAME |
The name of the profile to modify. | Yes |
KEY |
The configuration key to set (e.g., 'lm.model'). | Yes |
VALUE |
The value to set for the key. | Yes |
Options¶
| Name | Description | Required | Default |
|---|---|---|---|
--help |
Show this message and exit. | No | - |
dspy-profiles init¶
Initializes a new profile interactively.
Usage¶
dspy-profiles init [OPTIONS]
Arguments¶
No arguments available
Options¶
| Name | Description | Required | Default |
|---|---|---|---|
-p, --profile TEXT |
The name for the new profile. [default: (default)] | No | - |
-f, --force |
Overwrite the profile if it already exists. | No | - |
--help |
Show this message and exit. | No | - |
dspy-profiles import¶
Imports a profile from a .env file.
Usage¶
dspy-profiles import [OPTIONS]
Arguments¶
No arguments available
Options¶
| Name | Description | Required | Default |
|---|---|---|---|
-p, --profile TEXT |
The name for the new profile. | Yes | - |
--from FILE |
The path to the .env file to import from. [default: .env] | No | - |
--help |
Show this message and exit. | No | - |
dspy-profiles diff¶
Compares two profiles and highlights their differences.
Usage¶
dspy-profiles diff [OPTIONS] PROFILE_A_NAME PROFILE_B_NAME
Arguments¶
| Name | Description | Required |
|---|---|---|
PROFILE_A_NAME |
The first profile to compare. | Yes |
PROFILE_B_NAME |
The second profile to compare. | Yes |
Options¶
| Name | Description | Required | Default |
|---|---|---|---|
--help |
Show this message and exit. | No | - |
dspy-profiles validate¶
Validates the structure and content of the profiles.toml file.
Usage¶
dspy-profiles validate [OPTIONS]
Arguments¶
No arguments available
Options¶
| Name | Description | Required | Default |
|---|---|---|---|
-c, --config FILE |
Path to the profiles.toml file. [default: /home/runner/.dspy/profiles.toml] | No | - |
--help |
Show this message and exit. | No | - |
dspy-profiles test¶
Tests connectivity to the language model for a given profile.
Usage¶
dspy-profiles test [OPTIONS] PROFILE_NAME
Arguments¶
| Name | Description | Required |
|---|---|---|
PROFILE_NAME |
The name of the profile to test. | Yes |
Options¶
| Name | Description | Required | Default |
|---|---|---|---|
--help |
Show this message and exit. | No | - |
dspy-profiles run¶
Executes a command with the specified profile's environment variables.
Usage¶
dspy-profiles run [OPTIONS]
Arguments¶
No arguments available
Options¶
| Name | Description | Required | Default |
|---|---|---|---|
-p, --profile TEXT |
The profile to activate for the command. | Yes | - |
--help |
Show this message and exit. | No | - |
dspy-profiles which-config¶
Print the resolved profiles.toml path and whether it exists.
Usage¶
dspy-profiles which-config [OPTIONS]
Arguments¶
No arguments available
Options¶
| Name | Description | Required | Default |
|---|---|---|---|
--help |
Show this message and exit. | No | - |