Command Line Tools
Introduction to Our Command Line Tools
Our suite of command line tools are designed to provide an accessible, step-by-step introduction to our codebase for users of all backgrounds, including those with limited programming experience. We believe that command line tools offer an ideal starting point for interacting with complex systems, allowing users to gain hands-on experience with core functionalities without diving into the source code.
Our current toolset includes the Timeline Editor (uc-timelineeditor) for managing conversational histories and interacting with language models, the LLM Configuration Manager (uc-llm) for viewing and modifying configurations of various Language Learning Models, the Tracing Configuration Manager (uc-tracing) for managing tracing settings and a small tool for Poking (uc-poke) the models.
Each tool is designed to introduce key concepts of our system in a practical, interactive manner. By using these tools, you'll not only learn about our project's capabilities but also build valuable skills in configuration management, automation, and system interaction. We encourage you to start with the basics of each tool and progressively explore their more advanced features, remembering that these tools are not just utilities, but gateways to understanding our project.
Timeline Editor (uc-timelineeditor)
The currently most powerfull command line tool is the Timeline Editor. It can be called with uc-timelineeditor see the Timeline Editor pages for more details.
The LLM configuration Manager (uc-llm)
The LLM Configuration Manager is a command-line tool for managing configurations of various Language Learning Models (LLMs). It allows users to view, update, and remove configurations for different LLM providers.
Installation
Install the package using pip:
pip install underdogcowboyUsage
To start the LLM Configuration Manager, run the following command in your terminal:
uc-llmThis will launch the interactive command-line interface.
Command Flow
The typical flow for configuring an LLM is as follows:
List available models
Select a model
View the current configuration
Update properties as needed
1. List Available Models
To see all available LLM models:
(llm_config) list_modelsThis will display a numbered list of all available models.
2. Select a Model
To select a model, you can either:
Type the number of the model
Use the
select_modelcommand followed by the number or name
For example:
(llm_config) 1or
(llm_config) select_model 1or
(llm_config) select_model google-vertex3. View Current Configuration
Once a model is selected, you can view its current configuration:
(llm_config:model_name) show_configThis will display all the properties and their current values for the selected model.
4. Update Properties
To update a property:
(llm_config:model_name) update_propertyFollow the prompts to select the property you want to update and enter the new value.
Additional Commands
show_general_config: Display general configuration settings.update_general_config: Update general configuration settings.help: Display a list of all available commands.exit: Exit the LLM Configuration Manager.
Notes
Different models may have different properties. The
show_configcommand will display all available properties for the selected model.When updating properties, ensure you provide valid values as required by the specific LLM provider.
Always use the
show_configcommand after updates to verify that changes have been applied correctly.If you encounter any errors or unexpected behavior, please check the error message and ensure you're using valid inputs.
Example Workflow
Start the tool:
uc-llmList models:
list_modelsSelect a model:
2(assuming 2 is Google Vertex AI)View configuration:
show_configUpdate a property:
update_propertyFollow prompts to select and update a specific property
View updated configuration:
show_configExit the tool:
exit
Remember, you can always use the help command to see a list of available commands and their descriptions.
Managing Tracing Configuration with uc-tracing
The uc-tracing command provides a command-line interface to view and modify tracing configuration settings for underdogcowboy.
Starting the Configuration Manager
After installing underdogcowboy, run the following command in your terminal:
uc-tracingThis will start the interactive Tracing Configuration Manager.
Available Commands
The following commands are available within the manager:
show: Displays the current tracing configuration.
update: Guides you through updating various tracing configuration settings.
toggle_langsmith: Enables or disables LangSmith tracing.
help: Lists available commands and their descriptions.
exit: Exits the Tracing Configuration Manager.
Example Usage
View the current tracing configuration:
(tracing_config) showEnable LangSmith tracing:
(tracing_config) toggle_langsmithUpdate tracing configuration settings:
(tracing_config) updateNote:
The update command will prompt you to enter values for specific configuration settings.
LLM poke (uc-poke)
LLM Poke Tool (uc--poke)
The LLM Poke Tool is a command-line utility designed to test and interact with various Language Learning Models (LLMs). It allows users to send simple test messages to selected models or all available models, providing a quick way to verify connectivity and basic functionality.
Install the package using pip:
pip install underdogcowboyUsage To start the LLM Poke Tool, run the following command in your terminal:
uc-pokeThis will launch the interactive command-line interface.
Command Flow The typical flow for using the LLM Poke Tool is as follows:
List available models
Select a model
Poke the selected model or all models
List Available Models To see all available LLM models:
(uc_poke) list_modelsThis will display a numbered list of all available models.
Select a Model To select a model, you can either:
Type the number of the model
Use the select_model command followed by the number or name
For example:
(uc_poke) 1or
(uc_poke) select_model 1or
(uc_poke) select_model model_namePoke a Model To send a test message to the selected model:
(uc_poke:model_name) pokeThis will send a static prompt to the selected model and display the response.
Poke All Models To send a test message to all available models:
(uc_poke) poke_allThis will send a static prompt to all available models and display their responses.
Additional Commands
help: List all available commands with their descriptions.
exit: Exit the LLM Poke Tool.
The LLM Poke Tool provides a simple and efficient way to test the responsiveness of various LLM models, allowing users to quickly verify connectivity and basic functionality across multiple models. This tool is particularly useful for troubleshooting and ensuring that your LLM configurations are working correctly.
Last updated